Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Serviços de DevOps do Azure
O relatório de consumo de pool permite visualizar os trabalhos que estão a ser executados nos seus pools de agentes, apresentados com a simultaneidade de trabalhos dos pools 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 tiver muitos trabalhos enfileirados ou em execução no limite de simultaneidade ou agentes online, convém adquirir tarefas paralelas adicionais ou provisionar mais agentes auto-hospedados.
Pré-requisitos
Importante
Você deve ser membro do grupo Administradores de Coleção de Projetos para ver os relatórios de utilização dos pools de agentes em uma organização, incluindo os relatórios ao nível do projeto nessa organização.
Relatório de consumo da piscina
O relatório de consumo do pool faz parte da pasta Analytics para um pool de agentes e contém os seguintes gráficos, dependendo do tipo de pool de agentes.
| Tipo de gráfico | Descrição | Tipo de grupo de agentes |
|---|---|---|
| Simultaneidade pública hospedada | Para projetos públicos, exibe concorrência, tarefas enfileiradas e tarefas em execução. | Alojado pela Microsoft |
| Concorrência hospedada privada | Exibe concorrência, trabalhos em fila e trabalhos em execução para projetos privados | Alojado pela Microsoft |
| Uso do agente | Mostra agentes online, tarefas enfileiradas e tarefas em execução para agentes próprios | Agente de conjunto de escala e auto-hospedado |
| Concorrência privada auto-hospedada | Exibe concorrência, tarefas enfileiradas e tarefas em execução em 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.
- Tarefas em fila - O número de tarefas enfileiradas à espera de 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 do período de 10 minutos, a contagem de trabalhos em execução às vezes pode ser maior do que a concorrência ou os agentes online durante o mesmo período.
Âmbito do relatório
O relatório de consumo do pool pode ser exibido no âmbito da organização ou no âmbito do projeto. No nível da organização, o gráfico é elaborado usando dados de pipelines de qualquer projeto dentro da organização que tenha executado tarefas nesse pool. No nível do projeto, o gráfico é desenhado usando dados de pipelines nesse projeto específico que executaram tarefas 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 veja a guia Análise. O exemplo a seguir mostra o relatório de consumo de pool para um pool de agentes auto-geridos.
Este exemplo mostra os gráficos de uso do pool de agentes hospedado pela Microsoft para o Azure Pipelines.
Filtragem
Para ajustar a linha do tempo do gráfico, escolha Filtro
, selecione a lista suspensa de intervalo e escolha o intervalo desejado.
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.
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 TaskAgentRequestSnapshots ponto de 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 project_id do seu projeto navegando para o URL seguinte: 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 concorrência?
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 é elaborado usando dados de pipelines de qualquer projeto dentro da organização que tenha executado tarefas nesse pool. No nível do projeto, o gráfico é desenhado usando dados de pipelines nesse projeto específico que executaram tarefas nesse pool.