Informazioni di riferimento sui metadati per Azure Pipelines Analytics

  • Articolo

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Il servizio Analisi raccoglie le attività di pipeline e test generate tramite Azure Pipelines. Questo articolo descrive le proprietà che è possibile usare per generare un report di Analisi per le pipeline. Si usa una combinazione di proprietà per filtrare una query, aggregare i dati o compilare un report.

Nota

Vengono fornite descrizioni delle entità, delle proprietà e dei tipi enumerati supportati dal modello di dati di Analisi. Si tratta di una bozza anticipata. Inviare commenti e suggerimenti sulle aree in cui si vogliono avere altre informazioni. Per eseguire query sul modello di dati, vedere Costruire query OData per Analytics.

Set di entità e tipi di entità

La tabella seguente riepiloga i tipi di entità e i set di entità che supportano Azure Pipelines. Tutti i tipi di entità/set di entità sono disponibili con la versione di anteprima di Analytics v4.0. Analytics versione 3.0-preview non supporta gli snapshot.

EntitySet EntityType Descrizione
Rami Ramo Informazioni di base sui rami usati nei test o nelle pipeline. Per un report di esempio, vedere Report di esempio sullo stato di avanzamento.
ParallelPipelineJobsSnapshot ParallelPipelineJobsSnapshot (Composito) Supporta la comprensione del consumo di pipeline parallele. Per altre informazioni sui test paralleli della pipeline, vedere Eseguire test in parallelo usando l'attività Test di Visual Studio.
Pipeline Pipeline Proprietà per una pipeline.
PipelineJobs PipelineJob Risultati delle singole esecuzioni per un test specifico associato a un TestRun
PipelineRuns PipelineRun Informazioni sull'esecuzione per le pipeline. Per un report di esempio, vedere Report di esempio di tendenza della frequenza di passaggio della pipeline.
PipelineRunActivityResults PipelineRunActivityResult Log unito di tutte le fasi, passaggi, processi e attività all'interno di una specifica esecuzione della pipeline. Per un report di esempio, vedere Report di esempio sulla durata dell'attività della pipeline.
PipelineTasks PipelineTask Proprietà per le attività usate all'interno di una pipeline.
TaskAgentPoolSizeSnapshots TaskAgentPoolSizeSnapshot (Composito) Supporta la comprensione delle dimensioni del pool, dei processi della pipeline e della concorrenza. Il grafico Cronologico per i pool di agenti illustra come usare questo set di entità.
TaskAgentRequestSnapshots TaskAgentRequestSnapshot (Composito) Supporta la creazione di report sulle richieste dell'agente attività.

Rami

Le proprietà seguenti sono valide per il set di entità Rami . Le chiavi surrogate associate a Branch includono BranchSK e ProjectSK.

Nome visualizzato Nome Tipo di dati Descrizione
AnalyticsUpdatedDate Data/Ora Limite che indica l'ultima volta che i dati di Analisi sono stati aggiornati.
Nome ramo BranchName String Nome assegnato a un ramo al momento della creazione.
Repository Id RepositoryId String Numero assegnato a un repository al momento della creazione.
Repository Vsts Id RepositoryVstsId String Numero assegnato a un repository TFVC al momento della creazione.
RepositoryUrl RepositoryUrl String URL definito per un repository al momento della creazione.

Le proprietà di navigazione includono Project e il relativo vincolo ProjectSKreferenziale .

ParallelPipelineJobsSnapshot

Le proprietà seguenti sono valide per il set di entità ParallelPipelineJobsSnapshot . Le chiavi di riferimento includono:

  • IsHosted
  • ParallelismTag
  • SamplingDate
