Partilhar via


Gráfico histórico para pools de agentes (Visualização)

Serviços de DevOps do Azure

O relatório de consumo de pool permite que você visualize trabalhos em execução em seus pools de agentes grafados com simultaneidade de trabalhos do pool de agentes durante um período de até 30 dias. Você pode usar essas informações para ajudar a decidir se seus trabalhos não estão em execução devido aos limites de simultaneidade. Se você tiver muitos trabalhos enfileirados ou em execução no limite de simultaneidade ou agentes online, convém 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 da piscina

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

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

Os gráficos no relatório de consumo do pool apresentam 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, consulte Configurar e pagar por trabalhos paralelos.
  • Agentes online - O número de agentes online em um pool de agentes auto-hospedado ou em um pool de agentes de conjunto de escala.
  • Trabalhos em fila - O número de trabalhos enfileirados e aguardando por um agente.
  • Trabalhos em execução - O número de trabalhos em execução.

Os dados do pool são agregados em 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 curta duração 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 o mesmo período.

Âmbito 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 tenha executado trabalhos nesse pool. No nível do projeto, o gráfico é plotado usando dados de pipelines nesse projeto específico que executaram 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 de pool no nível do projeto, navegue até o projeto desejado e escolha Configurações do projeto, Pipelines, Pools de agentes.

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

Gráfico histórico do pool de agentes auto-hospedados

Este exemplo mostra os gráficos de uso do pool de agentes hospedados pela Microsoft do Azure Pipelines .

Gráfico histórico do pool de agentes hospedados pela Microsoft

Filtragem

Para ajustar a linha do tempo do gráfico, escolha Filtro , selecione a lista suspensa de intervalo e escolha o intervalo desejado.

Duração do gráfico.

Para o intervalo de 1 dia, você pode visualizar dados por hora, e para os outros intervalos você pode visualizá-los por dia. Os dados do pool são agregados em 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. Neste exemplo, há dois agentes online, mas em algumas áreas há quatro trabalhos em execução devido à forma como os dados do pool são agregados.

Detalhamento de gráficos auto-hospedados.

FAQ

Onde é que o relatório de consumo da piscina obtém os dados que apresenta?

O relatório de consumo do pool usa o serviço Azure DevOps Analytics e o ponto de TaskAgentRequestSnapshots extremidade. 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 para o project_id seu projeto navegando para o seguinte URL: https://dev.azure.com/{organization}/_apis/projects?api-version=5.0-preview.3.

O exemplo a seguir mostra um exemplo de consulta e 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, consulte Diretrizes de consulta para o Google Analytics com OData.

Nota

O TaskAgentRequestSnapshots ponto de extremidade está em visualização 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 em 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 contribuem para a contagem total de trabalhos em execução para esse intervalo.

Qual é a diferença entre visualizar os gráficos nas configurações do Project vs Configurações da organização?

O escopo dos dados no gráfico é determinado com base no fato de o gráfico ser acessado por meio das configurações do Projeto ou 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 tenha executado trabalhos nesse pool. No nível do projeto, o gráfico é plotado usando dados de pipelines nesse projeto específico que executaram trabalhos nesse pool.