Grafico cronologico per i pool di agenti (anteprima)

Servizi di Azure DevOps

Il report sull'utilizzo del pool consente di visualizzare i lavori eseguiti nei pool di agenti, grafici con la concorrenza dei lavori del pool di agenti su un periodo massimo di 30 giorni. È possibile usare queste informazioni per decidere se i processi non sono in esecuzione a causa delle limitazioni di concorrenza. Se hai molti processi in coda o in esecuzione al limite massimo di concorrenza o al limite di agenti online, potresti voler acquistare processi paralleli aggiuntivi o configurare 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, le attività in coda e le attività in esecuzione per i progetti pubblici	Ospitato da Microsoft
Concorrenza in hosting privato	Visualizza la concorrenza dei lavori, i lavori in coda e i lavori in esecuzione per i progetti privati	Ospitati da 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 privata auto-ospitata	Visualizza la concorrenza delle operazioni, le attività in coda e le attività in esecuzione per i progetti self-hosted privati.	Agente del set di scalabilità e auto-ospitato

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 ulteriori informazioni, vedere Configurare e pagare i processi paralleli.
• Agenti online: numero di agenti online in un gruppo di agenti ospitati internamente o in un gruppo di agenti con set di scalabilità.
• Lavori in coda - Il numero di lavori accodati e in attesa di un agente.
• Attività in esecuzione: numero di attività in corso.

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 mappato utilizzando i dati delle pipeline di qualsiasi progetto all'interno dell'organizzazione che ha eseguito dei lavori in quel pool. A livello di progetto, il grafico viene tracciato utilizzando i dati delle pipeline di quel particolare progetto che hanno eseguito job in quel 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 .

Filtri

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 è possibile visualizzarli 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

Da dove provengono i dati visualizzati nel 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 il project_id del 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é ci sono più processi in esecuzione di quanti siano gli agenti o i concorrenti?

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 lavori in quel 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.