Historiskt diagram för agentpooler (förhandsversion)

Artikel
07/03/2024

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 agentpoolsjobb 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 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 samtidighet, köade jobb och jobb som körs för offentliga projekt	Microsoft-värdtjänst
Privat värdbaserad samtidighet	Visar samtidighet, köade jobb och jobb som körs för privata projekt	Microsoft-värdtjänst
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 projekt med egen värd	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 korta 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 projektomfång. På organisationsnivå ritas diagrammet med data från pipelines i alla projekt i organisationen som har kört jobb i poolen. På projektnivå ritas diagrammet med data från pipelines i det specifika projektet som har kö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.

Historisk graf för lokalt installerad agentpool

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

Historisk graf för Microsoft-värdbaserad agentpool

Filtrering

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

Diagramvaraktighet.

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 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.

Grafgranskare med egen värd.

Vanliga frågor

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

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.

Kommentar

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 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 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 poolen. På projektnivå ritas diagrammet med data från pipelines i det specifika projektet som har kört jobb i poolen.

Dela via