Verlaufsdiagramm für Agentpools (Vorschau)

Azure DevOps Services

Im Bericht zum Poolverbrauch können Sie Aufträge anzeigen, die in Ihren Agentpools ausgeführt werden, die mit der Parallelität des Agentpoolauftrags über einen Zeitraum von bis zu 30 Tagen dargestellt werden. Mithilfe dieser Informationen können Sie entscheiden, ob Ihre Aufträge aufgrund von Parallelitätsgrenzwerten nicht ausgeführt werden sollen. Wenn Sie viele Aufträge in die Warteschlange gestellt oder Aufträge an den Parallelitätsgrenzwerten oder Grenzwerten für Online-Agents ausgeführt haben, können Sie zusätzliche Parallelaufträge erwerben oder mehr selbstgehostete Agents bereitstellen.

Voraussetzungen

Wichtig

Sie müssen Mitglied der Gruppe Projektsammlungsadministratoren sein, um die Poolverbrauchsberichte für Agentpools in einer Organisation anzuzeigen, einschließlich der Berichte auf Projektebene in dieser Organisation.

Poolverbrauchsbericht

Der Poolverbrauchsbericht ist Teil der Registerkarte Analyse für einen Agentpool und enthält die folgenden Diagramme, je nach Agentpooltyp.

Diagrammtyp BESCHREIBUNG Agentpooltyp
Öffentliche gehostete Nebenläufigkeit Zeigt Parallelität, in die Warteschlange eingereihte Aufträge und ausgeführte Aufträge für öffentliche Projekte an Von Microsoft gehostet
Private gehostete Nebenläufigkeit Zeigt Parallelität, in die Warteschlange eingereihte Aufträge und ausgeführte Aufträge für private Projekte an Von Microsoft gehostet
Agent-Verwendung Zeigt Online-Agents, in die Warteschlange eingereihte Aufträge und ausgeführte Aufträge für selbstgehostete Agents an Skalierungsgruppen-Agent und selbstgehostet
Private selbst gehostete Nebenläufigkeit Zeigt Parallelität, in die Warteschlange eingereihte Aufträge und ausgeführte Aufträge für private, selbstgehostete Projekte an Skalierungsgruppen-Agent und selbstgehostet

Die Diagramme im Graph zum Poolverbrauchsbericht weisen die folgenden Datenpunkte auf:

  • Parallelität: Dies ist die Anzahl paralleler Aufträge in der Organisation, die für den Projekttyp (öffentlich oder privat) und den Agentpooltyp (von Microsoft gehostet oder selbstgehostet) gelten. Weitere Informationen finden Sie unter Konfigurieren von und Bezahlen für Parallelaufträge.
  • Online-Agents: Dies ist die Anzahl der Online-Agents in einem selbstgehosteten Agentpool oder einem Agentpool für Skalierungsgruppen.
  • Aufträge in der Warteschlange: Dies ist die Anzahl der Aufträge, die in die Warteschlange gestellt werden und auf einen Agent warten.
  • Ausgeführte Aufträge: Dies ist die Anzahl der ausgeführten Aufträge.

Pooldaten werden mit einer Granularität von 10 Minuten aggregiert, und die Anzahl der ausgeführten Aufträge wird basierend auf der maximalen Anzahl ausgeführter Aufträge für das angegebene Zeitintervall dargestellt. Da mehrere Aufträge mit kurzer Laufzeit innerhalb des Zeitintervalls von 10 Minuten abgeschlossen werden können, kann die Anzahl der ausgeführten Aufträge manchmal höher sein als die Parallelität oder Online-Agents in diesem Zeitraum.

Berichtsbereich

Der Bericht zum Poolverbrauch kann im Organisationsbereich oder im Projektbereich angezeigt werden. Auf Organisationsebene wird das Diagramm mithilfe von Daten aus Pipelines in jedem Projekt innerhalb der Organisation gezeichnet, in dem Aufträge in diesem Pool ausgeführt werden. Auf Projektebene wird das Diagramm mithilfe von Daten aus Pipelines in diesem bestimmten Projekt gezeichnet, die Aufträge in diesem Pool ausgeführt haben.

  • Um den Poolverbrauchsbericht auf Organisationsebene anzuzeigen, wählen Sie Organisationseinstellungen >Pipelines > Agentpools aus.
  • Um den Poolverbrauchsbericht auf Projektebene anzuzeigen, navigieren Sie zum gewünschten Projekt, und wählen Sie Projekteinstellungen > Pipelines > Agentpools aus.

