Install the Microsoft Fabric capacity metrics app

The Microsoft Fabric Capacity Metrics app, also known as the metrics app, is designed to provide monitoring capabilities for Fabric and Power BI Premium capacities. Use this guide to install the app.

Prerequisites

To install the metrics app, you need to be a capacity admin.

Install the app

Follow the steps according to the type of installation you need. If you're installing the app in a government cloud environment, use the links in government clouds.

To avoid throttling due to capacity overutilization, install the app in a workspace with a Pro license.

Run the app for the first time

To complete the installation, configure the Microsoft Fabric Capacity Metrics app by running it for the first time.

1. In Microsoft Fabric, in the Power BI experience, select Apps. If you're running the app just after installing it, you'll be redirected to the Apps pane, and you can skip to step 2. Otherwise, to see the Apps pane, change the experience selector from the bottom left to Power BI instead of Fabric.

2. Select the Microsoft Fabric Capacity 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 Microsoft Fabric Capacity Metrics first window, fill in the fields according to the table:

   Field	Required	Value	Notes
   UTC_offset	Yes	Numerical values ranging from 14 to -12. To signify a Half hour timezone, use .5. For example, for India's standard time enter 5.5.	Enter your organization's standard time in Coordinated Universal Time (UTC).
   RegionName	Yes	Capacity Administrator: Set the region parameter as "Default". Tenant Administrator:   • If you're a tenant admin and have admin permissions on a capacity in the home region, or there are no capacities in home region for the whole tenant then set the parameter as "Default".   • Otherwise, set it as one of the regions where you have admin permission on a capacity (for example, "West Europe").	1. Both paused and trial capacities are also considered when determining your available regions. 2. After configuration, if you create or delete a capacity, it might affect the report, reevaluate the value of RegionName parameter. If the value needs to be different than currently configured value, update the value from semantic model settings and refresh the model. 3. You can find the RegionName of a capacity in capacity settings section from the admin portal. In Microsoft Fabric, go to Settings > Governance and insights > Admin portal > Capacity settings, then look for the region value displayed next to the capacity name.
   DefaultCapacityID	Applicable for version 1.9.2	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 Microsoft Fabric, go to Settings > Governance and insights > Admin portal > Capacity settings, then select a capacity. The capacity ID is shown in the URL after /capacities/. For example, 00001111-aaaa-2222-bbbb-3333cccc4444 is the capacity ID in this URL: https://app.powerbi.com/admin-portal/capacities/00001111-aaaa-2222-bbbb-3333cccc4444. After installation, the app lets you see all the capacities you can access.
   CapacityID	Applicable for version 1.8 and below	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 Microsoft Fabric, go to Settings > Governance and insights > Admin portal > Capacity settings, then select a capacity. The capacity ID is shown in the URL after /capacities/. For example, 00001111-aaaa-2222-bbbb-3333cccc4444 is the capacity ID in this URL: https://app.powerbi.com/admin-portal/capacities/00001111-aaaa-2222-bbbb-3333cccc4444. After installation, the app lets you see all the capacities you can access.
   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.

   Note

   The Fabric Capacity Metrics app uses several other parameters. These parameters aren't meant to be user-configurable and shouldn't be modified. Changing them can break the semantic model and/or the report.

5. Select Next.

6. In the Connect to Microsoft Fabric Capacity 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. Don't 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.

Government clouds

To install the app in a government cloud environment, use one of these 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

Considerations and limitations

OneLake isn't supported in Government Community Cloud (GCC).

Troubleshooting

After installing the app, if it's not showing data or can't refresh, follow these steps:

1. Delete the old app.
2. Reinstall the latest version of the app.
3. Update the semantic model credentials.

Related content

• Understand the metrics app compute page