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. È possibile usare 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 ottenere 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 . Analisi 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.
Pipelines Pipeline Proprietà per una pipeline.
PipelineJobs PipelineJob Risultati delle singole esecuzioni per un test specifico associato a un test
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 Datetime Filigrana che indica l'ultima volta che i dati di Analytics sono stati aggiornati.
Nome del 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
Ospitata o self-hosted IsHosted Boolean Indica se la pipeline parallela viene eseguita in un agente ospitato da Microsoft (True) o è self-hosted (False). Per altre informazioni, vedere Agenti di Azure Pipelines.
Impossibile raggiungere tutti i provider FailedToReachAllProviders Boolean 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 Boolean Indica se la pipeline parallela è Premium (True) o meno (False).
Data di esempio SamplingDate Datetime Data associata allo snapshot.

Pipelines

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 spostamento includono Project e il relativo vincolo ProjectSKreferenziale .

Membri del tipo enumerato PipelineProcessType

I membri seguenti sono 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 che vengono eseguiti in sequenza come unità. Un processo è l'unità di lavoro più piccola che è possibile pianificare per l'esecuzione. Le pipeline sono organizzate intorno 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 del processo della pipeline FullJobName string Nome completo di un processo della pipeline.
Pipeline Id PipelineId Int32 ID assegnato alla pipeline in cui è definito il processo.
Identificatore del processo della pipeline JobId string Identificatore di processo assegnato a un processo della pipeline al momento della creazione.
Nome processo pipeline JobName string Nome assegnato al processo della pipeline.
Nome della fase della pipeline StageName string Nome della fase associato al processo della pipeline.
Attributi della strategia del processo della pipeline StrategyAttributes string Attributi definiti per il processo della pipeline.
Identificatore fase StageId string Identificatore di fase associato al processo della pipeline.

Le proprietà di spostamento 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 di errori a livello di 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 della pipeline annullate.
Data completamento CompletedDate Datetime Data e ora in cui la pipeline completa l'esecuzione.
Conteggio non riuscito 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.
ID di esecuzione della pipeline PipelineRunId Int32 Numero assegnato a un'esecuzione della pipeline.
Data accodata QueuedDate Datetime Data e ora in cui la pipeline è stata accodata per l'esecuzione.
Durata coda secondi QueueDurationSeconds Decimal Numero di secondi per cui la pipeline rimane nella coda.
Numero di esecuzione RunNumber string Numero assegnato a un'esecuzione della pipeline durante l'esecuzione.
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 Decimal Numero di secondi impiegato per il completamento dell'esecuzione della pipeline.
Data inizio StartedDate Datetime Data e ora di inizio dell'esecuzione della pipeline.
Numero riuscito SucceededCount Int32 Conteggio delle esecuzioni della pipeline che hanno avuto esito positivo.
Durata totale secondi TotalDurationSeconds Decimal 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 in CompletedOn CompletedDateSK DateSK
In coda QueuedOn QueuedDateSK DateSK
Avviato su StartedOn QueuedDateSK DateSK
Pipeline Pipeline PipelineSK PipelineSK
Project Project ProjectSK ProjectSK

Membri del tipo enumerato PipelineRunReason

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

Nome del membro valore Nome visualizzato
None 0 nessuno
Manual 1 Manuale
IndividualCI 2 Ci individuale
BatchedCI 4 Integrazione continua in batch
Schedule 8 Pianifica
UserCreated 32 Utente creato
ValidateShelveset 64 Convalidare gli 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 nessuno
Succeed 2 Succeed
PartiallySucceeded 4 Eseguito parzialmente
Failed 6 Non riuscito
Canceled 32 Cancellati

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 completamento attività ActivityCompletedDate Datetime Data e ora in cui l'esecuzione della pipeline completa l'esecuzione.
Durata attività secondi ActivityDurationSeconds Decimal Numero totale di secondi in cui la pipeline si trovava nella coda ed è stata eseguita.
Data inizio attività ActivityStartedDate Datetime Data e ora dell'avvio dell'esecuzione della pipeline.
Conteggio annullato CanceledCount Int32 Conteggio delle esecuzioni della pipeline annullate.
Conteggio errori FailedCount Int32 Conteggio delle esecuzioni della pipeline non riuscite.
Tipo di attività 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 durante l'esecuzione.
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 dai secondi del processo RelativeStartTimeFromJobSeconds Int32 Numero di secondi trascorsi dall'inizio del processo.
Tempo di inizio relativo 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 l'esecuzione è stata eseguita.
Conteggio ignorato SkippedCount Int32 Conteggio delle esecuzioni della pipeline ignorate.
Numero riuscito SucceededCount Int32 Conteggio delle esecuzioni della pipeline che hanno avuto esito positivo.
Esito positivo del conteggio dei problemi SucceededWithIssuesCount Int32 Conteggio delle esecuzioni della pipeline che hanno avuto esito positivo parzialmente.
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 Personalizzato 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à pipeline.

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

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

Membri del tipo enumerato PipelineActivityType

Per il PipelineActivityType tipo enumerato vengono definiti i membri seguenti.

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 Datetime Data e ora in cui è stata ritagliata la dimensione 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 Boolean Indica se la compilazione viene accodata (True) o non accodata (False).
Compilazione in esecuzione IsRunning Boolean Indica se la compilazione è in esecuzione (True) o non è in esecuzione (False).
Ospitata o self-hosted IsHosted Boolean Indica se l'agente assegnato all'attività è ospitato (True) o self-hosted (False).
Data fine processo FinishedDate Datetime Data dell'esecuzione della richiesta dell'agente attività.
FinishedDateSK Int32 Data di fine dell'esecuzione dell'agente attività, espressa come YYYYMMDD nel fuso orario definito per l'organizzazione.
Data accodata QueuedDate Datetime Data-ora in cui la richiesta dell'agente attività è stata accodata.
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 Decimal Il numero di secondi di richiesta dell'agente attività rimane 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.
Tempo campionamento SamplingTime Datetime Data-ora in cui è stata ricevuta la richiesta dell'agente attività.
Data iniziale StartedDate Datetime Data 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 spostamento includono quelle elencate nella tabella seguente.

Nome visualizzato Nome Vincolo referenziale -Referenced, proprietà
Ramo Branch BranchSK BranchSK
Completato CompletedOn CompletedDateSK DateSK
Ora di fine processo FinishedOn FinishedDateSK DateSK
Accodato QueuedOn QueuedDateSK DateSK
Pipeline Pipeline PipelineSK PipelineSK
Project Project ProjectSK ProjectSK
Avvio StartedOn QueuedDateSK DateSK