Zusammenfassender Beispielbericht zu Pipelineergebnissen

Artikel
10/16/2024

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

Eine Pipelineausführung stellt eine einzelne Ausführung einer Pipeline dar. Während einer Ausführung wird die Pipeline verarbeitet, und Agents verarbeiten einen oder mehrere Aufträge. Zu den Ergebnissen gehören "Erfolgreich", "Fehlgeschlagen", "Abgebrochen" und "Teilweise erfolgreich". Um Berichte zu erstellen, die die Ergebnisse der Pipelineausführung anzeigen, fragen Sie die PipelineRuns entity set ab.

Dieser Artikel enthält mehrere Abfragen und Anweisungen zum Erstellen eines Berichts, um die Anzahl der Ausführungen für verschiedene Pipelineergebnisse abzurufen.

Die folgende Abbildung zeigt ein Beispiel für einen Ergebniszusammenfassungsbericht.

Screenshot des Zusammenfassenden Berichts

Wichtig

Power BI-Integration und Zugriff auf den OData-Feed des Analytics-Diensts sind in der Regel für Azure DevOps Services und Azure DevOps Server 2020 und höhere Versionen verfügbar. Die in diesem Artikel bereitgestellten Beispielabfragen gelten nur für Azure DevOps Server 2020 und höhere Versionen und hängen von version 3.0-preview oder höher ab. Wir empfehlen Ihnen, diese Abfragen zu verwenden und uns Feedback zu geben.

Voraussetzungen

Access: Mitglied eines Projekts mit mindestens standardem Zugriff sein.
Berechtigungen: Standardmäßig verfügen Projektmitglieder über die Berechtigung zum Abfragen von Analysen und Erstellen von Ansichten.
Weitere Informationen zu anderen Voraussetzungen für die Dienst- und Featureaktivierung sowie allgemeine Datenverfolgungsaktivitäten finden Sie unter Berechtigungen und Voraussetzungen für den Zugriff auf Analytics.

Hinweis

In diesem Artikel wird davon ausgegangen, dass Sie eine Übersicht über Beispielberichte mit OData-Abfragen lesen und ein grundlegendes Verständnis von Power BI haben.

Beispielabfragen

Sie können die folgenden Abfragen des PipelineRuns Entitätssatzes verwenden, um unterschiedliche, aber ähnliche Zusammenfassungsberichte für Pipelineergebnisse zu erstellen.

Hinweis

Informationen zum Ermitteln verfügbarer Eigenschaften für Filter- oder Berichtszwecke finden Sie unter Metadatenreferenz für Azure Pipelines. Sie können Ihre Abfragen filtern oder Eigenschaften zurückgeben, indem Sie einen der Werte unter oder NavigationPropertyBinding PathEntityType verwenden, die Property mit einem EntitySetverfügbar sind. Jede EntitySet entspricht einem EntityType. Weitere Informationen zum Datentyp der einzelnen Werte erhalten Sie in den Metadaten, die für den entsprechenden Wert EntityTypebereitgestellt werden.

Pipelinedauer für eine benannte Pipeline

Die folgenden Abfragen geben die Pipelineausführung für eine bestimmte Pipeline aus einem angegebenen Startdatum zurück.

Power BI-Abfrage
OData-Abfrage

Kopieren Sie die folgende Power BI-Abfrage, und fügen Sie sie direkt in das Fenster "Leere Datenabfrage> abrufen" ein. Weitere Informationen finden Sie unter Übersicht über Beispielberichte mit OData-Abfragen.

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

Sie können den folgenden OData-Abfragecode verwenden, um die Abfrage vor der Verwendung in Power BI zu ändern oder zu testen. Weitere Informationen finden Sie unter Herstellen einer Verbindung mit Power BI- und OData-Abfragen.

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
	)

Ersetzungszeichenfolgen und Abfrageaufschlüsselung

Ersetzen Sie die folgenden Zeichenfolgen durch Ihre Werte. Schließen Sie keine Klammern {} in Ihre Ersetzung ein. Wenn Ihr Organisationsname beispielsweise "Fabrikam" lautet, ersetzen Sie {organization} durch Fabrikam, nicht {Fabrikam}.

{organization} - Name Ihrer Organisation
{project} - Name Ihres Teamprojekts
{pipelinename} - Ihr Pipelinename. Beispiel: Fabrikam hourly build pipeline
{startdate} - Das Datum, an dem Der Bericht beginnt. Format: JJJJ-MM-DDZ. Beispiel: 2021-09-01Z steht für den 1. September 2021. Schließen Sie keine Anführungszeichen oder eckigen Klammern ein, und verwenden Sie zwei Ziffern sowohl für Monat als auch für Datum.

