---
layout: Conceptual
monikers:
- azure-devops
defaultMoniker: azure-devops
versioningType: Ranged
title: Historical graph for agent pools - Azure Pipelines | Microsoft Learn
canonicalUrl: https://learn.microsoft.com/en-us/azure/devops/pipelines/agents/pool-consumption-report?view=azure-devops
config_moniker_range: azure-devops || >= azure-devops-2022 <= azure-devops-server
feedback_system: Standard
feedback_product_url: https://developercommunity.visualstudio.com/AzureDevOps
breadcrumb_path: /azure/devops/breadcrumb/toc.json
uhfHeaderId: MSDocsHeader-AzureDevOps
archive_url: https://docs.microsoft.com/en-us/previous-versions/azure/devops/all/
ms.topic: concept-article
ms.manager: rajr
ms.author: shubhamag
ms.date: 2023-01-25T00:00:00.0000000Z
ms.service: azure-devops-pipelines
ms.version: ALM
MSHAttr.msprod: ms.prod:ALM
ms.prodfamily: ALM
author: agarshubh
ms.subservice: azure-devops-pipelines-agents
description: View agent pool usage statistics
locale: en-us
document_id: d037236a-fd1a-9228-57bc-bb579f7fef5f
document_version_independent_id: ef176c0e-fa5c-9b3e-55ed-dd45507cb980
updated_at: 2025-10-27T22:02:00.0000000Z
original_content_git_url: https://github.com/MicrosoftDocs/azure-devops-docs-pr/blob/live/docs/pipelines/agents/pool-consumption-report.md
gitcommit: https://github.com/MicrosoftDocs/azure-devops-docs-pr/blob/f1954fda97d491b213bd64d7bb0854b4de2234cd/docs/pipelines/agents/pool-consumption-report.md
git_commit_id: f1954fda97d491b213bd64d7bb0854b4de2234cd
default_moniker: azure-devops
site_name: Docs
depot_name: MSDN.azure-devops-docs
page_type: conceptual
toc_rel: ../toc.json
pdf_url_template: https://learn.microsoft.com/pdfstore/en-us/MSDN.azure-devops-docs/{branchName}{pdfName}
feedback_help_link_type: ''
feedback_help_link_url: ''
word_count: 928
asset_id: pipelines/agents/pool-consumption-report
moniker_range_name: 348281b5e6207d94331bdbf3987314df
monikers:
- azure-devops
item_type: Content
source_path: docs/pipelines/agents/pool-consumption-report.md
cmProducts:
- https://authoring-docs-microsoft.poolparty.biz/devrel/64b65f6c-101f-411a-9b83-9f577fab52d0
spProducts:
- https://authoring-docs-microsoft.poolparty.biz/devrel/1a667fd1-8145-4b11-af0f-9f5de205a6e5
platformId: c08c30d3-833c-d62e-7cb0-5674dfa544d3
---

# Historical graph for agent pools - Azure Pipelines | Microsoft Learn

**Azure DevOps Services**

The pool consumption report enables you to view jobs running in your agent pools graphed with agent pool job concurrency over a span of up to 30 days. You can use this information to help decide whether your jobs aren't running because of concurrency limits. If you have many jobs queued or running jobs at the concurrency or online agents limit, you may wish to [purchase additional parallel jobs](../licensing/concurrent-jobs) or provision more self-hosted agents.

## Prerequisites

Important

