Report di riepilogo dei risultati della pipeline
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020
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. I risultati includono Succeeded, Failed, Canceled e Parzialmente riuscito. Per creare report che mostrano i risultati delle esecuzioni della pipeline, eseguire una query su ''PipelineRuns entity set.
Questo articolo fornisce diverse query e istruzioni su come creare un report per ottenere il numero di esecuzioni per risultati della pipeline diversi.
L'immagine seguente mostra un esempio di report di riepilogo dei risultati.
Importante
L'integrazione di Power BI e l'accesso al feed OData del servizio di analisi sono disponibili a livello generale per Azure DevOps Services e Azure DevOps Server 2020 e versioni successive. Le query di esempio fornite in questo articolo sono valide solo per Azure DevOps Server 2020 e versioni successive e dipendono dalla versione v3.0-preview o successiva. È consigliabile usare queste query e fornire commenti e suggerimenti.
Prerequisiti
- Accesso: essere un membro di un progetto con almeno l'accesso Basic .
- Autorizzazioni: per impostazione predefinita, i membri del progetto dispongono dell'autorizzazione per eseguire query su Analisi e creare viste.
- Per altre informazioni sugli altri prerequisiti relativi all'abilitazione di servizi e funzionalità e alle attività generali di rilevamento dei dati, vedere Autorizzazioni e prerequisiti per l'accesso ad Analytics.
Nota
Questo articolo presuppone che sia possibile leggere Panoramica dei report di esempio usando query OData e avere una conoscenza di base di Power BI.
Query di esempio
È possibile usare le query seguenti del set di PipelineRuns entità per creare report di riepilogo dei risultati della pipeline diversi ma simili.
Nota
Per determinare le proprietà disponibili a scopo di filtro o report, vedere Informazioni di riferimento sui metadati per Azure Pipelines. È possibile filtrare le query o restituire proprietà usando uno qualsiasi dei Property valori in un EntityType oggetto o NavigationPropertyBinding Path i valori disponibili con un oggetto EntitySet. Ognuno EntitySet corrisponde a un oggetto EntityType. Per altre informazioni sul tipo di dati di ogni valore, esaminare i metadati forniti per l'oggetto corrispondente EntityType.
Durata della pipeline per una pipeline denominata
Le query seguenti restituiscono le esecuzioni della pipeline per una pipeline specifica da una data di inizio specificata.
Copiare e incollare la query di Power BI seguente direttamente nella finestra Recupera dati>query vuota. Per altre informazioni, vedere Panoramica dei report di esempio che usano query OData.
let
Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
&"$apply=filter( "
&"Pipeline/PipelineName eq '{pipelineName}' "
&"and CompletedDate ge {startdate} "
&") "
&"/aggregate( "
&"$count as TotalCount, "
&"SucceededCount with sum as SucceededCount , "
&"FailedCount with sum as FailedCount, "
&"PartiallySucceededCount with sum as PartiallySucceededCount , "
&"CanceledCount with sum as CanceledCount "
&") "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
Stringhe di sostituzione e scomposizione delle query
Sostituire le stringhe seguenti con i valori. Non includere parentesi quadre {} con la sostituzione. Ad esempio, se il nome dell'organizzazione è "Fabrikam", sostituire {organization} con Fabrikam, non {Fabrikam}.
{organization}- Nome dell'organizzazione{project}- Nome del progetto team{pipelinename}- Nome della pipeline. Esempio:Fabrikam hourly build pipeline{startdate}- Data di inizio del report. Formato: AAAA-MM-GG. Esempio:2021-09-01Zrappresenta il 1° settembre 2021. Non racchiudere tra virgolette o parentesi quadre e usare due cifre per entrambi, mese e data.
Suddivisione delle query
La tabella seguente descrive ogni parte della query.
Parte della query
Descrizione
$apply=filter(
Clausola Start filter() .
Pipeline/PipelineName eq '{pipelinename}'
Restituire le esecuzioni della pipeline per la pipeline specificata.
and CompletedDate ge {startdate}
La pipeline restituita viene eseguita in o dopo la data specificata.
)
Clausola Close filter()
/aggregate(
Clausola Start aggregate per tutte le esecuzioni della pipeline corrispondenti ai criteri di filtro.
$count as TotalCount,
Contare il numero totale di esecuzioni come TotalCount.
SucceededCount with sum as SucceededCount ,
Contare il numero di esecuzioni riuscite come SucceededCount.
FailedCount with sum as FailedCount,
Contare il numero di esecuzioni non riuscite come FailedCount.
PartiallySucceededCount with sum as PartiallySucceededCount ,
Contare il numero di esecuzioni parzialmente riuscite come PartiallySucceededCount.
CanceledCount with sum as CanceledCount
Contare il numero di esecuzioni annullate come CanceledCount.
)
Clausola Close aggregate() .
Riepilogo dei risultati dell'esecuzione della pipeline per un ID della pipeline specifico
È possibile rinominare le pipeline. Per assicurarsi che i report di Power BI non interrompano quando viene modificato un nome di pipeline, usare l'ID della pipeline anziché il nome. È possibile ottenere l'ID della pipeline dall'URL della pagina delle esecuzioni della pipeline.
https://dev.azure.com/{organization}/{project}/_build?definitionId={pipelineid}
Le query seguenti restituiscono le esecuzioni della pipeline per un ID di pipeline specifico e da una data di inizio specificata.
Copiare e incollare la query di Power BI seguente direttamente nella finestra Recupera dati>query vuota. Per altre informazioni, vedere Panoramica dei report di esempio che usano query OData.
let
Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
&"$apply=filter( "
&"PipelineId eq {pipelineId} "
&"and CompletedDate ge {startdate} "
&") "
&"/aggregate( "
&"$count as TotalCount, "
&"SucceededCount with sum as SucceededCount , "
&"FailedCount with sum as FailedCount, "
&"PartiallySucceededCount with sum as PartiallySucceededCount , "
&"CanceledCount with sum as CanceledCount "
&") "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
Riepilogo dei risultati dell'esecuzione della pipeline filtrato per ramo
Per visualizzare il riepilogo dei risultati di una pipeline per un ramo specifico, usare le query seguenti. Per creare il report, seguire questa procedura:
- Espandi
BranchinBranch.BranchName - Modificare il tipo di dati della colonna
- Creare il report grafico ad anello
- Selezionare Filtro dei dati nel riquadro Visualizzazioni e aggiungere al
Branch.BranchNamecampo del filtro dei dati - Selezionare il ramo dal filtro dei dati per il quale è necessario visualizzare il riepilogo dei risultati.
Copiare e incollare la query di Power BI seguente direttamente nella finestra Recupera dati>query vuota. Per altre informazioni, vedere Panoramica dei report di esempio che usano query OData.
let
Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
&"$apply=filter( "
&"Pipeline/PipelineName eq '{pipelinename}' "
&"and CompletedDate ge {startdate} "
&") "
&"/groupby( "
&"(Branch/BranchName), "
&"aggregate( "
&"$count as TotalCount, "
&"SucceededCount with sum as SucceededCount , "
&"FailedCount with sum as FailedCount, "
&"PartiallySucceededCount with sum as PartiallySucceededCount , "
&"CanceledCount with sum as CanceledCount "
&")) "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
Riepilogo dei risultati dell'esecuzione della pipeline filtrato in base al motivo della compilazione
È possibile visualizzare il riepilogo dei risultati di una pipeline solo per motivi di compilazione specifici (Manuale/BatchedCI, Richiesta pull e così via). Per creare il report, seguire questa procedura:
- Modificare il tipo di dati della colonna
- Creare il report grafico ad anello
- Selezionare Filtro dei dati nel riquadro Visualizzazioni e aggiungere al
Pipeline.PipelineNamecampo del filtro dei dati - Selezionare la pipeline dal filtro dei dati per cui è necessario visualizzare il riepilogo dei risultati.
Copiare e incollare la query di Power BI seguente direttamente nella finestra Recupera dati>query vuota. Per altre informazioni, vedere Panoramica dei report di esempio che usano query OData.
let
Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
&"$apply=filter( "
&"Pipeline/PipelineName eq '{pipelinename}' "
&"and CompletedDate ge {startdate} "
&") "
&"/groupby( "
&"(RunReason), "
&"aggregate( "
&"$count as TotalCount, "
&"SucceededCount with sum as SucceededCount , "
&"FailedCount with sum as FailedCount, "
&"PartiallySucceededCount with sum as PartiallySucceededCount , "
&"CanceledCount with sum as CanceledCount "
&")) "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
Riepilogo dei risultati per tutte le pipeline di progetto
È possibile visualizzare il riepilogo dei risultati della pipeline per tutte le pipeline di progetto in un singolo report. Per creare il report, seguire questa procedura:
- Espandi
PipelineinPipeline.PipelineName - Modificare il tipo di dati della colonna
- Creare il report grafico ad anello
- Selezionare Filtro dei dati nel riquadro Visualizzazioni e aggiungere al
Pipeline.PipelineNamecampo del filtro dei dati - Selezionare la pipeline dal filtro dei dati per cui è necessario visualizzare il riepilogo dei risultati.
Per informazioni dettagliate, vedere anche Riepilogo dei risultati per tutti i report di esempio delle pipeline.
Copiare e incollare la query di Power BI seguente direttamente nella finestra Recupera dati>query vuota. Per altre informazioni, vedere Panoramica dei report di esempio che usano query OData.
let
Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
&"$apply=filter( "
&"CompletedDate ge {startdate} "
&") "
&"/groupby( "
&"(Pipeline/PipelineName), "
&"aggregate( "
&"$count as TotalCount, "
&"SucceededCount with sum as SucceededCount , "
&"FailedCount with sum as FailedCount, "
&"PartiallySucceededCount with sum as PartiallySucceededCount , "
&"CanceledCount with sum as CanceledCount "
&")) "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
(Facoltativo) Rinominare la query
È possibile rinominare l'etichetta di query predefinita Query1 in qualcosa di più significativo. È sufficiente immettere un nuovo nome dal riquadro Impostazioni query.
Modificare il tipo di dati della colonna
Nella editor di Power Query selezionare la TotalCount colonna e quindi selezionare Tipo di dati dal menu Trasforma e scegliere Numero intero. Per altre informazioni sulla modifica del tipo di dati, vedere Trasformare i dati di Analisi per generare report di Power BI, Trasformare un tipo di dati di colonna.
(Facoltativo) Rinominare i campi della colonna
È possibile rinominare i campi delle colonne. Ad esempio, è possibile rinominare la colonna Pipeline.PipelineName in Pipeline Nameo TotalCount in Total Count. Per informazioni su come, vedere Rinominare i campi delle colonne.
Chiudere la query e applicare le modifiche
Dopo aver completato tutte le trasformazioni dei dati, scegliere Chiudi e applica dal menu Home per salvare la query e tornare alla scheda Report in Power BI.
Creare il report grafico ad anello
In Power BI, in Visualizzazioni, scegliere il report Ad anello .
Aggiungere i campi seguenti a Valori nell'ordine indicato. Fare clic con il pulsante destro del mouse su ogni campo e verificare che Sum sia selezionato.
CanceledCountPartiallySucceededCount.SucceededCountFailedCount
Per modificare il titolo del report, selezionare l'icona Formatta il pennello visivo nel riquadro Visualizzazioni , selezionare Generale, espandere Titolo e sostituire il testo esistente.
L'immagine seguente mostra il report risultante.