Install the Gen2 metrics app

The Power BI Premium Utilization and Metrics app is designed to provide monitoring capabilities for Power BI Gen2 Premium capacities. Use this guide to install the app. Once the app is installed, you can learn how to use it.

Note

The app is updated regularly with new features and functionalities. If you see there's a pending update in the notifications center, we recommend that you update the app.

Prerequisites

Before you install the Gen2 metrics app, review these requirements:

  • You need to be a capacity admin

  • The app only works with Gen2 capacities

Install the app

Follow the steps below according to the type of installation you need.

Note

If you're installing the app in a government cloud environment, use one of the links below. You can also use these links to upgrade the app. When upgrading, you don't need to delete the old app.

To install the Power BI Premium Capacity Utilization and Metrics app for the first time, follow these steps:

  1. Select one of these options to get the app from AppSource:

  2. When prompted, sign in to AppSource using your Microsoft account and complete the registration screen. The app will take you to the Power BI service to complete the process. Select Install to continue.

    Screen capture of the one more thing window which includes fields to fill in with your Microsoft account details.

  3. In the Install this Power BI app window, select Install.

    Screen capture of the install this Power B I app, with the install button highlighted.

  4. Wait a few seconds for the app to install.

Run the app for the first time

To complete the installation, you need to configure the Power BI Premium utilization and metrics app by running it for the first time.

  1. In Power BI service, select Apps.

  2. Select the Premium Capacity Utilization And Metrics app.

  3. when you see the message You have to connect to your own data to view this report, select Connect.

    Screen capture of the power B I premium utilization and metrics app's setup screen, showing the connect button.

  4. In the Connect to Premium Capacity Utilization And Metrics first window, fill in the fields according to the table below:

    Field Required Value Notes
    CapacityID Yes An ID of a capacity you're an admin of You can find the capacity ID in the URL of the capacity management page. In the Power BI service, go to Settings > Admin portal > Capacity settings, then select a Gen2 capacity. The capacity ID is shown in the URL after /capacities/. For example, 9B77CC50-E537-40E4-99B9-2B356347E584 is the capacity ID in this URL: https://app.powerbi.com/admin-portal/capacities/9B77CC50-E537-40E4-99B9-2B356347E584.
    Once installed, the app will let you see all the capacities you can access.
    UTC_offset Yes Numerical values ranging from 14 to -12.
    To signify a Half hour timezone, use .5. For example, for Iran's standard time enter 3.5.
    Enter your organization's standard time in Coordinated Universal Time (UTC).
    Timepoint Automatically populated This field is automatically populated and is used for internal purposes. The value in this field will be overwritten when you use the app.
    Timepoint2 Automatically populated This field is automatically populated and is used for internal purposes. The value in this field will be overwritten when you use the app.
    Advanced Optional On or Off The app automatically refreshed your data at midnight. This option can be disabled by expanding the advanced option and selecting Off.
  5. Select Next.

  6. In the Connect to Premium Capacity Utilization And Metrics second window, fill in the following fields:

    • Authentication method - Select your authentication method. The default authentication method is OAuth2.

    • Privacy level setting for this data source - Select Organizational to enable app access to all the data sources in your organization.

    Note

    ExtensionDataSourceKind and ExtensionDataSourcePath are internal fields related to the app's connector. Do not change the values of these fields.

  7. Select Sign in and continue.

    Screen capture showing the second connect to premium capacity utilization and metrics window. The authentication method option is set to O Auth 2 and the privacy level setting for this data source option is set to organizational. The sign in and continue button is highlighted.

  8. Select a capacity from the capacity name dropdown.

    Screen capture showing the capacity name drop down box in the Power B I premium utilization and metrics app.

  9. After configuring the app, it may take a few minutes for the app to get your data. If you run the app and it's not displaying any data, refresh the app. This behavior happens only when you open the app for the first time.

    Screen capture of the Power B I premium utilization and metrics app displaying no data.

Next steps