Monitor Power BI Premium and Power BI Embedded capacities

This article provides an overview of monitoring the metrics for your Power BI Premium capacities. Monitoring capacity usage enables you to take an informed approach to managing your capacities.

You can monitor capacity with the Power BI Premium Capacity Metrics app or in the admin portal. We recommend the app, because it provides much more detail, but this article covers both options.

Install the Premium Capacity Metrics app

You can go straight to the Premium Capacity Metrics app or install it like you do other apps in Power BI.

  1. In Power BI, click Apps.

    Go to Apps

  2. On the right side, click Get apps.

  3. In the Apps category, search for Power BI Premium Capacity Metrics app.

  4. Subscribe to install the app.

Now that you've installed the app, you can see metrics about the capacities in your organization. Let's take a look at some of the key metrics that are available.

Use the metrics app

When you open the app, it first shows a dashboard with a summary of all the capacities for which you have admin rights.

Metrics app dashboard

The report has three tabs, which we describe in more detail in the following sections.

  • Filters applied to all pages: enables you to filter the other pages in the report to a specific capacity.
  • Datasets: provides detailed metrics on the health of the datasets within your capacities.
  • System: gives overall capacity metrics including memory and CPU high utilization.

Filters applied to all pages tab

The Filters applied to all pages tab enables you to select a capacity, a dataset, and a date range within the past seven days. Filters are then applied to all the relevant pages and tiles in the report. If no filters are selected, the report defaults to show the past week’s metrics on every capacity you own.

Filters tab

Datasets tab

The Datasets tab provides the bulk of the metrics in the app. Use the four buttons at the top of the tab to navigate to different areas: Summary, Refreshes, Queries, and Datasets.

Datasets tab

Summary area

Summary button

The Summary area shows a view of your capacities based on entities, system resources, and dataset workloads.

Metrics
Entities * The number of capacities you own
* The distinct number of datasets in your capacity
* The distinct number of workspaces in your capacity
System * The average memory usage in GB over the past seven days
* Highest memory consumption in GB in the past seven days and the local time it occurred
* The number of times CPU exceeded 80% of the thresholds in the past seven days, split into three minute buckets
* Most times the CPU exceeded 80% in the past seven days, split into one hour buckets, and the local time it occurred
* The number of times Direct query/Live connections exceeded 80% of the thresholds in the past seven days, split into three minute buckets
* Most times the Direct query/Live connections exceeded 80% in the past seven days, split into one hour buckets, and the local time it occurred
Dataset Workloads * Total number of refreshes in the past seven days
* Total number of successful refreshes in the past seven days
* Total number of failed refreshes in the past seven days
* Total number of failed refreshes due to out of memory
* Average refresh duration is measured in minutes, the time taken to complete the operation
* Average refresh wait-time is measured in minutes, the average lag between the scheduled time and start of the operation
* Total number of queries run in the past seven days
* Total number of successful queries in the past seven days
* Total number of failed queries in the past seven days
* Average query duration is measured in minutes, the time taken to complete the operation
* Total number of models evicted due to memory pressure

Refreshes area

Refreshes button

The Refreshes area lists out the complete refreshes, success measures, average/max refresh wait-time and average/max refresh duration sliced by datasets in the past seven days. The bottom two charts show the refreshes vs. memory consumption in GB and average wait-times split into one hour buckets, reported in local time. The top bar charts list the top five datasets by the average time it took to complete the dataset to refresh (refresh duration), and average refresh waits time. Multiple high refresh wait-time spikes are indicative of the capacity running hot.

Queries area

Queries button

The Queries area lists out the total number of queries run, total number of queries wait count for Live query/Direct query, average/max duration , average/max wait time reported in milliseconds sliced by datasets , workspace and hourly buckets in the past seven days. The bottom charts shows the query counts, average duration (in milliseconds) and average wait time(in milliseconds) vs. memory consumption in GB, split into one hour buckets reported in local time. The two top right charts list the top five datasets by the average query duration and wait time it took to complete the queries. Long query durations and long wait times are indicative of the capacity running hot. It may also mean that a single dataset is causing problems and further investigation is needed.

Datasets area

Datasets button

The Datasets area shows complete datasets evicted due to memory pressure by the hour.

System tab

The System tab shows times of high CPU utilization (number of times exceeded 80% utilization), high direct query/live connections utilization, and memory consumption.

Premium System report

Monitor Power BI Embedded capacity

You can also use the Power BI Premium Capacity Metrics app to monitor A SKU capacities in Power BI Embedded. Those capacities will show up in the report as long as you are an admin of the capacity. However, refresh of the report fails unless you grant certain permissions to Power BI on your A SKUs:

  1. Open your capacity in the Azure portal.

  2. Click Access control (IAM), and add the “Power BI Premium” app to the reader role. If you are unable to find the app by name, you can also add it by its client Id: cb4dc29f-0bf4-402a-8b30-7511498ed654.

    Permissions for Power BI Embedded

Note

You can monitor Power BI Embedded capacity usage in the app or the Azure portal, but not in the Power BI admin portal.

Basic monitoring in the admin portal

The Capacity settings area of the admin portal provides four gauges that indicate the loads placed and the resources utilized by your capacity for the past seven days. These four tiles work on an hourly time window that indicates how many hours in the past seven days the corresponding metric was above 80%. This metric indicates a potential degradation for the end-user experience.

Usage in 7 days

Metric Description
CPU Number of times CPU exceeded 80% utilization.
Memory Thrashing Represents the memory pressure on your backend cores. Specifically, this is a metric of how many times datasets are evicted from memory due to memory pressure from the usage of multiple datasets.
Memory Usage Average memory usage, represented in gigabytes (GB).
DQ/s Number of times Direct Query and Live Connections count exceeded 80% of the limit.
* We limit the total number of DirectQuery and live connection queries per second.* The limits are 30/s for P1, 60/s for P2 and 120/s for P3. * Direct Query and live connection queries count add to the above throttle. For example, if you have 15 DirectQueries and 15 live connections in a second, you hit your throttle
* This applies equally to on-premises and cloud connections.

Metrics reflect utilization over the past week. If you'd like to see a more detailed view of the metrics, you can do so by clicking any of the summary tiles. This will take you to detailed charts for each of the metrics for your premium capacity. The following chart shows details for the CPU metric.

Detailed usage chart CPU

These charts are summarized on an hourly basis for the past week, and can help isolate when you may have had specific performance-related events in your premium capacity.

You may also export the underlying data for any of the metrics to a csv file. This export will give you detailed information in three minute intervals for each day of the past week.

Next steps

Now that you understand how to monitor Power BI Premium capacities, learn more about optimizing capacities.