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