Nome visualizzato Nome Tipo di dati Descrizione
Hosted o self-hosted IsHosted Booleano Indica se la pipeline parallela viene eseguita in un agente ospitato da Microsoft (True) o se è self-hosted (False). Per altre informazioni, vedere Agenti di Azure Pipelines.
Impossibile raggiungere tutti i provider FailedToReachAllProviders Booleano Indica se l'esecuzione del processo ha raggiunto tutti i provider (True) o meno (False).
Numero di processi di pipeline parallele TotalCount Int32 Numero di processi eseguiti come parte dello snapshot.
Numero di minuti di pipeline parallele TotalMinutes Int32 Numero di minuti impiegato per eseguire lo snapshot.
Tipo parallelismo ParallelismTag String Tag che indica il tipo di parallelismo associato allo snapshot del processo.
Tipo Premium IsPremium Booleano Indica se la pipeline parallela è premium (True) o meno (False).
Data di esempio SamplingDate Data/Ora Data associata allo snapshot.

Pipeline

Le proprietà seguenti sono valide per Pipelines e la relativa chiave PipelineSKsurrogata.

Nome visualizzato Nome Tipo di dati Descrizione
Pipeline Id PipelineId Int32 ID assegnato alla pipeline.
Nome pipeline PipelineName String Nome assegnato alla pipeline.
Versione della pipeline PipelineVersion Int32 Versione associata alla pipeline.
Tipo di processo della pipeline PipelineProcessType Enumerated Tipo di definizione della pipeline. I valori validi sono elencati di seguito per PipelineProcessType.

Le proprietà di navigazione includono Project e il relativo vincolo ProjectSKreferenziale .

Membri dei tipi enumerati PipelineProcessType

I membri seguenti vengono definiti per il PipelineProcessType tipo enumerato che indica il metodo usato per definire la pipeline.

Nome del membro Valore Definizione
Designer 1 Definizione della pipeline classica.
Yaml 2 Definizione della pipeline YAML.
Docker 3 Definizione della pipeline Docker.

PipelineJobs

Un processo della pipeline è una serie di passaggi eseguiti in sequenza come unità. Un processo è l'unità di lavoro più piccola che è possibile pianificare per l'esecuzione. Le pipeline sono organizzate in base ai processi e ogni pipeline ha almeno un processo. Per altre informazioni, vedere Specificare i processi nella pipeline.

Le proprietà seguenti sono valide per PipelineJobs e la relativa PipelineJobSK chiave surrogata.

Nome visualizzato Nome Tipo di dati Descrizione
Nome completo processo pipeline FullJobName String Nome completo di un processo della pipeline.
Pipeline Id PipelineId Int32 ID assegnato alla pipeline in cui è definito il processo.
Identificatore processo pipeline JobId String Identificatore del processo assegnato a un processo della pipeline al momento della creazione.
Nome processo pipeline JobName String Nome assegnato al processo della pipeline.
Nome fase pipeline StageName String Nome della fase associato al processo della pipeline.
Attributi della strategia dei processi della pipeline StrategyAttributes String Attributi definiti per il processo della pipeline.
Identificatore fase StageId String Identificatore della fase associato al processo della pipeline.

Le proprietà di navigazione includono Project e il relativo vincolo ProjectSKreferenziale .

Per un report di esempio che esegue una query sul tipo di entità PipelineJob , vedere Report di esempio sugli errori della fase della pipeline.

PipelineRuns

Un'esecuzione della pipeline rappresenta una singola esecuzione di una pipeline. Durante un'esecuzione, la pipeline viene elaborata e gli agenti elaborano uno o più processi. Un'esecuzione della pipeline include processi, passaggi e attività. Per altre informazioni, vedere Sequenza di esecuzione della pipeline.

Le proprietà seguenti sono valide per il tipo di entità PipelineRun e la relativa PipelineRunSK chiave surrogata.

