Исторический граф для пулов агентов (предварительная версия)

Azure DevOps Services

Отчет о потреблении пула позволяет просматривать задания, выполняемые в пулах агентов с параллелизмом заданий пула агентов в течение 30 дней. Эти сведения помогут решить, не выполняются ли задания из-за ограничений параллелизма. Если у вас есть множество заданий, помещенных в очередь или выполняющихся с ограничением параллелизма или сетевых агентов, вы можете приобрести дополнительные параллельные задания или подготовить дополнительные локальные агенты.

Предварительные требования

Важно!

Чтобы просматривать отчеты о потреблении пулов для пулов агентов в организации, включая отчеты уровня проекта в этой организации, необходимо быть членом группы Администраторы коллекции проектов.

Отчет о потреблении ресурсов пула

Отчет о потреблении пула является частью вкладки Аналитика для пула агентов и содержит следующие диаграммы в зависимости от типа пула агентов.

Тип диаграммы	Описание	Тип пула агентов
Общедоступный размещенный параллелизм	Отображает параллелизм, задания в очереди и выполняемые задания для общедоступных проектов	Размещено в корпорации Майкрософт
Частный размещенный параллелизм	Отображение параллелизма, заданий в очереди и выполняемых заданий для частных проектов	Размещено в корпорации Майкрософт
Использование агента	Отображение сетевых агентов, заданий в очереди и выполняемых заданий для локальных агентов	Агент масштабируемого набора и локальный
Частный локальный параллелизм	Отображает параллелизм, задания в очереди и выполняемые задания для частных локальных проектов.	Агент масштабируемого набора и локальный

На диаграммах в отчете о потреблении пула отображаются следующие точки данных:

• Параллелизм — количество параллельных заданий в организации, которые применяются к типу проекта (общедоступный или частный) и типу пула агентов (размещенного майкрософт или локального размещения). Дополнительные сведения см. в статье Настройка и оплата параллельных заданий.
• Сетевые агенты — количество подключенных агентов в пуле локальных агентов или пуле агентов масштабируемого набора.
• Задания в очереди — количество заданий, поставленных в очередь и ожидающих агента.
• Выполняющихся заданий — количество выполняемых заданий.

Данные пула агрегируются с детализацией в 10 минут, а количество выполняемых заданий отображается на основе максимального числа выполняемых заданий за указанный интервал времени. Так как несколько коротких заданий могут завершиться в течение 10 минут временная шкала, количество выполняемых заданий иногда может быть выше, чем количество запущенных заданий или сетевых агентов в течение того же периода.

Область отчета

Отчет о потреблении пула можно отобразить в область организации или область проекта. На уровне организации диаграмма отображается с использованием данных из конвейеров в любом проекте в организации, в которых выполняются задания в этом пуле. На уровне проекта диаграмма отображается с использованием данных из конвейеров конкретного проекта, в которых выполняются задания в этом пуле.

• Чтобы просмотреть отчет о потреблении пула на уровне организации, выберите Параметры организации, Конвейеры, Пулы агентов.
• Чтобы просмотреть отчет о потреблении пула на уровне проекта, перейдите к нужному проекту и выберите Параметры проекта, Конвейеры, Пулы агентов.

В представлении Пулы агентов выберите нужный пул и откройте вкладку Аналитика . В следующем примере показан отчет о потреблении пула для пула локальных агентов.

В этом примере показаны графики использования для пула агентов Azure Pipelines , размещенного в Майкрософт.

Фильтрация

Чтобы настроить временная шкала графа, нажмите кнопку Фильтр , выберите раскрывающийся список интервала и выберите нужный интервал.

Для 1-дневного интервала можно просматривать данные в час, а для других — в день. Данные пула агрегируются с детализацией в 10 минут, а количество выполняемых заданий отображается на основе максимального числа выполняемых заданий за указанный интервал времени. В этом примере есть два сетевых агента, но в некоторых областях существует четыре выполняющихся задания из-за способа агрегирования данных пула.

Вопросы и ответы

Где отчет о потреблении пула получает отображаемые данные?

В отчете о потреблении пула используются служба Azure DevOps Analytics и конечная TaskAgentRequestSnapshots точка. Вы можете запросить эту конечную точку, используя следующий префикс URL-адреса: https://analytics.dev.azure.com/{organization}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots.

Вы можете получить project_id для проекта, перейдя по следующему URL-адресу: https://dev.azure.com/{organization}/_apis/projects?api-version=5.0-preview.3.

В следующем примере показан пример запроса и ответа.

{
"@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
},
...

Дополнительные сведения о параметрах запросов см. в статье Рекомендации по запросам для аналитики с помощью OData.

Примечание

Конечная TaskAgentRequestSnapshots точка находится в предварительной версии и еще не задокументирована, но вы можете просмотреть сведения о возвращаемых данных, перейдя по URL-адресу конечной точки: https://analytics.dev.azure.com/{org}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots.

Почему выполняемых заданий больше, чем агентов или параллелизма?

Данные пула агрегируются с детализацией в 10 минут, а количество выполняемых заданий отображается на основе максимального числа выполняемых заданий за указанный интервал времени. Каждое выполняющееся задание учитывается отдельно, и если несколько заданий завершены в течение 10-минутного интервала, они влияют на общее количество выполняемых заданий за этот интервал.

В чем разница между просмотром графиков в параметрах проекта и параметров организации?

Область данных на графе определяется в зависимости от того, осуществляется ли доступ к диаграмме с помощью параметров проекта или параметров организации. На уровне организации диаграмма отображается с использованием данных из конвейеров в любом проекте в организации, в которых выполняются задания в этом пуле. На уровне проекта диаграмма отображается с использованием данных из конвейеров конкретного проекта, в которых выполняются задания в этом пуле.