Abfrageaufschlüsselung

In der folgenden Tabelle werden die einzelnen Teile der Abfrage beschrieben.

Abfrageteil

Beschreibung

$apply=filter(

Startklausel filter() .

Pipeline/PipelineName eq '{pipelinename}'

Die Rückgabepipeline wird für die angegebene Pipeline ausgeführt.

and CompletedDate ge {startdate}

Die Rückgabepipeline wird am oder nach dem angegebenen Datum ausgeführt.

)

Close-Klausel filter()

/aggregate(

Startklausel aggregate für alle Pipelineläufe, die den Filterkriterien entsprechen.

$count as TotalCount,

Zählen Sie die Gesamtanzahl der Läufe als TotalCount.

SucceededCount with sum as SucceededCount ,

Zählen Sie die Anzahl der erfolgreichen Ausführungen als SucceededCount.

FailedCount with sum as FailedCount,

Zählen Sie die Anzahl der fehlgeschlagenen Ausführungen als FailedCount.

PartiallySucceededCount with sum as PartiallySucceededCount ,

Zählen Sie die Anzahl der teilweise erfolgreichen Ausführungen als PartiallySucceededCount.

CanceledCount with sum as CanceledCount

Zählen Sie die Anzahl der abgebrochenen Ausführungen als CanceledCount.

)

Close-Klausel aggregate() .

Ergebniszusammenfassung der Pipelineausführung für eine bestimmte Pipeline-ID

Pipelines können umbenannt werden. Um sicherzustellen, dass die Power BI-Berichte nicht unterbrechen, wenn ein Pipelinename geändert wird, verwenden Sie die Pipeline-ID anstelle ihres Namens. Sie können die Pipeline-ID über die URL der Pipelineausführungsseite abrufen.

https://dev.azure.com/{organization}/{project}/_build?definitionId={pipelineid}

Die folgenden Abfragen geben die Pipelineausführung für eine bestimmte Pipeline-ID und von einem angegebenen Startdatum zurück.

Power BI-Abfrage
OData-Abfrage

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

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
)

Ergebniszusammenfassung der Pipelineausführung gefiltert nach Verzweigung

Verwenden Sie die folgenden Abfragen, um die Ergebniszusammenfassung einer Pipeline für eine bestimmte Verzweigung anzuzeigen. Führen Sie die folgenden Schritte aus, um den Bericht zu erstellen:

Erweitern Branch in Branch.BranchName
Ändern des Spaltendatentyps
Erstellen des Donut-Diagrammberichts
Wählen Sie "Datenschnitt " im Bereich "Visualisierungen " aus, und fügen Sie das Branch.BranchName Feld des Datenschnitts hinzu.
Wählen Sie den Verzweigung aus dem Datenschnitt aus, für den Sie die Ergebniszusammenfassung anzeigen müssen.

Power BI-Abfrage
OData-Abfrage

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

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
    ))

Ergebniszusammenfassung der Pipelineausführung gefiltert nach Buildgrund

Möglicherweise möchten Sie die Ergebniszusammenfassung einer Pipeline nur aus bestimmten Buildgründen anzeigen (Manuell/BatchedCI, Pullanforderung usw.). Führen Sie die folgenden Schritte aus, um den Bericht zu erstellen:

Ändern des Spaltendatentyps
Erstellen des Donut-Diagrammberichts
Wählen Sie "Datenschnitt " im Bereich "Visualisierungen " aus, und fügen Sie das Pipeline.PipelineName Feld des Datenschnitts hinzu.
Wählen Sie die Pipeline aus dem Datenschnitt aus, für die Sie die Ergebniszusammenfassung anzeigen müssen.

Power BI-Abfrage
OData-Abfrage

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

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
))

Ergebniszusammenfassung für alle Projektpipelinen

Möglicherweise möchten Sie die Pipelineergebniszusammenfassung für alle Projektpipelinen in einem einzigen Bericht anzeigen. Führen Sie die folgenden Schritte aus, um den Bericht zu erstellen:

Erweitern Pipeline in Pipeline.PipelineName
Ändern des Spaltendatentyps
Erstellen des Donut-Diagrammberichts
Wählen Sie "Datenschnitt " im Bereich "Visualisierungen " aus, und fügen Sie das Pipeline.PipelineName Feld des Datenschnitts hinzu.
Wählen Sie die Pipeline aus dem Datenschnitt aus, für die Sie die Ergebniszusammenfassung anzeigen müssen.