Nome visualizzato Nome Tipo di dati Descrizione
Conteggio annullato CanceledCount Int32 Numero di esecuzioni di pipeline annullate.
Data di completamento CompletedDate Data/Ora Data e ora di completamento dell'esecuzione della pipeline.
Conteggio errori FailedCount Int32 Numero di esecuzioni della pipeline riuscite.
Revisione numero RunNumberRevision Int32 Numero assegnato a un'esecuzione della pipeline con esecuzioni sequenziali.
Conteggio parzialmente riuscito PartiallySucceededCount Int32 Numero di esecuzioni della pipeline che hanno avuto esito positivo parziale.
ID esecuzione pipeline PipelineRunId Int32 Numero assegnato a un'esecuzione della pipeline.
Data coda QueuedDate Data/Ora Data e ora in cui la pipeline è stata accodata per l'esecuzione.
Durata coda secondi QueueDurationSeconds Decimale Numero di secondi in cui la pipeline è rimasta nella coda.
Numero di esecuzione RunNumber String Numero assegnato a un'esecuzione della pipeline quando viene eseguito.
Risultato esecuzione RunOutcome Enumerated Risultato assegnato a una pipeline al termine dell'esecuzione. I valori validi sono elencati di seguito per PipelineRunOutcome.
Motivo esecuzione RunReason Enumerated Condizione che ha causato l'esecuzione della pipeline. I valori validi sono elencati di seguito per PipelineRunReason.
Durata esecuzione secondi RunDurationSeconds Decimale Numero di secondi impiegato per il completamento dell'esecuzione della pipeline.
Data inizio StartedDate Data/Ora Data e ora di inizio dell'esecuzione della pipeline.
Conteggio riuscito SucceededCount Int32 Numero di esecuzioni della pipeline riuscite.
Durata totale secondi TotalDurationSeconds Decimale Numero totale di secondi in cui la pipeline si trovava nella coda ed è stata eseguita.

Sono supportate le proprietà di navigazione seguenti.

Nome visualizzato Nome -Vincolo referenziale Proprietà di riferimento
Ramo Branch BranchSK BranchSK
Completato attivato CompletedOn CompletedDateSK DateSK
In coda QueuedOn QueuedDateSK DateSK
Attività iniziali StartedOn QueuedDateSK DateSK
Pipeline Pipeline PipelineSK PipelineSK
Progetto Project ProjectSK ProjectSK

Membri dei tipi enumerati PipelineRunReason

I membri seguenti vengono definiti per il PipelineRunReason tipo enumerato che indica le condizioni in cui viene eseguita ogni fase, processo o passaggio della pipeline, come descritto in Specificare le condizioni.

Nome del membro valore Nome visualizzato
None 0 None
Manual 1 Manuale
IndividualCI 2 Integrazione continua singola
BatchedCI 4 Integrazione continua in batch
Schedule 8 Programmazione
UserCreated 32 Utente creato
ValidateShelveset 64 Convalidare l'insieme di scaffali
CheckInShelveset 128 Check In Shelveset
PullRequest 256 Richiesta pull
PipelineRunCompletion 512 Completamento compilazione

Membri dei tipi enumerati PipelineRunOutcome

I membri seguenti sono definiti per il PipelineRunOutcome tipo enumerato che indica il risultato di un'esecuzione della pipeline.

Nome del membro valore Nome visualizzato
None 0 None
Succeed 2 Succeed
PartiallySucceeded 4 Parzialmente riuscito
Failed 6 Non riuscito
Canceled 32 Annullati

PipelineRunActivityResults

Le proprietà seguenti sono valide per il set di entità PipelineRunActivityResults e la relativa PipelineRunActivityResultSK chiave surrogata.

Molte proprietà sono basate su data o basate sull'utente. Queste proprietà sono associate ai set di entità CalendarDate e User descritti in Riferimento ai metadati calendar, Project e User.

