Historikdiagram för agentpooler (förhandsversion)

Azure DevOps Services

Med rapporten för poolförbrukning kan du visa jobb som körs i dina agentpooler som är graferade med samtidighet för agentpooljobb under ett intervall på upp till 30 dagar. Du kan använda den här informationen för att avgöra om dina jobb inte körs på grund av samtidighetsgränser. Om du har många jobb i kö eller kör jobb vid gränsen för samtidighet eller onlineagenter kanske du vill köpa ytterligare parallella jobb eller etablera fler lokalt installerade agenter.

Förutsättningar

Viktigt

Du måste vara medlem i gruppen Projektsamlingsadministratörer för att visa poolförbrukningsrapporterna för agentpooler i en organisation, inklusive rapporter på projektnivå i den organisationen.

Rapport om poolförbrukning

Rapporten för poolförbrukning är en del av fliken Analys för en agentpool och innehåller följande diagram, beroende på typen av agentpool.

Diagramtyp	Description	Typ av agentpool
Offentlig värdbaserad samtidighet	Visar samtidighet, köade jobb och jobb som körs för offentliga projekt	Microsoft-värdbaserad
Privat värdbaserad samtidighet	Visar samtidighet, köade jobb och jobb som körs för privata projekt	Microsoft-värdbaserad
Agentanvändning	Visar onlineagenter, köade jobb och jobb som körs för lokalt installerade agenter	Skalningsuppsättningsagent och lokalt installerad
Privat samtidighet med egen värd	Visar samtidighet, köade jobb och jobb som körs för privata lokalt installerade projekt	Skalningsuppsättningsagent och lokalt installerad

Diagrammen i rapporten för poolförbrukning visar följande datapunkter:

• Samtidighet – antalet parallella jobb i organisationen som gäller för projekttypen (offentlig eller privat) och agentpooltypen (Microsoft-värdbaserad eller lokalt installerad). Mer information finns i Konfigurera och betala för parallella jobb.
• Onlineagenter – Antalet agenter online i en lokalt installerad agentpool eller en skalningsuppsättningsagentpool.
• Köade jobb – Antalet jobb i kö och väntar på en agent.
• Jobb som körs – antalet jobb som körs.

Pooldata aggregeras med en kornighet på 10 minuter och antalet jobb som körs ritas baserat på det maximala antalet jobb som körs under det angivna tidsintervallet. Eftersom flera kortvariga jobb kan slutföras inom tidslinjen på 10 minuter kan antalet jobb som körs ibland vara högre än samtidigheten eller onlineagenterna under samma period.

Rapportomfång

Rapporten för poolförbrukning kan visas i organisationens omfång eller i projektomfånget. På organisationsnivå ritas diagrammet med data från pipelines i alla projekt inom organisationen som har kört jobb i poolen. På projektnivå ritas diagrammet med data från pipelines i det specifika projektet som har körningsjobb i poolen.

• Om du vill visa rapporten för poolförbrukning på organisationsnivå väljer du Organisationsinställningar, Pipelines, Agentpooler.
• Om du vill visa rapporten för poolförbrukning på projektnivå navigerar du till önskat projekt och väljer Projektinställningar, Pipelines, Agentpooler.

I vyn Agentpooler väljer du önskad pool och visar fliken Analys . I följande exempel visas rapporten för poolförbrukning för en lokalt installerad agentpool.

Det här exemplet visar användningsdiagram för Den Microsoft-värdbaserade agentpoolen för Azure Pipelines .

Filtrering

Om du vill justera tidslinjen för diagrammet väljer du Filter , väljer listrutan Intervall och väljer önskat intervall.

För 1-dagarsintervallet kan du visa data per timme och för de andra intervallen kan du visa dem per dag. Pooldata aggregeras med en kornighet på 10 minuter och antalet jobb som körs ritas baserat på det maximala antalet jobb som körs under det angivna tidsintervallet. I det här exemplet finns det två onlineagenter, men i vissa områden finns det fyra jobb som körs på grund av hur pooldata aggregeras.

Vanliga frågor

Var hämtar rapporten för poolförbrukning de data som visas?

Rapporten för poolförbrukning använder Tjänsten Azure DevOps Analytics och TaskAgentRequestSnapshots slutpunkten. Du kan fråga den här slutpunkten med hjälp av följande URL-prefix: https://analytics.dev.azure.com/{organization}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots.

Du kan hämta project_id för projektet genom att gå till följande URL: https://dev.azure.com/{organization}/_apis/projects?api-version=5.0-preview.3.

I följande exempel visas en exempelfråga och ett svar.

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

Mer information om frågealternativ finns i Frågeriktlinjer för analys med OData.

Anteckning

Slutpunkten TaskAgentRequestSnapshots är i förhandsversion och är ännu inte dokumenterad, men du kan visa information om de data som returneras genom att gå till slutpunkts-URL:en: https://analytics.dev.azure.com/{org}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots.

Varför finns det fler jobb som körs än det finns agenter eller samtidighet?

Pooldata aggregeras med en kornighet på 10 minuter och antalet jobb som körs ritas baserat på det maximala antalet jobb som körs under det angivna tidsintervallet. Varje jobb som körs räknas separat, och om flera jobb slutförs under 10-minutersintervallet bidrar de till det totala antalet jobb som körs för det intervallet.

Vad är skillnaden mellan att visa graferna i Projektinställningar jämfört med organisationsinställningar?

Omfånget för data i diagrammet bestäms baserat på om diagrammet nås via projektinställningar eller organisationsinställningar. På organisationsnivå ritas diagrammet med data från pipelines i alla projekt inom organisationen som har kört jobb i poolen. På projektnivå ritas diagrammet med data från pipelines i det specifika projektet som har körningsjobb i poolen.