Grafico cronologico per i pool di agenti (anteprima)

Servizi di Azure DevOps

Il report sull'utilizzo del pool consente di visualizzare i processi in esecuzione nei pool di agenti con concorrenza dei processi 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 più agenti self-hosted.

Prerequisiti

Importante

È necessario essere membri del gruppo Project Collection Administrators per visualizzare i report sull'utilizzo del pool per i pool di agenti in un'organizzazione, inclusi i report a livello di progetto nell'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 la concorrenza, i processi in coda e i processi in esecuzione per i progetti pubblici	Ospitati su Microsoft
Concorrenza ospitata privata	Visualizza la concorrenza, i processi in coda e i processi in esecuzione per i progetti privati	Ospitati su Microsoft
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 la concorrenza, i processi in coda e i processi in esecuzione per i progetti self-hosted privati	Agente del set di scalabilità e self-hosted

I grafici nel report sull'utilizzo del pool rappresentano i punti dati seguenti:

• Concorrenza: numero di processi paralleli nell'organizzazione applicabili al tipo di progetto (pubblico o privato) e al tipo di pool di agenti (ospitato da Microsoft o self-hosted). Per altre informazioni, vedere Pagare i processi paralleli e configurarli.
• Agenti online: numero di agenti online in un pool di agenti self-hosted o in un pool di agenti del set di scalabilità.
• Processi in coda: numero di processi accodati e in attesa di un agente.
• Processi in esecuzione: numero di processi in esecuzione.

I dati del pool vengono aggregati con 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 con esecuzione breve possono essere completati entro la 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. L'esempio seguente mostra il report sull'utilizzo del pool per un pool di agenti self-hosted.

Questo esempio mostra i grafici di utilizzo per il pool di agenti ospitati da Microsoft In Azure Pipelines .

Filtro

Per regolare la sequenza temporale del grafico, scegliere Filtro , 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 con 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 vengono visualizzati i dati visualizzati dal report sull'utilizzo del pool?

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

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

L'esempio seguente mostra una query e una risposta di esempio.

{
"@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 le query per Analisi con OData.

Nota

L'endpoint TaskAgentRequestSnapshots è in anteprima e non è ancora documentato, ma è possibile visualizzare 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 quanto ci siano agenti o concorrenza?

I dati del pool vengono aggregati con 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 conteggio totale dei processi in esecuzione per tale intervallo.

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

L'ambito dei dati nel grafico viene determinato in base all'accesso al grafico tramite le impostazioni di Project o Organization. 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.