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

Azure DevOps Services

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

Необходимые компоненты

Внимание

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

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

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

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

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

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

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

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

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

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

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

Журнал журнала пула агентов для локального размещения

В этом примере показаны графики использования пула агентов, размещенных в Microsoft 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 минут, они способствуют общему количеству выполняемых заданий для этого интервала.

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

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