Gráfico histórico para grupos de agentes (versión preliminar)

Azure DevOps Services

El informe de consumo del grupo permite ver los trabajos que se ejecutan en los grupos de agentes en un gráfico con simultaneidad de trabajos del grupo de agentes durante un intervalo de hasta 30 días. Puede usar esta información para decidir si los trabajos no se ejecutan debido a los límites de simultaneidad. Si tiene muchos trabajos en cola o en ejecución en el límite de simultaneidad o agentes en línea, puede que desee comprar trabajos paralelos adicionales o aprovisionar más agentes autohospedados.

Prerrequisitos

Importante

Debe ser miembro del grupo Administradores de la colección de proyectos para ver los informes de consumo de los grupos de agentes de una organización, incluidos los informes a nivel de proyecto de dicha organización.

Informe de consumo de grupos

El informe de consumo del grupo forma parte de la pestaña Análisis de un grupo de agentes y contiene los gráficos siguientes, según el tipo de grupo de agentes.

Tipo de gráfico Descripción Tipo de grupo de agentes
Simultaneidad hospedada pública Muestra la simultaneidad, los trabajos en cola y los trabajos en ejecución para proyectos públicos. Hospedado por Microsoft
Simultaneidad hospedada privada Muestra la simultaneidad, los trabajos en cola y los trabajos en ejecución para proyectos privados. Hospedado por Microsoft
Uso del agente Muestra agentes en línea, trabajos en cola y trabajos en ejecución para agentes autohospedados. Agente de conjunto de escalado y autohospedado
Simultaneidad autohospedada privada Muestra la simultaneidad, los trabajos en cola y los trabajos en ejecución para proyectos autohospedados privados. Agente de conjunto de escalado y autohospedado

Los gráficos del informe de consumo del grupo representan los siguientes puntos de datos:

Los datos del grupo se agregan en una granularidad de 10 minutos, y el número de trabajos en ejecución se traza en función del número máximo de trabajos en ejecución para el intervalo de tiempo especificado. Dado que varios trabajos de corta duración pueden completarse en el plazo de 10 minutos, el recuento de trabajos en ejecución puede ser a veces superior a la simultaneidad o a los agentes en línea durante ese mismo periodo.

Ámbito del informe

El informe de consumo del grupo se puede mostrar en el ámbito de la organización o en el ámbito del proyecto. En el nivel de organización, el gráfico se traza mediante los datos de las canalizaciones de cualquier proyecto de la organización que hayan ejecutado trabajos en ese grupo. En el nivel de proyecto, el gráfico se traza mediante los datos de las canalizaciones de ese proyecto concreto que hayan ejecutado trabajos en ese pool.

  • Para ver el informe de consumo de grupos a nivel de organización, seleccione Configuración de la organización, Canalizaciones, Grupos de agentes.
  • Para ver el informe de consumo del grupo en el nivel de proyecto, vaya al proyecto deseado y elija Configuración del proyecto, Canalizaciones, Grupos de agentes.

En la vista Grupos de agentes, elija el grupo deseado y vea la pestaña Análisis. En el ejemplo siguiente se muestra el informe de consumo del grupo para un grupo de agentes autohospedado.

Gráfico histórico del grupo de agentes autohospedados

En este ejemplo se muestran los gráficos de uso del grupo de agentes hospedados por Microsoft de Azure Pipelines.

Gráfico histórico del grupo de agentes hospedados por Microsoft

Filtros

Para ajustar la escala de tiempo del gráfico, elija Filtrar, seleccione el desplegable de intervalo y elija el intervalo deseado.

Duración del grafo.

Para el intervalo de 1 día, puede ver los datos por hora, y para los demás intervalos puede verlos por día. Los datos del grupo se agregan en una granularidad de 10 minutos, y el número de trabajos en ejecución se traza en función del número máximo de trabajos en ejecución para el intervalo de tiempo especificado. En este ejemplo hay dos agentes en línea, pero en algunas áreas hay cuatro trabajos en ejecución debido a la forma en que se agregan los datos del grupo.

Exploración en profundidad del grafo autohospedado.

Preguntas más frecuentes

¿Dónde obtiene el informe de consumo del grupo los datos que muestra?

El informe de consumo del grupo usa el servicio Analytics de Azure DevOps Analytics y el punto de conexión TaskAgentRequestSnapshots. Puede consultar este punto de conexión mediante el siguiente prefijo de dirección URL: https://analytics.dev.azure.com/{organization}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots.

Puede recuperar project_id para su proyecto navegando a la siguiente URL: https://dev.azure.com/{organization}/_apis/projects?api-version=5.0-preview.3.

En el ejemplo siguiente se muestra una consulta y respuesta de ejemplo.

{
"@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 obtener más información sobre las opciones de consulta, consulte Directrices de consulta para Analytics con OData.

Nota

El punto de conexión TaskAgentRequestSnapshots está en versión preliminar y aún no está documentado, pero puede ver información sobre los datos devueltos; para ello, vaya a la dirección URL del punto de conexión: https://analytics.dev.azure.com/{org}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots.

¿Por qué hay más trabajos en ejecución que agentes o simultaneidad?

Los datos del grupo se agregan en una granularidad de 10 minutos, y el número de trabajos en ejecución se traza en función del número máximo de trabajos en ejecución para el intervalo de tiempo especificado. Cada trabajo en ejecución se cuenta por separado y, si se completan varios trabajos durante el intervalo de 10 minutos, contribuyen al recuento total de trabajos en ejecución para ese intervalo.

¿Cuál es la diferencia entre ver los grafos en Configuración del proyecto o en Configuración de la organización?

El ámbito de los datos del grafo se determina en función de si se accede al gráfico a través de Configuración del proyecto o Configuración de la organización. En el nivel de organización, el gráfico se traza mediante los datos de las canalizaciones de cualquier proyecto de la organización que hayan ejecutado trabajos en ese grupo. En el nivel de proyecto, el gráfico se traza mediante los datos de las canalizaciones de ese proyecto concreto que hayan ejecutado trabajos en ese pool.