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:
- Simultaneidad : el número de trabajos paralelos de la organización que se aplican al tipo de proyecto (público o privado) y al tipo de grupo de agentes (hospedado por Microsoft o autohospedado). Para más información, consulte Configuración y pago de trabajos paralelos.
- Agentes en línea: el número de agentes en línea en un grupo de agentes autohospedado o un grupo de agentes de conjunto de escalado.
- Trabajos en cola: el número de trabajos en cola y en espera de un agente.
- Trabajos en ejecución: número de trabajos en ejecución.
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.
En este ejemplo se muestran los gráficos de uso del grupo de agentes hospedados por Microsoft de Azure Pipelines.
Filtros
Para ajustar la escala de tiempo del gráfico, elija Filtrar 
, seleccione la lista desplegable intervalo y elija el intervalo deseado.
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.
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.