You must be a member of the [Project Collection Administrators](../../organizations/security/permissions#collection-level-groups) group to view the pool consumption reports for agent pools in an organization, including project level reports in that organization.

## Pool consumption report

The pool consumption report is part of the **Analytics** tab for an agent pool and contains the following charts, depending on the agent pool type.

| Chart type | Description | Agent pool type |
| --- | --- | --- |
| Public hosted concurrency | Displays concurrency, queued jobs, and running jobs for public projects | Microsoft-hosted |
| Private hosted concurrency | Displays concurrency, queued jobs, and running jobs for private projects | Microsoft-hosted |
| Agent usage | Displays online agents, queued jobs, and running jobs for self-hosted agents | Scale set agent and self-hosted |
| Private self-hosted concurrency | Displays concurrency, queued jobs, and running jobs for private self-hosted projects | Scale set agent and self-hosted |

The charts in the pool consumption report graph the following data points:

- **Concurrency** - The number of parallel jobs in the organization that apply to the project type (public or private) and agent pool type (Microsoft-hosted or self-hosted). For more information, see [Configure and pay for parallel jobs](../licensing/concurrent-jobs).
- **Online agents** - The number of agents online in a [self-hosted agent pool](agents#install) or a [scale set agent pool](scale-set-agents).
- **Queued jobs** - The number of jobs queued and waiting for an agent.
- **Running jobs** - The number of running jobs.

Pool data is aggregated at a granularity of 10 minutes, and the number of running jobs is plotted based on the maximum number of running jobs for the specified interval of time. Because multiple short-running jobs may complete within the 10 minute timeline, the count of running jobs may sometimes be higher than the concurrency or online agents during that same period.

## Report scope

The pool consumption report can be displayed at organization scope, or project scope. At the organization level, the chart is plotted using data from pipelines across any project within the organization that have run jobs in that pool. At the project level, the chart is plotted using data from pipelines in that particular project that have run jobs in that pool.

- To view the pool consumption report at the organization level, choose **Organization settings**, **Pipelines**, **Agent pools**.
- To view the pool consumption report at the project level, navigate to the desired project and choose **Project settings**, **Pipelines**, **Agent pools**.

From the **Agent pools** view, choose the desired pool, and view the **Analytics** tab. The following example shows the pool consumption report for a self-hosted agent pool.

![Self-hosted agent pool historical graph](media/pool-consumption-report/historical-graph-self-hosted.png)

This example shows the usage graphs for the **Azure Pipelines** Microsoft-hosted agent pool.

![Microsoft-hosted agent pool historical graph](media/pool-consumption-report/historical-graph-azure-pipelines.png)

## Filtering

To adjust the timeline of the graph, choose **Filter**![](../../media/icons/filter-icon.png) , select the interval drop-down, and choose the desired interval.

![Graph duration.](media/pool-consumption-report/historical-graph-filter.png)

For the 1 day interval, you can view data per hour, and for the other intervals you can view it per day. Pool data is aggregated at a granularity of 10 minutes, and the number of running jobs is plotted based on the maximum number of running jobs for the specified interval of time. In this example there are two online agents, but in some areas there are four running jobs due to the way the pool data is aggregated.

![Self-hosted graph drill-down.](media/pool-consumption-report/self-hosted-drill-down.png)

## FAQ

### Where does the pool consumption report get the data it displays?

The pool consumption report uses the [Azure DevOps Analytics service](../../report/powerbi/what-is-analytics) and the `TaskAgentRequestSnapshots` endpoint. You can query this endpoint using the following URL prefix: `https://analytics.dev.azure.com/{organization}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots`.

You can retrieve the `project_id` for your project by navigating to the following URL: `https://dev.azure.com/{organization}/_apis/projects?api-version=5.0-preview.3`.

The following example shows a sample query and response.

```
{
"@odata.context": "https://analytics.dev.azure.com/{org}/{project_id}/_odata/v4.0-preview/$metadata#TaskAgentRequestSnapshots",
"vsts.warnings@odata.type": "#Collection(String)",
"@vsts.warnings": [
"VS403507: The specified query does not include a $select or $apply clause which is recommended for all queries. Details on recommended query patterns are available here: https://go.microsoft.com/fwlink/?linkid=861060."
],
"value": [
{
"SamplingDateSK": 20201117,
"SamplingHour": 13,
"SamplingTime": "2020-11-17T13:10:00-08:00",
"QueuedDate": "2020-11-17T13:07:26.22-08:00",
"QueuedDateSK": 20201117,
"StartedDate": "2020-11-17T15:02:23.7398429-08:00",
"StartedDateSK": 20201117,
"FinishedDate": "2020-11-17T15:13:49.89-08:00",
"FinishedDateSK": 20201117,
"QueueDurationSeconds": 6897.519,
"ProjectSK": "...",
"PipelineSK": 5141,
"RequestId": 6313,
"PoolId": 28,
"PipelineType": "Build",
"IsHosted": true,
"IsRunning": false,
"IsQueued": true
},
...
```

For more information on query options, see [Query guidelines for Analytics with OData](../../report/extend-analytics/odata-query-guidelines).

Note

The `TaskAgentRequestSnapshots` endpoint is in preview and not yet documented but you can view information about the data returned by navigating to the endpoint URL: `https://analytics.dev.azure.com/{org}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots`.

### Why are there more running jobs than there are agents or concurrency?

Pool data is aggregated at a granularity of 10 minutes, and the number of running jobs is plotted based on the maximum number of running jobs for the specified interval of time. Each running job is counted separately, and if multiple jobs complete during the 10 minute interval they contribute to the total count of running jobs for that interval.

### What is the difference between viewing the graphs in Project settings vs Organization settings?

The scope of the data in the graph is determined based on whether the chart is accessed through **Project settings** or **Organization settings**. At the organization level, the chart is plotted using data from pipelines across any project within the organization that have run jobs in that pool. At the project level, the chart is plotted using data from pipelines in that particular project that have run jobs in that pool.