Condividi tramite

Report di riepilogo dei risultati della pipeline

  • Articolo

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

Un'esecuzione della pipeline rappresenta una singola esecuzione di una pipeline. Durante l'esecuzione di una pipeline, la pipeline viene elaborata e gli agenti gestiscono una o più attività. I risultati includono Riuscito, Non riuscito, Annullato 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 dei vari risultati della pipeline.

L'immagine seguente mostra un esempio di report di riepilogo dei risultati.

Screenshot del rapporto riepilogativo dei risultati delle pipeline di Power BI.

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.

Categoria Requisiti
Livelli di accesso - membro del progetto.
- Accesso di base almeno.
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 abbiate letto Panoramica dei report di esempio usando query OData e abbiate una conoscenza di base di Power BI.

Esempi di query

È possibile usare le query seguenti del set di entità PipelineRuns per creare diversi report di riepilogo dei risultati della pipeline 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 le proprietà utilizzando uno qualsiasi dei valori Property sotto EntityType oppure i valori NavigationPropertyBinding Path disponibili con 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 specifica

Le query seguenti restituiscono le esecuzioni di una pipeline specifica a partire da una data di inizio prestabilita.

Copiare e incollare la seguente query di Power BI direttamente nella finestra Recupera dati della 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 analisi delle query

Sostituire le stringhe seguenti con i valori. Non includere parentesi {} con la tua sostituzione. Ad esempio, se il nome dell'organizzazione è "Fabrikam", sostituire {organization} con Fabrikam, non {Fabrikam}.

  • {organization} - Nome dell'organizzazione
  • {project} - Nome del progetto del team
  • {pipelinename} - Nome della pipeline. Esempio: Fabrikam hourly build pipeline
  • {startdate} - Data di inizio del tuo report. Formato: AAAA-MM-GG. Esempio: 2021-09-01Z rappresenta il 1° settembre 2021. Non racchiudere tra virgolette o parentesi quadre e usa due cifre sia per il mese che per la data.

Suddivisione delle query

La tabella seguente descrive ogni parte della query.

Parte della query

Descrizione

$apply=filter(

Inizio filter() clausola.

Pipeline/PipelineName eq '{pipelinename}'

Restituisci le esecuzioni della pipeline per la pipeline indicata.

and CompletedDate ge {startdate}

La pipeline restituita viene eseguita in o dopo la data specificata.

)

Chiudi la clausola filter()

/aggregate(

Clausola Start aggregate per tutte le esecuzioni della pipeline corrispondenti ai criteri di filtro.

$count as TotalCount,

Contare il numero totale delle corse 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 ,

Conta il numero di esecuzioni parzialmente riuscite come il valore PartiallySucceededCount.

CanceledCount with sum as CanceledCount

Contare il numero di esecuzioni annullate come CanceledCount.

)

Chiudi la clausola aggregate().

Riepilogo dei risultati dell'esecuzione della pipeline per uno specifico ID della pipeline

Le pipeline possono essere rinominate. 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 a partire da una data di inizio definita.

Copia e incolla la seguente query di Power BI 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:

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 specifici Motivi di Build (Manuale/BatchedCI, Richiesta pull e così via). Per creare il report, seguire questa procedura:

Copiare e incollare la seguente query di Power BI 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:

Per informazioni dettagliate, vedere anche il riepilogo dei risultati per tutte le pipeline nel report di esempio.

Copia e incolla la seguente query di Power BI 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.

Screenshot delle opzioni del menu query di Power BI, rinominare la 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.

Screenshot dell'opzione Chiudi e applica nell'editor di Power Query.

Creare il report grafico ad anello

  1. In Power BI, in Visualizzazioni, scegliere il grafico a ciambella.

    Screenshot delle selezioni dei campi di visualizzazione per tutti i report di esecuzione della pipeline.

  2. 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.

    • CanceledCount
    • PartiallySucceededCount.
    • SucceededCount
    • FailedCount

  3. Per modificare il titolo del report, selezionare l'icona a forma di pennello nel riquadro Visualizzazioni, selezionare Generale, espandere Titolo e sostituire il testo esistente.

    Screenshot del Pannello delle Visualizzazioni, opzioni di formato del report, modificare il titolo.

    L'immagine seguente mostra il report risultante.

    Screenshot del report di esempio riepilogo risultati pipeline di Power BI.