Informazioni di riferimento sui metadati per Azure Pipelines Analytics
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:
IsHostedParallelismTagSamplingDate
| 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. |
Proprietà di navigazione
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.
Proprietà di navigazione
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 |