Nome visualizzato Nome Tipo di dati Descrizione
Conteggio abbandonato AbandonedCount Int32 Numero di esecuzioni di pipeline contrassegnate come abbandonate.
Data di completamento attività ActivityCompletedDate Data/Ora Data e ora in cui l'esecuzione della pipeline completa l'esecuzione.
Durata attività secondi ActivityDurationSeconds Decimale Numero totale di secondi in cui la pipeline si trovava nella coda ed è stata eseguita.
Data inizio attività ActivityStartedDate Data/Ora Data/ora di avvio dell'esecuzione della pipeline.
Conteggio annullato CanceledCount Int32 Numero di esecuzioni di pipeline annullate.
Conteggio errori FailedCount Int32 Numero di esecuzioni della pipeline non riuscite.
Tipo di attività della pipeline ActivityType Enumerated Tipo di attività della pipeline. I valori validi sono elencati di seguito per PipelineActivityType.
ID esecuzione pipeline PipelineRunId Int32 Numero assegnato a un'esecuzione della pipeline quando viene eseguito.
Risultato dell'esecuzione della pipeline PipelineRunOutcome Enumerated Risultato assegnato a una pipeline al termine dell'esecuzione. I valori validi sono elencati in PipelineRunOutcome.
Ora di inizio relativa da secondi di processo RelativeStartTimeFromJobSeconds Int32 Numero di secondi trascorsi dall'inizio del processo.
Ora di inizio relativa dai secondi di fase RelativeStartTimeFromStageSeconds Int32 Numero di secondi trascorsi dall'inizio della fase.
Ora di inizio relativa da secondi di esecuzione RelativeStartTimeFromRunSeconds Int32 Numero di secondi trascorsi da quando viene eseguita l'esecuzione.
Conteggio ignorato SkippedCount Int32 Numero di esecuzioni della pipeline ignorate.
Conteggio riuscito SucceededCount Int32 Numero di esecuzioni della pipeline riuscite.
Esito positivo con il conteggio dei problemi SucceededWithIssuesCount Int32 Numero di esecuzioni della pipeline che hanno avuto esito positivo parziale.
Nome visualizzato attività TaskDisplayName String Nome di un'attività eseguita nell'esecuzione della pipeline.
Percorso log attività TaskLogPath String Percorso del file di log generato da un'attività.
Risultato attività TaskOutcome Personalizzazione Risultato dell'attività eseguita.

Per i report di esempio che eseguono query sul tipo di entità PipelineRunActivityResult , vedere Report di esempio di tendenza della durata dell'attività della pipeline.

Le proprietà di navigazione includono quelle elencate nella tabella seguente.

Nome visualizzato Nome Vincolo referenziale Proprietà di riferimento
Attività avviata ActivityStartedOn ActivityStartedDateSK DateSK
Ramo Branch BranchSK BranchSK
Pipeline Pipeline PipelineSK PipelineSK
Attività pipeline PipelineTask PipelineTaskSK PipelineTaskSK
Processo della pipeline PipelineJob PipelineJobSK PipelineJobSK
Esecuzione della pipeline in coda PipelineRunQueuedOn PipelineRunQueuedDateSK DateSK
Esecuzione della pipeline avviata PipelineRunStartedOn PipelineRunStartedDateSK DateSK
Esecuzione della pipeline completata PipelineRunCompletedOn PipelineRunCompletedDateSK DateSK
Esecuzione della pipeline avviata PipelineRunStartedOn PipelineRunStartedDateSK DateSK
Progetto Project ProjectSK ProjectSK

Membri del tipo enumerato PipelineActivityType

I membri seguenti sono definiti per il PipelineActivityType tipo enumerato.

Nome del membro valore Nome visualizzato
Task 0 Attività
Approval 1 Approvazione
AgentWait 2 Attesa agente

PipelineTasks

Le proprietà seguenti sono valide per il set di entità PipelineTasks e la relativa chiave PipelineTaskSKsurrogata.

Nome visualizzato Nome Tipo di dati Descrizione
ID definizione attività TaskDefinitionId GUID GUID assegnato a un'attività della pipeline.
Versione definizione attività TaskDefinitionVersion String Versione assegnata a un'attività della pipeline.

