Gráfico histórico para grupos de agentes (versión preliminar)
El informe de consumo del grupo le permite ver los trabajos que se ejecutan en los grupos de agentes gráficos con simultaneidad de trabajos del grupo de agentes durante un intervalo de hasta 30 días. Puede usar esta información para ayudar a decidir si los trabajos no se están ejecutando debido a los límites de simultaneidad. Si tiene muchos trabajos en cola o en ejecución en el límite de agentes de simultaneidad o en línea, puede que desee adquirir trabajos paralelos adicionales o aprovisionar más agentes auto-hospedados.
Requisitos previos
El gráfico histórico de los grupos de agentes está en versión preliminar. Para habilitar o deshabilitar esta característica en versión preliminar, vaya a Características enversión preliminar, busque Gráficohistórico para grupos de agentes y elija la configuración deseada.
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 en Microsoft |
| Simultaneidad hospedada privada | Muestra la simultaneidad, los trabajos en cola y los trabajos en ejecución para proyectos privados. | Hospedado en Microsoft |
| Uso del agente | Muestra agentes en línea, trabajos en cola y trabajos en ejecución para agentes auto hospedados | Agente de conjunto de escalado y auto-hospedado |
| Simultaneidad auto-hospedada privada | Muestra la simultaneidad, los trabajos en cola y los trabajos en ejecución para proyectos privados auto-hospedados. | Agente de conjunto de escalado y auto-hospedado |
Los gráficos del gráfico de informe de consumo de grupo presentan 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 auto-hospedado). Para obtener más información, vea Configurar y pagar trabajos paralelos.
- Agentes en línea: el número de agentes en línea en un grupo de agentes auto-hospedado o en 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: el número de trabajos en ejecución.
Los datos del grupo se agregan con 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 durante el intervalo de tiempo especificado. Dado que se pueden completar varios trabajos de ejecución corta dentro de la escala de tiempo de 10 minutos, el recuento de trabajos en ejecución a veces puede ser mayor que los agentes de simultaneidad o en línea durante ese mismo período.
Á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 con datos de canalizaciones en cualquier proyecto dentro de la organización que haya ejecutado trabajos en ese grupo. En el nivel de proyecto, el gráfico se traza con datos de canalizaciones de ese proyecto concreto que han ejecutado trabajos en ese grupo.
- Para ver el informe de consumo del grupo en el nivel de organización, elija Configuraciónde la organización ,Pipelines , Grupos de agentes.
- Para ver el informe de consumo del grupo en el nivel de proyecto, vaya al proyecto deseado y elija Project configuración ,Pipelines, 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 auto-hospedado.
En este ejemplo se muestran los gráficos de uso de Azure Pipelines grupo de agentes hospedados por Microsoft.
Filtrado
Para ajustar la escala de tiempo del gráfico, elija Filtro, 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 con 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 durante 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 Azure DevOps Analytics y el punto de conexión. Puede consultar este punto de conexión con el siguiente prefijo de dirección URL: https://analytics.dev.azure.com/{organization}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots .
Para recuperar el para project_id el proyecto, vaya a la siguiente dirección URL: https://dev.azure.com/{organization}/_apis/projects?api-version=5.0-preview.3 .
En el ejemplo siguiente se muestra una consulta y una 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 más información sobre las opciones de consulta, consulte Instrucciones de consulta para Analytics con OData.
Nota
El punto de conexión está en versión preliminar y aún no está documentado, pero puede ver información sobre los datos devueltos navegando a la dirección URL del punto TaskAgentRequestSnapshots 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 con 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 durante 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 gráficos en la configuración Project configuración frente a la configuración de la organización?
El ámbito de los datos del gráfico se determina en función de si se tiene acceso al gráfico a través Project configuración de la organización o . En el nivel de organización, el gráfico se traza con datos de canalizaciones en cualquier proyecto dentro de la organización que haya ejecutado trabajos en ese grupo. En el nivel de proyecto, el gráfico se traza con datos de canalizaciones de ese proyecto concreto que han ejecutado trabajos en ese grupo.