Historiskt diagram för agentpooler (förhandsversion)

Azure DevOps Services

Rapporten för resursanvändning i poolen gör det möjligt att se jobb som körs i dina agentpooler, presenterade som grafer med jobbsamtidighet i agentpoolen över en period på upp till 30 dagar. Du kan använda den här informationen för att fastställa om dina jobb inte körs på grund av samtidighetsgränser. Om du har många jobb i kö eller jobb som körs 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å agentpooltypen.

Diagramtyp	beskrivning	Typ av agentpool
Offentlig värdbaserad samtidighet	Visar samtidiga processer, köade jobb och jobb som körs för offentliga projekt	Microsoft-värdtjänst
Privat värdkontrollerad samtidighet	Visar samtidighet, köade jobb och jobb som körs för privata projekt	Microsoft-hostad
Agentanvändning	Visar online-agenter, köade jobb och jobb som körs för självhostade agenter	Skalningsuppsättningsagent och lokalt installerad
Privat självhostad samtidighet	Visar samtidighet, köade jobb och jobb som körs för privata självhostade projekt	Skaleringsuppsättningsagent och självhostad

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 självhostad agentpool eller en skalningsagentpool.
• 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 detaljnivå på 10 minuter och antalet aktiva jobb visas baserat på det maximala antalet aktiva jobb under det angivna tidsintervallet. Eftersom flera kortvariga jobb kan slutföras inom tidsramen på 10 minuter kan antalet aktiva jobb ibland vara högre än antalet samtidiga eller onlineagenter under samma period.

Rapportomfång

Rapporten för poolkonsumtion kan visas på organisationsnivå eller projektnivå. På organisationsnivå ritas diagrammet med data från dataprocessflöden i alla projekt inom organisationen som har utfört jobb i den poolen. På projektnivå ritas diagrammet med data från pipelines i det specifika projektet som har utfört jobb 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å går 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 Filtrera , väljer listrutan Intervall och väljer önskat intervall.

För intervallet 1 dag kan du visa data per timme och för de andra intervallen kan du visa dem per dag. Pooldata aggregeras med en upplösning på 10 minuter och antalet jobb som körs ritas baserat på det högsta antalet jobb som körs under det angivna tidsintervallet. I det här exemplet finns det två onlineagenter, men i vissa avsnitt finns det fyra aktiva jobb på grund av sättet på vilket pooldata aggregeras.

Vanliga frågor

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

Rapporten för poolförbrukning använder Azure DevOps Analytics-tjänsten 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 har ännu inte dokumenterats, men du kan visa information om de data som returneras genom att navigera 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 detaljnivå på 10 minuter, och antalet körande jobb plottas utifrån det maximala antalet jobb under det angivna tidsintervallet. Varje jobb som körs räknas separat, och om flera jobb slutförs under intervallet på 10 minuter bidrar de till det totala antalet jobb som körs för det intervallet.

Vad är skillnaden mellan att visa diagram 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 i organisationen som har kört jobb i den poolen. På projektnivå ritas diagrammet med data från pipelines i det specifika projektet som har kört jobb i den poolen.