Historische grafiek voor agentpools (preview)

Azure DevOps Services

Met het rapport verbruik van de pool kunt u taken weergeven die worden uitgevoerd in uw agentpools, in een grafiek 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 er veel taken in de wachtrij staan of taken worden uitgevoerd op de limiet voor gelijktijdigheid of onlineagents, kunt u extra parallelle taken aanschaffen of meer zelf-hostende agents inrichten.

Vereisten

Belangrijk

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

Rapport Verbruik van groep

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

Grafiektype	Beschrijving	Type agentpool
Openbaar gehoste gelijktijdigheid	Gelijktijdigheid, taken in de wachtrij en actieve taken voor openbare projecten weergeven	Door Microsoft gehost
Privé gehoste gelijktijdigheid	Gelijktijdigheid, taken in de wachtrij en actieve taken voor privéprojecten weergeven	Door Microsoft gehost
Agentgebruik	Geeft onlineagents, taken in de wachtrij en actieve taken voor zelf-hostende agents weer	Schaalsetagent en zelf-hostend
Privé-zelf-hostende gelijktijdigheid	Geeft gelijktijdigheid, taken in de wachtrij en actieve taken weer voor privé-zelf-hostende projecten	Schaalsetagent en zelf-hostend

In de grafieken in het rapport Verbruik van de pool worden de volgende gegevenspunten weergegeven:

• 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 Parallelle taken configureren en betalen voor meer informatie.
• Onlineagents : het aantal agents online in een zelf-hostende agentpool of een schaalsetagentgroep.
• Taken in wachtrij : het aantal taken dat in de wachtrij staat en wacht op een agent.
• Actieve taken : het aantal actieve taken.

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

Rapportbereik

Het rapport verbruik van de groep kan worden weergegeven in het bereik van de organisatie of het projectbereik. Op organisatieniveau wordt de grafiek weergegeven met behulp van gegevens uit pijplijnen in elk project binnen de organisatie die taken in die pool hebben uitgevoerd. Op projectniveau wordt de grafiek weergegeven met behulp van gegevens uit pijplijnen in dat specifieke project die taken in die pool hebben uitgevoerd.

• Als u het rapport over het verbruik van de pool op organisatieniveau wilt weergeven, kiest u Organisatie-instellingen, Pijplijnen, Agentpools.
• Als u het verbruiksrapport van de groep op projectniveau wilt weergeven, gaat u naar het gewenste project en kiest u Projectinstellingen, Pijplijnen, Agentpools.

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

In dit voorbeeld ziet u de gebruiksgrafieken voor de door Microsoft gehoste agentpool van Azure Pipelines .

Filteren

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

Voor het interval van 1 dag kunt u gegevens per uur bekijken 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 weergegeven op basis van het maximum aantal actieve taken voor het opgegeven tijdsinterval. In dit voorbeeld zijn er twee onlineagents, maar in sommige gebieden zijn er vier actieve taken vanwege de manier waarop de poolgegevens worden geaggregeerd.

Veelgestelde vragen

Waar haalt het rapport verbruik van de groep 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 de 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 analyse 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 weergegeven op basis van het maximum aantal actieve taken voor het opgegeven tijdsinterval. Elke actieve taak wordt afzonderlijk geteld en als meerdere taken zijn voltooid tijdens het interval van 10 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 toegankelijk is via Projectinstellingen of Organisatie-instellingen. Op organisatieniveau wordt de grafiek weergegeven met behulp van gegevens uit pijplijnen in elk project binnen de organisatie die taken in die pool hebben uitgevoerd. Op projectniveau wordt de grafiek weergegeven met behulp van gegevens uit pijplijnen in dat specifieke project die taken in die pool hebben uitgevoerd.