Freigeben über

Beispielbericht zu Pipelinephasenfehlern

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

In diesem Artikel erfahren Sie, wie Sie einen Bericht über die täglichen Phasenfehler einer Pipeline erstellen. Dieser Bericht ähnelt dem Fehlertrenddiagramm des Pipelinedurchlaufrateberichts.

Die folgende Abbildung zeigt ein Beispiel für einen Phasenfehlerbericht für eine bestimmte Pipeline.

Screenshot von Power BI Pipelines stufenweise Fehler gestapelte Säulendarstellung.

Hinweis

Für die Beispielabfragen in diesem Artikel ist v3.0-Preview oder höher des Analytics OData-Feeds erforderlich. Teilen Sie Ihr Feedback.

Kategorie Anforderungen
Zugriffsebenen - Projektmitglied.
– Mindestens einfacher Zugriff.
Erlaubnisse 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 Overview von Beispielberichten mithilfe von OData-Abfragen lesen und ein grundlegendes Verständnis von Power BI haben.

Beispielabfragen

Sie können Trendberichte zu Phasen-, Aufgaben- oder Auftragsfehlern erstellen, indem Sie den Entitätssatz PipelineRunActivityResults abfragen.

Hinweis

Informationen zum Suchen verfügbarer Eigenschaften zum Filtern oder Melden finden Sie in der Metadata-Referenz für Azure Pipelines. Sie können Abfragen filtern oder Eigenschaften zurückgeben, indem Sie einen beliebigen Property Wert verwenden, der unter einem EntityTypeoder einem beliebigen NavigationPropertyBinding Path für ein EntitySetObjekt aufgeführten Wert definiert ist. Jede EntitySet entspricht einem EntityType, der den Datentyp für jede Eigenschaft dokumentiert.

Phasenfehlertrend

Verwenden Sie die folgenden Abfragen, um den Phasenfehlertrend für eine bestimmte Pipeline aus einem angegebenen Datum anzuzeigen.

Kopieren Sie die folgende Power BI Abfrage direkt in das Fenster Get Data>Blank Query. 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/PipelineRunActivityResults?"
        &"$apply=filter( "
                &"Pipeline/PipelineName eq '{pipelinename}' "
                &"and PipelineRunCompletedOn/Date ge {startdate} "
                &"and PipelineRunOutcome eq 'Failed' "
        &"and TaskOutcome eq 'Failed' "
        &") "
            &"/groupby( "
                &"(PipelineRunCompletedOn/Date, PipelineRunId, PipelineJob/StageName ), "
                &"aggregate (FailedCount with sum as FailedCount)) "
            &"/groupby( "
                &"(PipelineRunCompletedOn/Date, PipelineJob/StageName ), "
            &"aggregate "
        &"(cast(FailedCount gt 0, Edm.Int32) with sum as FailedStageCount)) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Ersetzungszeichenfolgen und Abfrageaufschlüsselung

Ersetzen Sie die folgenden Zeichenfolgen durch Ihre Werte. Lassen Sie die geschweiften Klammern {} bei Ihrer Ersetzung weg. Wenn Ihr Organisationsname z. B. "Fabrikam" lautet, ersetzen Sie {organization} durch Fabrikam, nicht durch {Fabrikam}.

  • {organization} - Name Ihrer Organisation
  • {project} - Name Ihres Teamprojekts
  • {pipelinename} - Ihr Pipeline-Name. Beispiel: Fabrikam hourly build pipeline
  • {startdate} - Das Datum, an dem Ihr Bericht beginnt. Format: YYYY-MM-DD gefolgt von Z (UTC-Indikator). Beispiel: 2026-09-01Z steht für den 1. September 2026. Schließen Sie keine Anführungszeichen oder Klammern ein.

Abfrageaufschlüsselung

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

Abfrageteil

Beschreibung

$apply=filter(

Startklausel filter() .

Pipeline/PipelineName eq '{pipelinename}'

Zurückgeben von Vorgangsergebnissen für eine bestimmte Pipeline.

and PipelineRunCompletedOn/Date ge {startdate}

Zurückgeben von Vorgangsergebnissen für Pipelineausführungen am oder nach dem angegebenen Datum.

and PipelineRunOutcome eq 'Failed'

Zurückgeben von Vorgangsergebnissen, bei denen das Buildergebnis fehlgeschlagen ist.

and TaskOutcome eq 'Failed'

Gibt Vorgangsergebnisse zurück, bei denen das Ergebnis des Vorgangs fehlgeschlagen ist.

)

Die filter-Klausel schließen.

/groupby(

Startklausel groupby() .

(PipelineRunCompletedOn/Date, PipelineRunId, PipelineJob/StageName ),

Gruppieren nach Datum des Abschlusses der Pipelineausführung, Pipelineausführungs-ID und Phasenname.

aggregate (FailedCount with sum as FailedCount))

Zählen Sie für jeden Tag, jede Pipelineausführungs-ID und jede Phase die Gesamtzahl der Fehler. Dieser Wert stellt die Gesamtanzahl der Vorgangsfehler dar, keine Phasenfehler.

