Install the Premium metrics app

The Power BI Premium Utilization and Metrics app is designed to provide monitoring capabilities for Power BI 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 Premium metrics app, review these requirements:

• You need to be a capacity admin

• The app only works with Premium capacities

• You need to have a Power BI Pro or Premium Per User License

Install the app

Follow the steps 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. You can also use these links to upgrade the app. When upgrading, you don't need to delete the old app.

• Microsoft 365 Government Community Cloud (GCC)

• Microsoft 365 Government Community Cloud High (GCC High)

• Microsoft 365 Department of Defense (DoD)

• Power BI for China cloud

First time installation

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:

   • Go to AppSource > Power BI Premium Capacity Utilization and Metrics and select Get it now.

   • In Power BI service:

     1. Select Apps.

     2. Select Get apps.

     3. Search for Power BI Premium.

     4. Select the Power BI Premium Capacity Utilization and Metrics app.

     5. Select Get it now.

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

   

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

   

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

Upgrade the app

To upgrade a previous installation of the Power BI Premium Capacity Utilization and Metrics app, follow these steps:

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

   • Go to AppSource > Power BI Premium Capacity Utilization and Metrics and select Get it now.

   • In Power BI service:

     1. Select Apps.

     2. Select Get apps.

     3. Search for Power BI Premium.

     4. Select the Power BI Premium Capacity Utilization and Metrics app.

     5. Select Get it now.

2. In the Update app window, select one of the following:

   • Update the workspace and the app - Updates your current app and the Power BI workspace it resides in. This is the default option for upgrading the app. It will remove the current version and its workspace and replace them with the new version of the app and a corresponding workspace.

   • Update only workspace content without updating the app - Updates the Power BI workspace but doesn't update the app. Select this option to update the app's workspace without upgrading the app.

   • Install another copy of the app into a new workspace - Creates a new Power BI workspace and installs the new version of the app in this workspace. Select this option if you want to keep the old version of the app with the new one. This option creates another workspace for the new app version and installs the app in the newly created workspace. If you select this option, you'll need to provide a name for the new workspace.

3. Select Install.

   

Run the app for the first time

To complete the installation, 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.

   

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

   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 Premium 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. After installation, 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, complete 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.

   

8. Select a capacity from the Capacity Name drop down.

   

9. After you configure the app, it can 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.

   

Next steps

Use the Premium metrics app