Historische grafiek voor agentpools (preview)

Artikel
07/03/2024

Azure DevOps Services

Met het rapport poolverbruik kunt u taken weergeven die worden uitgevoerd in uw agentpoolgroepen die zijn gegrafiekd met gelijktijdigheid van agentpooltaken gedurende een periode van maximaal 30 dagen. U kunt deze informatie gebruiken om te bepalen of uw taken niet worden uitgevoerd vanwege gelijktijdigheidslimieten. Als u veel taken in de wachtrij hebt geplaatst of taken uitvoert op de limiet voor gelijktijdigheid of onlineagenten, kunt u aanvullende parallelle taken aanschaffen of meer zelf-hostende agents inrichten.

Vereisten

Belangrijk

U moet lid zijn van de groep Beheerders van projectverzamelingen om de rapporten voor groepsverbruik voor agentgroepen in een organisatie weer te geven, inclusief rapporten op projectniveau in die organisatie.

Rapport poolverbruik

Het rapport verbruik van pools maakt deel uit van het tabblad Analyse voor een agentgroep en bevat de volgende grafieken, afhankelijk van het type agentgroep.

Grafiektype	Beschrijving	Type agentgroep
Openbare gehoste gelijktijdigheid	Geeft gelijktijdigheid, taken in de wachtrij en actieve taken weer voor openbare projecten	Door Microsoft gehost
Privé-gehoste gelijktijdigheid	Geeft gelijktijdigheid, taken in de wachtrij en actieve taken weer voor privéprojecten	Door Microsoft gehost
Agentgebruik	Hiermee worden onlineagenten, taken in de wachtrij en actieve taken weergegeven voor zelf-hostende agents	Schaalsetagent en zelf-hostend
Persoonlijke zelf-hostende gelijktijdigheid	Geeft gelijktijdigheid, taken in de wachtrij en actieve taken weer voor privé-zelf-hostende projecten	Schaalsetagent en zelf-hostend

De grafieken in het rapportrapport poolverbruik grafiek de volgende gegevenspunten:

Gelijktijdigheid : het aantal parallelle taken in de organisatie dat van toepassing is op het projecttype (openbaar of privé) en het type agentpool (door Microsoft gehost of zelf-hostend). Zie Configureren en betalen voor parallelle taken voor meer informatie.
Onlineagents : het aantal agents online in een zelf-hostende agentgroep of een schaalsetagentgroep.
Taken in wachtrij: het aantal taken in de wachtrij en het wachten op een agent.
Actieve taken : het aantal actieve taken.

Poolgegevens worden geaggregeerd met een granulariteit van 10 minuten en het aantal actieve taken wordt uitgezet op basis van het maximum aantal actieve taken voor het opgegeven tijdsinterval. Omdat meerdere kortlopende taken binnen de tijdlijn van tien minuten kunnen worden voltooid, kan het aantal actieve taken soms hoger zijn dan de gelijktijdigheid of onlineagenten in die periode.

Rapportbereik

Het rapport voor groepsverbruik kan worden weergegeven op organisatiebereik of projectbereik. Op organisatieniveau wordt de grafiek uitgezet met behulp van gegevens uit pijplijnen in elk project binnen de organisatie die taken in die pool hebben uitgevoerd. Op projectniveau wordt de grafiek uitgezet met behulp van gegevens uit pijplijnen in dat specifieke project dat taken in die pool heeft uitgevoerd.

Als u het verbruiksrapport van de pool op organisatieniveau wilt weergeven, kiest u Organisatie-instellingen, Pijplijnen en Agentpools.
Als u het verbruiksrapport van de pool op projectniveau wilt weergeven, gaat u naar het gewenste project en kiest u Project-instellingen, Pijplijnen, Agentpools.

Kies in de weergave Agentpools de gewenste pool en bekijk het tabblad Analyse . In het volgende voorbeeld ziet u het rapport poolverbruik voor een zelf-hostende agentgroep.

Historische grafiek voor zelf-hostende agentpool

In dit voorbeeld ziet u de gebruiksgrafieken voor de door Microsoft gehoste Agent-pool van Azure Pipelines .

Historische grafiek van door Microsoft gehoste agentpool

Filteren

Als u de tijdlijn van de grafiek wilt aanpassen, kiest u Filter , selecteert u de vervolgkeuzelijst interval en kiest u het gewenste interval.

Grafiekduur.

Voor het interval van 1 dag kunt u gegevens per uur weergeven en voor de andere intervallen kunt u deze per dag bekijken. Poolgegevens worden geaggregeerd met een granulariteit van 10 minuten en het aantal actieve taken wordt uitgezet op basis van het maximum aantal actieve taken voor het opgegeven tijdsinterval. In dit voorbeeld zijn er twee onlineagents, maar op sommige gebieden zijn er vier actieve taken vanwege de manier waarop de poolgegevens worden samengevoegd.

Inzoomen op zelf-hostende grafieken.

Veelgestelde vragen

Waar haalt het rapport verbruik van de pool de gegevens op die worden weergegeven?

Het verbruiksrapport van de pool maakt gebruik van de Azure DevOps Analytics-service en het TaskAgentRequestSnapshots eindpunt. U kunt een query uitvoeren op dit eindpunt met behulp van het volgende URL-voorvoegsel: https://analytics.dev.azure.com/{organization}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots.

U kunt het project_id voor uw project ophalen door naar de volgende URL te navigeren: https://dev.azure.com/{organization}/_apis/projects?api-version=5.0-preview.3.

In het volgende voorbeeld ziet u een voorbeeldquery en -antwoord.

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

Zie Queryrichtlijnen voor Analytics met OData voor meer informatie over queryopties.

Notitie

Het TaskAgentRequestSnapshots eindpunt is in preview en is nog niet gedocumenteerd, maar u kunt informatie over de geretourneerde gegevens bekijken door naar de eindpunt-URL te navigeren: https://analytics.dev.azure.com/{org}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots.

Waarom zijn er meer actieve taken dan er agents of gelijktijdigheid zijn?

Poolgegevens worden geaggregeerd met een granulariteit van 10 minuten en het aantal actieve taken wordt uitgezet op basis van het maximum aantal actieve taken voor het opgegeven tijdsinterval. Elke actieve taak wordt afzonderlijk geteld en als er meerdere taken zijn voltooid tijdens het interval van tien minuten, dragen ze bij aan het totale aantal actieve taken voor dat interval.

Wat is het verschil tussen het weergeven van de grafieken in Project-instellingen versus organisatie-instellingen?

Het bereik van de gegevens in de grafiek wordt bepaald op basis van of de grafiek wordt geopend via projectinstellingen of organisatie-instellingen. Op organisatieniveau wordt de grafiek uitgezet met behulp van gegevens uit pijplijnen in elk project binnen de organisatie die taken in die pool hebben uitgevoerd. Op projectniveau wordt de grafiek uitgezet met behulp van gegevens uit pijplijnen in dat specifieke project dat taken in die pool heeft uitgevoerd.

Delen via