Gráfico histórico para conjuntos de agentes (Pré-visualização)

Azure DevOps Services

O relatório de consumo do conjunto permite-lhe ver tarefas em execução nos conjuntos de agentes com gráficos com simultaneidade de tarefas do conjunto de agentes durante um período de até 30 dias. Pode utilizar estas informações para ajudar a decidir se as suas tarefas não estão em execução devido aos limites de simultaneidade. Se tiver muitas tarefas em fila ou tarefas em execução no limite de simultaneidade ou agentes online, poderá querer comprar tarefas paralelas adicionais ou aprovisionar mais agentes autoalojados.

Pré-requisitos

Importante

Tem de ser membro do grupo Administradores da Coleção de Projetos para ver os relatórios de consumo de conjuntos de agentes numa organização, incluindo relatórios ao nível do projeto nessa organização.

Relatório de consumo de conjuntos

O relatório de consumo do conjunto faz parte do separador Análise de um conjunto de agentes e contém os seguintes gráficos, consoante o tipo de conjunto de agentes.

Tipo de gráfico	Description	Tipo de conjunto de agentes
Simultaneidade alojada pública	Apresenta simultaneidade, tarefas em fila e tarefas em execução para projetos públicos	Alojado na Microsoft
Simultaneidade alojada privada	Apresenta simultaneidade, tarefas em fila e tarefas em execução para projetos privados	Alojado na Microsoft
Utilização do agente	Apresenta agentes online, tarefas em fila e tarefas em execução para agentes autoalojados	Agente do conjunto de dimensionamento e autoalojado
Simultaneidade privada autoalojada	Apresenta simultaneidade, tarefas em fila e tarefas em execução para projetos privados autoalojados	Agente do conjunto de dimensionamento e autoalojado

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

• Simultaneidade – o número de tarefas paralelas na organização que se aplicam ao tipo de projeto (público ou privado) e ao tipo de conjunto de agentes (alojados ou autoalojados pela Microsoft). Para obter mais informações, veja Configurar e pagar tarefas paralelas.
• Agentes online – o número de agentes online num conjunto de agentes autoalojado ou num conjunto de agentes de conjuntos de dimensionamento.
• Tarefas em fila – o número de tarefas em fila e à espera de um agente.
• Tarefas em execução – o número de tarefas em execução.

Os dados do conjunto são agregados a uma granularidade de 10 minutos e o número de tarefas em execução é representado com base no número máximo de tarefas em execução para o intervalo de tempo especificado. Uma vez que várias tarefas de execução curta podem ser concluídas dentro da linha cronológica de 10 minutos, a contagem de tarefas em execução pode, por vezes, ser superior à simultaneidade ou aos agentes online durante esse mesmo período.

Âmbito do relatório

O relatório de consumo do conjunto pode ser apresentado no âmbito da organização ou no âmbito do projeto. Ao nível da organização, o gráfico é desenhado através de dados de pipelines em qualquer projeto dentro da organização que tenha executado tarefas nesse conjunto. Ao nível do projeto, o gráfico é desenhado com dados de pipelines nesse projeto específico que executaram tarefas nesse conjunto.

• Para ver o relatório de consumo do conjunto ao nível da organização, selecione Definições da organização, Pipelines, Conjuntos de agentes.
• Para ver o relatório de consumo do conjunto ao nível do projeto, navegue para o projeto pretendido e escolha Definições do projeto, Pipelines, Conjuntos de agentes.

Na vista Conjuntos de agentes , selecione o conjunto pretendido e veja o separador Análise . O exemplo seguinte mostra o relatório de consumo do conjunto para um conjunto de agentes autoalojado.

Este exemplo mostra os gráficos de utilização do conjunto de agentes alojados na Microsoft nos Pipelines do Azure .

Filtragem

Para ajustar a linha cronológica do gráfico, selecione Filtro , selecione o menu pendente de intervalo e escolha o intervalo pretendido.

Para o intervalo de 1 dia, pode ver os dados por hora e, para os outros intervalos, pode vê-lo por dia. Os dados do conjunto são agregados a uma granularidade de 10 minutos e o número de tarefas em execução é representado com base no número máximo de tarefas em execução para o intervalo de tempo especificado. Neste exemplo, existem dois agentes online, mas em algumas áreas existem quatro trabalhos em execução devido à forma como os dados do conjunto são agregados.

FAQ

Onde é que o relatório de consumo do conjunto obtém os dados apresentados?

O relatório de consumo do conjunto utiliza o serviço Azure DevOps Analytics e o TaskAgentRequestSnapshots ponto final. Pode consultar este ponto final com o seguinte prefixo de URL: https://analytics.dev.azure.com/{organization}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots.

Pode obter o para o project_id seu projeto ao navegar para o seguinte URL: https://dev.azure.com/{organization}/_apis/projects?api-version=5.0-preview.3.

O exemplo seguinte mostra uma consulta e uma resposta de exemplo.

{
"@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 as opções de consulta, veja Diretrizes de consulta para Análise com OData.

Nota

O TaskAgentRequestSnapshots ponto final está em pré-visualização e ainda não está documentado, mas pode ver informações sobre os dados devolvidos ao navegar para o URL do ponto final: https://analytics.dev.azure.com/{org}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots.

Por que motivo existem mais trabalhos em execução do que agentes ou simultaneidade?

Os dados do conjunto são agregados a uma granularidade de 10 minutos e o número de tarefas em execução é representado com base no número máximo de tarefas em execução para o intervalo de tempo especificado. Cada tarefa em execução é contada separadamente e, se várias tarefas forem concluídas durante o intervalo de 10 minutos, contribuem para a contagem total de tarefas em execução para esse intervalo.

Qual é a diferença entre ver os gráficos nas definições do Project vs. Definições da organização?

O âmbito dos dados no gráfico é determinado com base no facto de o gráfico ser acedido através das definições do Project ou das Definições da organização. Ao nível da organização, o gráfico é desenhado através de dados de pipelines em qualquer projeto dentro da organização que tenha executado tarefas nesse conjunto. Ao nível do projeto, o gráfico é desenhado com dados de pipelines nesse projeto específico que executaram tarefas nesse conjunto.