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.

To install the Microsoft Fabric Capacity Metrics app for the first time, follow these steps:

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

    • Go to AppSource > Microsoft Fabric Capacity Metrics and select Get it now.

    • In Power BI service:

      1. Select Apps.

      2. Select Get apps.

      3. Search for Microsoft Fabric.

      4. Select the Microsoft Fabric Capacity 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 Microsoft Fabric 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.

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, select Apps.

  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
    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 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, 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 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. 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.

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.

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.