Wählen Sie in der Ansicht Agentpools den gewünschten Pool aus, und zeigen Sie die Registerkarte Analytics an. Das folgende Beispiel zeigt den Poolverbrauchsbericht für einen Pool selbstgehosteter Agents.

Verlaufsdiagramm: Pool selbstgehosteter Agents

Dieses Beispiel zeigt die Nutzungsdiagramme für den von Microsoft gehosteten Azure Pipelines-Agentpool.

Verlaufsdiagramm: von Microsoft gehostete Agentpools

Filterung

Um die Zeitachse des Diagramms anzupassen, wählen Sie "Filtern" aus, wählen Sie die Dropdownliste "Intervall" und dann das gewünschte Intervall aus.

Graphdauer

Für das Intervall von einem Tag können Sie Daten pro Stunde anzeigen, und für die anderen Intervalle können Sie sie pro Tag anzeigen. Pooldaten werden mit einer Granularität von 10 Minuten aggregiert, und die Anzahl der ausgeführten Aufträge wird basierend auf der maximalen Anzahl ausgeführter Aufträge für das angegebene Zeitintervall dargestellt. In diesem Beispiel gibt es zwei Online-Agents, aber in einigen Bereichen gibt es aufgrund der Art, wie die Pooldaten aggregiert werden, vier ausgeführte Aufträge.

Drilldown in den Agent-Verbrauch

Häufig gestellte Fragen

Von wo erhält der Poolverbrauchsbericht seine Daten?

Der Poolverbrauchsbericht verwendet den Azure DevOps Analytics-Dienst und den TaskAgentRequestSnapshots-Endpunkt. Sie können diesen Endpunkt mit dem folgenden URL-Präfix abfragen: https://analytics.dev.azure.com/{organization}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots.

Sie können die project_id für Ihr Projekt abrufen, indem Sie zu der folgenden URL navigieren: https://dev.azure.com/{organization}/_apis/projects?api-version=5.0-preview.3

Das folgende Beispiel zeigt eine Beispielabfrage und -antwort.

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

Weitere Informationen zu Abfrageoptionen finden Sie in den Abfragerichtlinien für Analysen mit OData.

Hinweis

Der TaskAgentRequestSnapshots-Endpunkt befindet sich in der Vorschau und ist noch nicht dokumentiert, Sie können jedoch Informationen zu den zurückgegebenen Daten anzeigen, indem Sie zur Endpunkt-URL navigieren: https://analytics.dev.azure.com/{org}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots

Warum gibt es mehr ausgeführte Aufträge als Agents oder Parallelität?

Pooldaten werden mit einer Granularität von 10 Minuten aggregiert, und die Anzahl der ausgeführten Aufträge wird basierend auf der maximalen Anzahl ausgeführter Aufträge für das angegebene Zeitintervall dargestellt. Jeder ausgeführte Auftrag wird separat gezählt, und wenn mehrere Aufträge während des zehnminütigen Intervalls abgeschlossen werden, tragen sie zur Gesamtanzahl der ausgeführten Aufträge für dieses Intervall bei.

Was ist der Unterschied zwischen der Anzeige der Graphen in den Projekteinstellungen und den Organisationseinstellungen?

Der Umfang der Daten im Graph wird basierend darauf bestimmt, ob über die Projekteinstellungen oder die Organisationseinstellungen auf den Graph zugegriffen wird. Auf Organisationsebene wird das Diagramm mithilfe von Daten aus Pipelines in jedem Projekt innerhalb der Organisation gezeichnet, in dem Aufträge in diesem Pool ausgeführt werden. Auf Projektebene wird das Diagramm mithilfe von Daten aus Pipelines in diesem bestimmten Projekt gezeichnet, die Aufträge in diesem Pool ausgeführt haben.