Grafico cronologico per i pool di agenti (anteprima)

Azure DevOps Services

Il report sull'utilizzo del pool consente di visualizzare i processi in esecuzione nei pool di agenti grafici con concorrenza del processo del pool di agenti in un intervallo di fino a 30 giorni. È possibile usare queste informazioni per decidere se i processi non sono in esecuzione a causa dei limiti di concorrenza. Se sono presenti molti processi in coda o in esecuzione al limite di concorrenza o agenti online, è possibile acquistare processi paralleli aggiuntivi o effettuare il provisioning di altri agenti self-hosted.

Prerequisiti

Importante

È necessario essere un membro del gruppo Project Collection Administrators per visualizzare i report relativi all'utilizzo del pool per i pool di agenti in un'organizzazione, inclusi i report a livello di progetto in tale organizzazione.

Report sull'utilizzo del pool

Il report sull'utilizzo del pool fa parte della scheda Analisi per un pool di agenti e contiene i grafici seguenti, a seconda del tipo di pool di agenti.

Tipo di grafico	Descrizione	Tipo di pool di agenti
Concorrenza ospitata pubblica	Visualizza concorrenza, processi in coda ed esecuzione di processi per progetti pubblici	Microsoft ospitato
Concorrenza ospitata privata	Visualizza concorrenza, processi in coda ed esecuzione di processi per progetti privati	Microsoft ospitato
Utilizzo dell'agente	Visualizza agenti online, processi in coda ed esecuzione di processi per agenti self-hosted	Agente del set di scalabilità e self-hosted
Concorrenza self-hosted privata	Visualizza concorrenza, processi in coda ed esecuzione di processi per progetti self-hosted privati	Agente del set di scalabilità e self-hosted

I grafici nel report sull'utilizzo del pool grafo dei punti dati seguenti:

• Concorrenza : numero di processi paralleli nell'organizzazione che si applicano al tipo di progetto (pubblico o privato) e al tipo di pool di agenti (Microsoft-hosted o self-hosted). Per altre informazioni, vedere Configurare e pagare per i processi paralleli.
• Agenti online : il numero di agenti online in un pool di agenti self-hosted o un pool di agenti del set di scalabilità.
• Processi in coda : numero di processi in coda e in attesa di un agente.
• Esecuzione di processi : numero di processi in esecuzione.

I dati del pool vengono aggregati a una granularità di 10 minuti e il numero di processi in esecuzione viene tracciato in base al numero massimo di processi in esecuzione per l'intervallo di tempo specificato. Poiché più processi a esecuzione breve possono essere completati all'interno della sequenza temporale di 10 minuti, il numero di processi in esecuzione può talvolta essere superiore rispetto alla concorrenza o agli agenti online durante lo stesso periodo.

Ambito del report

Il report sull'utilizzo del pool può essere visualizzato nell'ambito dell'organizzazione o nell'ambito del progetto. A livello di organizzazione, il grafico viene tracciato usando i dati delle pipeline in qualsiasi progetto all'interno dell'organizzazione che hanno eseguito processi in tale pool. A livello di progetto, il grafico viene tracciato usando i dati delle pipeline in quel particolare progetto che hanno eseguito processi in tale pool.

• Per visualizzare il report sull'utilizzo del pool a livello di organizzazione, scegliere Impostazioni organizzazione, Pipeline, pool di agenti.
• Per visualizzare il report sull'utilizzo del pool a livello di progetto, passare al progetto desiderato e scegliere Impostazioni progetto, Pipeline, pool di agenti.

Nella visualizzazione Pool di agenti scegliere il pool desiderato e visualizzare la scheda Analisi . Nell'esempio seguente viene illustrato il report sull'utilizzo del pool per un pool di agenti self-hosted.

In questo esempio vengono illustrati i grafici di utilizzo per il pool di agenti ospitati da Microsoft Azure Pipelines .

Filtro

Per regolare la sequenza temporale del grafico, scegliere Filtra , selezionare l'elenco a discesa intervallo e scegliere l'intervallo desiderato.

Per l'intervallo di 1 giorno, è possibile visualizzare i dati all'ora e per gli altri intervalli che è possibile visualizzare al giorno. I dati del pool vengono aggregati a una granularità di 10 minuti e il numero di processi in esecuzione viene tracciato in base al numero massimo di processi in esecuzione per l'intervallo di tempo specificato. In questo esempio sono presenti due agenti online, ma in alcune aree sono presenti quattro processi in esecuzione a causa della modalità di aggregazione dei dati del pool.

Domande frequenti

Dove viene visualizzato il report sull'utilizzo del pool?

Il report sull'utilizzo del pool usa il servizio Azure DevOps Analytics e l'endpoint TaskAgentRequestSnapshots . È possibile eseguire query su questo endpoint usando il prefisso URL seguente: https://analytics.dev.azure.com/{organization}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots.

È possibile recuperare l'oggetto per il progetto passando all'URL project_id seguente: https://dev.azure.com/{organization}/_apis/projects?api-version=5.0-preview.3.

Nell'esempio seguente viene illustrata una query di esempio e una risposta.

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

Per altre informazioni sulle opzioni di query, vedere Linee guida per query per Analisi con OData.

Nota

L'endpoint TaskAgentRequestSnapshots è in anteprima e non è ancora documentato, ma è possibile visualizzare le informazioni sui dati restituiti passando all'URL dell'endpoint: https://analytics.dev.azure.com/{org}/{project_id}/_odata/v4.0-preview/TaskAgentRequestSnapshots.

Perché sono presenti processi in esecuzione più di quelli che sono presenti agenti o concorrenza?

I dati del pool vengono aggregati a una granularità di 10 minuti e il numero di processi in esecuzione viene tracciato in base al numero massimo di processi in esecuzione per l'intervallo di tempo specificato. Ogni processo in esecuzione viene conteggiato separatamente e, se più processi vengono completati durante l'intervallo di 10 minuti, contribuiscono al numero totale di processi in esecuzione per tale intervallo.

Qual è la differenza tra la visualizzazione dei grafici nelle impostazioni di progetto e nelle impostazioni dell'organizzazione?

L'ambito dei dati nel grafico viene determinato in base al fatto che il grafico sia accessibile tramite le impostazioni del progetto o le impostazioni dell'organizzazione. A livello di organizzazione, il grafico viene tracciato usando i dati delle pipeline in qualsiasi progetto all'interno dell'organizzazione che hanno eseguito processi in tale pool. A livello di progetto, il grafico viene tracciato usando i dati delle pipeline in quel particolare progetto che hanno eseguito processi in tale pool.