Representação gráfica histórica para pools de agentes (Pré-visualização)

Artigo
06/16/2023

Azure DevOps Services

O relatório de consumo do pool permite exibir trabalhos em execução em seus pools de agentes mostrados no gráfico com simultaneidade de trabalho do pool de agentes em um período de até 30 dias. Você pode usar essas informações para ajudar a decidir se os eus trabalhos não estão em execução devido aos limites de simultaneidade. Se você tiver muitos trabalhos enfileirados ou trabalhos em execução no limite de simultaneidade ou de agentes online, talvez queira comprar trabalhos paralelos adicionais ou provisionar mais agentes auto-hospedados.

Pré-requisitos

Importante

Você deve ser membro do grupo Administradores de Coleção de Projetos para exibir os relatórios de consumo de pool para pools de agentes em uma organização, incluindo relatórios de nível de projeto nessa organização.

Relatório de consumo de pool

O relatório de consumo do pool faz parte da guia Análise de um pool de agentes e contém os gráficos a seguir, dependendo do tipo de pool de agentes.

Tipo de gráfico	Descrição	Tipo de pool de agentes
Simultaneidade pública hospedada	Exibe simultaneidade, trabalhos enfileirados e trabalhos em execução para projetos públicos	Hospedado pela Microsoft
Simultaneidade privada hospedada	Exibe simultaneidade, trabalhos enfileirados e trabalhos em execução para projetos privados	Hospedado pela Microsoft
Uso do agente	Exibe agentes online, trabalhos enfileirados e trabalhos em execução para agentes auto-hospedados	Agente do conjunto de dimensionamento e auto-hospedado
Simultaneidade auto-hospedada privada	Exibe simultaneidade, trabalhos enfileirados e trabalhos em execução para projetos auto-hospedados privados	Agente do conjunto de dimensionamento e auto-hospedado

Os gráficos no relatório de consumo do pool grafam os seguintes pontos de dados:

Simultaneidade – o número de trabalhos paralelos na organização que se aplicam ao tipo de projeto (público ou privado) e ao tipo de pool de agentes (hospedado pela Microsoft ou auto-hospedado). Para obter mais informações, confira Configurar trabalhos paralelos e pagar por eles.
Agentes online – o número de agentes online em um pool de agentes auto-hospedados ou em um pool de agentes do conjunto de dimensionamento.
Trabalhos enfileirados – o número de trabalhos enfileirados e aguardando um agente.
Trabalhos em execução – o número de trabalhos em execução.

Os dados do pool são agregados a uma granularidade de 10 minutos e o número de trabalhos em execução é plotado com base no número máximo de trabalhos em execução para o intervalo de tempo especificado. Como vários trabalhos de execução curta podem ser concluídos dentro da linha do tempo de 10 minutos, a contagem de trabalhos em execução às vezes pode ser maior do que a simultaneidade ou os agentes online durante esse mesmo período.

Escopo do relatório

O relatório de consumo do pool pode ser exibido no escopo da organização ou no escopo do projeto. No nível da organização, o gráfico é plotado usando dados de pipelines em qualquer projeto dentro da organização que tenham executado trabalhos nesse pool. No nível do projeto, o gráfico é plotado usando dados de pipelines nesse projeto específico que tenham executado trabalhos nesse pool.

Para exibir o relatório de consumo do pool no nível da organização, escolha Configurações da organização, Pipelines, Pools de agentes.
Para exibir o relatório de consumo do pool no nível do projeto, navegue até o projeto desejado e escolha Configurações do projeto, Pipelines, Pools de agentes.

Na exibição Pools de agentes, escolha o pool desejado e exiba a guia Análise. O exemplo a seguir mostra o relatório de consumo do pool para um pool de agentes auto-hospedado.

Grafo histórico do pool de agentes auto-hospedados

Esse exemplo mostra os grafos de uso do pool de agentes hospedados pela Microsoft do Azure Pipelines.

Grafo histórico do pool de agentes hospedado pela Microsoft

Filtragem

Para ajustar a linha do tempo do gráfico, escolha Filter (Filtro ), selecione o menu suspenso de intervalo e escolha o intervalo desejado.

Duração do grafo.

Para o intervalo de 1 dia, você pode exibir dados por hora e, para os outros intervalos, pode exibi-los por dia. Os dados do pool são agregados a uma granularidade de 10 minutos e o número de trabalhos em execução é plotado com base no número máximo de trabalhos em execução para o intervalo de tempo especificado. Nesse exemplo, há dois agentes online, mas em algumas áreas há quatro trabalhos em execução devido à maneira como os dados do pool são agregados.

Detalhamento de grafo auto-hospedado.

Perguntas frequentes

De onde o relatório de consumo do pool obtém os dados exibidos?

O relatório de consumo do pool usa o serviço do Azure DevOps Analytics e o ponto de extremidade TaskAgentRequestSnapshots. Você pode consultar esse ponto de extremidade usando o seguinte prefixo de URL: https://analytics.dev.azure.com/{organization}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots.

Você pode recuperar o project_id para seu projeto navegando até a seguinte URL: https://dev.azure.com/{organization}/_apis/projects?api-version=5.0-preview.3.

O exemplo a seguir mostra uma consulta de exemplo e uma resposta.

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

Para obter mais informações sobre opções de consulta, confira Diretrizes de consulta para Análise com OData.

Observação

O ponto de extremidade TaskAgentRequestSnapshots está em versão prévia e ainda não está documentado, mas você pode exibir informações sobre os dados retornados navegando até a URL do ponto de extremidade: https://analytics.dev.azure.com/{org}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots.

Por que há mais trabalhos em execução do que agentes ou simultaneidade?

Os dados do pool são agregados a uma granularidade de 10 minutos e o número de trabalhos em execução é plotado com base no número máximo de trabalhos em execução para o intervalo de tempo especificado. Cada trabalho em execução é contado separadamente e, se vários trabalhos forem concluídos durante o intervalo de 10 minutos, eles contribuirão para a contagem total de trabalhos em execução para esse intervalo.

Qual é a diferença entre exibir os grafos em Configurações do projeto versus Configurações da organização?

O escopo dos dados no grafo é determinado com base em se o gráfico é acessado por meio de Configurações do projeto ou Configurações da organização. No nível da organização, o gráfico é plotado usando dados de pipelines em qualquer projeto dentro da organização que tenham executado trabalhos nesse pool. No nível do projeto, o gráfico é plotado usando dados de pipelines nesse projeto específico que tenham executado trabalhos nesse pool.

Compartilhar via