/groupby(

Startklausel groupby() .

(PipelineRunCompletedOn/Date, PipelineJob/StageName ),

Nach Tag und Phasenname gruppieren.

aggregate

Startklausel aggregate .

(cast(FailedCount gt 0, Edm.Int32) with sum as FailedStageCount))

Summieren Sie für jeden Tag die Häufigkeit, mit der eine Phase fehlgeschlagen ist, und schließen Sie dann die aggregate Klausel.

Aufgabenfehlertrend

Verwenden Sie die folgenden Abfragen, um den Vorgangsfehlertrend anzuzeigen.

Kopieren Sie die folgende Power BI Abfrage direkt in das Fenster Get Data>Blank Query. 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/PipelineRunActivityResults?"
        &"$apply=filter( "
                &"Pipeline/PipelineName eq '{pipelinename}' "
                &"and PipelineRunCompletedOn/Date ge {startdate} "
                &"and PipelineRunOutcome eq 'Failed' "
        &"and TaskOutcome eq 'Failed' "
        &") "
            &"/groupby( "
                &"(PipelineRunCompletedOn/Date, TaskDisplayName), "
                &"aggregate "
            &"(FailedCount with sum as FailedCount)) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Auftragsfehlertrend

Verwenden Sie die folgenden Abfragen, um den Trend der Auftragsfehler zu sehen.

Kopieren Sie die folgende Power BI Abfrage direkt in das Fenster Get Data>Blank Query. 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/PipelineRunActivityResults?"
        &"$apply=filter( "
                &"Pipeline/PipelineName eq '{pipelinename}' "
                &"and PipelineRunCompletedOn/Date ge {startdate} "
                &"and PipelineRunOutcome eq 'Failed' "
        &"and TaskOutcome eq 'Failed' "
        &") "
            &"/groupby( "
                &"(PipelineRunCompletedOn/Date, PipelineRunId, PipelineJob/JobName ), "
                &"aggregate (FailedCount with sum as FailedCount)) "
            &"/groupby( "
                &"(PipelineRunCompletedOn/Date, PipelineJob/JobName ), "
            &"aggregate "
        &"(cast(FailedCount gt 0, Edm.Int32) with sum as FailedJobCount)) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

(Optional) Abfrage umbenennen

Sie können das Standardabfrage-Label Query1 in einen aussagekräftigeren Namen umbenennen. Geben Sie im Bereich "Abfrageeinstellungen " einen neuen Namen ein.

Screenshot der Optionen des Power BI-Abfragemenüs; Abfrage umbenennen.

Erweitern von Spalten in Power Query Editor

Erweitern Sie vor dem Erstellen des Berichts die folgenden beiden Spalten. Weitere Informationen zum Erweitern von Arbeitsaufgaben finden Sie unter Transform Analytics-Daten, um Power BI Berichte zu generieren.

  • Erweitern PipelineJob bis PipelineJob.StageName
  • Erweitern PipelineRunCompletedOn bis PipelineRunCompletedOn.Date

Ändern des Spaltendatentyps

Ändern Sie im Menü "Transformieren " den Datentyp für die FailedStageCount Spalte in "Ganze Zahl". Informationen dazu finden Sie unter Transformieren eines Spaltendatentyps.

(Optional) Umbenennen von Spaltenfeldern

Sie können Spaltenfelder umbenennen, um benutzerfreundlicher zu werden. Informationen dazu finden Sie unter Umbenennen von Spaltenfeldern.

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

Wenn Sie alle Datentransformationen abgeschlossen haben, wählen Sie Schließen & Übernehmen im Start-Menü aus. Diese Aktion speichert die Abfrage und gibt Sie in Power BI zur Registerkarte Report zurück.

Screenshot Power Query Editor Option schließen und anwenden.

Erstellen des Diagrammberichts "Gestapelte Säulen"

  1. Wählen Sie in Power BI unter Visualizations den Bericht Stacked-Säulendiagramm aus. Im folgenden Beispiel wird davon ausgegangen, dass Sie keine Spalten umbenannt haben.

    Screenshot der Auswahl von Visualisierungsfeldern für einen Bericht zum gestapelten Säulendiagramm bei phasenweisen Fehlern.

  2. Fügen Sie PipelineRunCompletedOn.Date zur X-Achse hinzu, klicken Sie mit der rechten Maustaste darauf und wählen Sie PipelineRunCompletedOn.Date anstelle der Datumshierarchie aus.

  3. Fügen Sie FailedStageCount der Y-Achse hinzu, klicken Sie mit der rechten Maustaste darauf, und stellen Sie sicher, dass Summe ausgewählt ist.

  4. PipelineJob.StageName zum Legende hinzufügen.

  5. Wenn Sie den Berichtstitel, die Legende oder andere visuelle Berichtselemente ändern möchten, wählen Sie im Bereich "Visualisierungen" das Symbol "Visueller Pinsel formatieren" aus, und passen Sie eine oder mehrere Einstellungen an.

Ihr Bericht sollte ähnlich wie in der folgenden Abbildung aussehen.

Screenshot eines gestapelten Spaltenberichts zu stufenweisen Fehlern im Power BI Pipelines-Beispiel.

  • Last updated on