Le proprietà di navigazione includono Project e il relativo vincolo ProjectSKreferenziale .

TaskAgentPoolSizeSnapshots

Le proprietà seguenti sono valide per il set di entità TaskAgentPoolSizeSnapshots e la relativa chiave SamplingDatesurrogata.

Nome visualizzato Nome proprietà Tipo di dati Descrizione
Conteggio online OnlineCount Int32 Numero di agenti online nel pool di agenti durante l'esecuzione dell'attività.
Conteggio offline OfflineCount Int32 Numero di agenti offline nel pool di agenti durante l'esecuzione dell'attività.
Pool Id PoolId Int32 Numero assegnato al pool di agenti.
Data di esempio SamplingDate Data/Ora Data e ora in cui sono state ritagliate le dimensioni del pool.

Per un report di esempio compilato dall'entità TaskAgentPoolSizeSnapshot, vedere Grafico cronologico per i pool di agenti (anteprima).

TaskAgentRequestSnapshots

I pool di agenti vengono allocati quando viene eseguita un'attività. Il set di entità TaskAgentRequestSnapshots acquisisce i dati correlati alle richieste dell'agente attività.

Le proprietà seguenti sono valide per il tipo di entità TaskAgentRequestSnapshot e le relative chiavi SamplingTime surrogate e SamplingDateSK.

Nome visualizzato Nome Tipo di dati Descrizione
Compilazione in coda IsQueued Booleano Indica se la compilazione viene accodata (True) o non accodata (False).
Compilazione in esecuzione IsRunning Booleano Indica se la compilazione è in esecuzione (True) o non è in esecuzione (False).
Hosted o self-hosted IsHosted Booleano Indica se l'agente assegnato all'attività è ospitato (True) o self-hosted (False).
Data fine processo FinishedDate Data/Ora Data e ora di fine dell'esecuzione della richiesta dell'agente attività.
FinishedDateSK Int32 Data di fine dell'esecuzione della richiesta dell'agente attività, espressa come YYYYMMDD nel fuso orario definito per l'organizzazione.
Data coda QueuedDate Data/Ora Data e ora in cui è stata accodata la richiesta dell'agente attività.
QueuedDateSK Int32 Data in cui la richiesta dell'agente attività è stata accodata, espressa come YYYYMMDD nel fuso orario definito per l'organizzazione.
Durata coda secondi QueueDurationSeconds Decimale Numero di secondi di attesa della richiesta dell'agente attività nella coda prima dell'assegnazione di un agente.
Pool Id PoolId Int32 Numero assegnato al pool di agenti assegnato alla richiesta dell'agente attività.
Tipo di pipeline PipelineType String Tipo di pipeline contenente la richiesta dell'agente attività.
ID richiesta RequestId Int64 Numero assegnato alla richiesta dell'agente attività.
Ora di esempio SamplingHour Int32 Numero assegnato all'ora in cui è stata ricevuta la richiesta.
Ora di esempio SamplingTime Data/Ora Data/ora in cui è stata ricevuta la richiesta dell'agente attività.
Data inizio StartedDate Data/Ora Data e ora di esecuzione della richiesta dell'agente attività.
StartedDateSK Int32 Data di inizio dell'esecuzione della richiesta dell'agente attività, espressa come YYYYMMDD nel fuso orario definito per l'organizzazione.

Le proprietà di navigazione includono quelle elencate nella tabella seguente.

Nome visualizzato Nome Vincolo referenziale -Referenced property
Ramo Branch BranchSK BranchSK
Completato attivato CompletedOn CompletedDateSK DateSK
Ora di fine processo FinishedOn FinishedDateSK DateSK
In coda QueuedOn QueuedDateSK DateSK
Pipeline Pipeline PipelineSK PipelineSK
Progetto Project ProjectSK ProjectSK
Attività iniziali StartedOn QueuedDateSK DateSK