Graphique historique pour les pools d’agents (préversion)

Azure DevOps Services

Le rapport de consommation de pool vous permet d’afficher les travaux en cours d’exécution dans vos pools d’agents, ainsi que la concurrence des tâches du pool d’agents sur une période pouvant aller jusqu’à 30 jours. Vous pouvez utiliser ces informations pour déterminer si vos travaux ne sont pas en cours d’exécution en raison de limites d’accès concurrentiel. Si de nombreux travaux sont mis en file d’attente ou en cours d’exécution au niveau de la limite de concurrence ou d’agents en ligne, vous pouvez acheter des travaux parallèles supplémentaires ou approvisionner davantage d’agents autohébergés.

Prérequis

Important

Vous devez être membre du groupe Administrateurs de la collection de projets pour afficher les rapports de consommation de pool pour les pools d’agents d’une organisation, y compris les rapports au niveau du projet dans cette organisation.

Rapport de consommation du pool

Le rapport de consommation du pool fait partie de l’onglet Analytics pour un pool d’agents et contient les graphiques suivants, en fonction du type de pool d’agents.

Type de graphique	Description	Type de pool d’agents
Concurrence hébergée publique	Affiche la concurrence, les travaux mis en file d’attente et les travaux en cours d’exécution pour les projets publics	Hébergé par Microsoft
Concurrence hébergée privée	Affiche la concurrence, les travaux mis en file d’attente et les travaux en cours d’exécution pour les projets privés	Hébergé par Microsoft
Utilisation de l’agent	Affiche les agents en ligne, les travaux mis en file d’attente et les travaux en cours d’exécution pour les agents autohébergés	Agent de groupe identique et autohébergé
Concurrence autohébergée privée	Affiche la concurrence, les travaux mis en file d’attente et les travaux en cours d’exécution pour les projets autohébergés privés	Agent de groupe identique et autohébergé

Les graphiques du rapport de consommation de pool illustrent les points de données suivants :

• Concurrence : nombre de travaux parallèles dans l’organisation qui s’appliquent au type de projet (public ou privé) et au type de pool d’agents (hébergés par Microsoft ou autohébergés). Pour plus d’informations, consultez Configurer et payer des travaux parallèles.
• Agents en ligne : nombre d’agents en ligne dans un pool d’agents autohébergé ou un pool d’agents de groupe identique.
• Travaux mis en file d’attente : nombre de travaux mis en file d’attente et en attente d’un agent.
• Travaux en cours d’exécution : nombre de travaux en cours d’exécution.

Les données du pool sont agrégées à une granularité de 10 minutes, et le nombre de travaux en cours d’exécution est représenté en fonction du nombre maximal de travaux en cours d’exécution pour l’intervalle de temps spécifié. Étant donné que plusieurs travaux à court terme peuvent se terminer dans la chronologie de 10 minutes, le nombre de travaux en cours d’exécution peut parfois être supérieur à la concurrence ou aux agents en ligne pendant cette même période.

Étendue du rapport

Le rapport de consommation du pool peut être affiché au niveau de l’étendue de l’organisation ou de l’étendue du projet. Au niveau de l’organisation, le graphique est représenté à l’aide de données provenant de pipelines de tous les projets de l’organisation qui ont exécuté des travaux dans ce pool. Au niveau du projet, le graphique est représenté à l’aide de données provenant de pipelines dans ce projet particulier qui ont exécuté des travaux dans ce pool.

• Pour afficher le rapport de consommation du pool au niveau de l’organisation, choisissez Paramètres de l’organisation, Pipelines puis Pools d’agents.
• Pour afficher le rapport de consommation du pool au niveau du projet, accédez au projet souhaité et choisissez Paramètres du projet, Pipelines puis Pools d’agents.

Dans la vue Pools d’agents, choisissez le pool souhaité, puis affichez l’onglet Analyse. L’exemple suivant montre le rapport de consommation du pool pour un pool d’agents autohébergés.

Cet exemple montre les graphiques d’utilisation pour le pool d’agents hébergés par Microsoft Azure Pipelines.

Filtrage

Pour ajuster la chronologie du graphique, choisissez Filtrer, sélectionnez la liste déroulante d’intervalles, puis choisissez l’intervalle souhaité.

Pour l’intervalle d’un jour, vous pouvez afficher les données par heure, et pour les autres intervalles, vous pouvez les afficher par jour. Les données du pool sont agrégées à une granularité de 10 minutes, et le nombre de travaux en cours d’exécution est représenté en fonction du nombre maximal de travaux en cours d’exécution pour l’intervalle de temps spécifié. Dans cet exemple, il y a deux agents en ligne, mais dans certaines zones, il peut y avoir quatre travaux en cours d’exécution en raison de la façon dont les données du pool sont agrégées.

Questions fréquentes (FAQ)

Où le rapport de consommation du pool obtient-il les données affichées ?

Le rapport de consommation du pool utilise le service Azure DevOps Analytics et le point de terminaison TaskAgentRequestSnapshots. Vous pouvez interroger ce point de terminaison à l’aide du préfixe d’URL suivant : https://analytics.dev.azure.com/{organization}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots.

Vous pouvez récupérer le project_id pour votre projet en accédant à l’URL suivante : https://dev.azure.com/{organization}/_apis/projects?api-version=5.0-preview.3.

L’exemple suivant montre un modèle de requête et de réponse.

{
"@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
},
...

Pour plus d’informations sur les options de requête, consultez les instructions de requête pour Analytics avec OData.

Notes

Le TaskAgentRequestSnapshots point de terminaison est en préversion et n’est pas encore documenté, mais vous pouvez afficher des informations sur les données retournées en accédant à l’URL du point de terminaison : https://analytics.dev.azure.com/{org}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots.

Pourquoi y a-t-il plus de travaux en cours d’exécution qu’il n’existe d’agents ou de concurrence ?

Les données du pool sont agrégées à une granularité de 10 minutes, et le nombre de travaux en cours d’exécution est représenté en fonction du nombre maximal de travaux en cours d’exécution pour l’intervalle de temps spécifié. Chaque travail en cours d’exécution est comptabilisé séparément et, si plusieurs travaux se terminent au cours de l’intervalle de 10 minutes, ils contribuent au nombre total de travaux en cours d’exécution pour cet intervalle.

Quelle est la différence entre l’affichage des graphiques dans les paramètres du projet et les paramètres de l’organisation ?

L’étendue des données du graphique est déterminée en fonction de l’accès au graphique via les paramètres du projet ou les paramètres de l’organisation. Au niveau de l’organisation, le graphique est représenté à l’aide de données provenant de pipelines de tous les projets de l’organisation qui ont exécuté des travaux dans ce pool. Au niveau du projet, le graphique est représenté à l’aide de données provenant de pipelines dans ce projet particulier qui ont exécuté des travaux dans ce pool.