Ausführliche Schritte finden Sie auch in der Ergebniszusammenfassung für alle Pipelines-Beispielbericht .

Power BI-Abfrage
OData-Abfrage

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

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
    ))

(Optional) Abfrage umbenennen

Sie können die Standardabfragebezeichnung Query1 in aussagekräftiger umbenennen. Geben Sie einfach im Bereich Abfrageeinstellungen einen neuen Namen ein.

Screenshot: Menüoptionen für Power BI-Abfragen, Abfrage umbenennen.

Ändern des Spaltendatentyps

Wählen Sie in der Power Query-Editor die TotalCount Spalte aus, und wählen Sie dann "Datentyp" im Menü "Transformieren" und dann "Ganze Zahl" aus. Weitere Informationen zum Ändern des Datentyps finden Sie unter Transform Analytics-Daten zum Generieren von Power BI-Berichten, Transformieren eines Spaltendatentyps.

(Optional) Umbenennen von Spaltenfeldern

Sie können Spaltenfelder umbenennen. Sie können z. B. die Spalte Pipeline.PipelineName Pipeline Namein oder TotalCount in Total Count. Informationen dazu finden Sie unter Umbenennen von Spaltenfeldern.

Schließen Sie die Abfrage, und wenden Sie Ihre Änderungen an.

Nachdem Sie alle Datentransformationen abgeschlossen haben, wählen Sie "Schließen" und "Übernehmen " im Menü "Start " aus, um die Abfrage zu speichern und zur Registerkarte "Bericht " in Power BI zurückzukehren.

Erstellen des Donut-Diagrammberichts

Wählen Sie in Power BI unter "Visualisierungen" den Donut-Bericht aus.
Fügen Sie die folgenden Felder zu "Werte" in der angegebenen Reihenfolge hinzu. Klicken Sie mit der rechten Maustaste auf jedes Feld, und stellen Sie sicher, dass Summe ausgewählt ist.
- CanceledCount
- PartiallySucceededCount.
- SucceededCount
- FailedCount
Wenn Sie den Berichtstitel ändern möchten, wählen Sie im Bereich "Visualisierungen" das Symbol "Formatieren des visuellen Pinsels" aus, wählen Sie "Allgemein" aus, erweitern Sie "Titel", und ersetzen Sie den vorhandenen Text.

Die folgende Abbildung zeigt den resultierenden Bericht.

Freigeben über

Zusammenfassender Beispielbericht zu Pipelineergebnissen

Voraussetzungen

Beispielabfragen

Pipelinedauer für eine benannte Pipeline

Ersetzungszeichenfolgen und Abfrageaufschlüsselung

Abfrageaufschlüsselung

Ergebniszusammenfassung der Pipelineausführung für eine bestimmte Pipeline-ID

Ergebniszusammenfassung der Pipelineausführung gefiltert nach Verzweigung

Ergebniszusammenfassung der Pipelineausführung gefiltert nach Buildgrund

Ergebniszusammenfassung für alle Projektpipelinen

(Optional) Abfrage umbenennen

Ändern des Spaltendatentyps

(Optional) Umbenennen von Spaltenfeldern

Schließen Sie die Abfrage, und wenden Sie Ihre Änderungen an.

Erstellen des Donut-Diagrammberichts

Feedback

Zusätzliche Ressourcen

Freigeben über

Zusammenfassender Beispielbericht zu Pipelineergebnissen

Voraussetzungen

Beispielabfragen

Pipelinedauer für eine benannte Pipeline

Ersetzungszeichenfolgen und Abfrageaufschlüsselung

Abfrageaufschlüsselung

Ergebniszusammenfassung der Pipelineausführung für eine bestimmte Pipeline-ID

Ergebniszusammenfassung der Pipelineausführung gefiltert nach Verzweigung

Ergebniszusammenfassung der Pipelineausführung gefiltert nach Buildgrund

Ergebniszusammenfassung für alle Projektpipelinen

(Optional) Abfrage umbenennen

Ändern des Spaltendatentyps

(Optional) Umbenennen von Spaltenfeldern

Schließen Sie die Abfrage, und wenden Sie Ihre Änderungen an.

Erstellen des Donut-Diagrammberichts

Verwandte Artikel

Feedback

Zusätzliche Ressourcen