Zusammenfassung der Pipelineergebnisse für alle Pipeline-Beispielberichte
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020
Sie können die in diesem Artikel bereitgestellten Informationen verwenden, um Pipelinemetriken abzufragen – z. B. Passrate, Anzahl der Fehler, Dauer usw. für alle Pipelines und erstellen einen einzelnen Bericht. Zusätzliche Abfragen werden bereitgestellt, um andere Metriken abzurufen, z. B. Die Pipelinedauer und die Anzahl der Fehler für alle Projektpipelinen.
Die folgende Abbildung zeigt die Ergebniszusammenfassung für alle Pipelines, die seit September 2022 für ein Projekt definiert sind.
Wie in der folgenden Abbildung dargestellt, können Sie eine beliebige Pipeline im Dropdownmenü "Pipelinename " auswählen, und der Bericht ändert sich, um sich auf die Ergebniszusammenfassung für die ausgewählte Pipeline zu konzentrieren.
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.
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( "
&"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
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{startdate}- Das Datum, an dem Der Bericht beginnt. Format: JJJJ-MM-DDZ. Beispiel: 2022-09-01Z steht für den 1. September 2022. 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() .
CompletedDate ge {startdate}
Die Rückgabepipeline wird für das Datum ausgeführt, das größer als das angegebene Datum ist.
)
Close-Klausel filter() .
/groupby(
Startklausel groupby() /
(Pipeline/PipelineName),
Gruppieren Von Datenergebnissen nach Pipelinename.
aggregate(
Startklausel aggregate für jede Pipeline.
$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.
))
Schließen aggregate() und groupby() Klauseln.
(Optional) Abfrage umbenennen
Sie können die Standardabfragebezeichnung Query1 in aussagekräftiger umbenennen. Geben Sie einfach im Bereich Abfrageeinstellungen einen neuen Namen ein.
Erweitern der Pipelinespalte in Power Query-Editor
Erweitern Sie vor dem Erstellen des Berichts die Spalte, die Pipeline Datensätze zurückgibt, die ein oder mehrere Felder enthalten können.
Schließen Sie die Erweiterter Editor.
Wählen Sie im Power Query-Editor die Schaltfläche zum Erweitern der
PipelineSpalte aus, stellen Sie sicher, dassPipelineNamesie ausgewählt ist, und wählen Sie dann "OK" aus.
Die Tabelle enthält nun die erweiterte Entität
Pipeline.PipelineName.
Ä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 Berichts "Gestapelte Säulendiagramme"
Wählen Sie in Power BI unter "Visualisierungen" den Bericht "Gestapelte Säulendiagramme" aus.
Fügen Sie der Achse die umbenannte Spalte
Pipeline Namehinzu oder fügen SiePipeline.PipelineNamesie hinzu.Fügen Sie die folgenden Felder zu "Werte " in der angegebenen Reihenfolge hinzu, und klicken Sie mit der rechten Maustaste auf jedes Feld, und stellen Sie sicher, dass Summe ausgewählt ist.
SucceededCountFailedCountCanceledCountPartiallySucceededCount.
Wenn Sie dem Bericht einen Datenschnitt hinzufügen möchten, deaktivieren Sie den Bericht, und wählen Sie "Datenschnitt " im Bereich "Visualisierungen " aus.
Fügen Sie die umbenannte Spalte
Pipeline Namezu Field hinzu oder fügen SiePipeline.PipelineNamesie hinzu.
Wenn Sie den Datenschnitt aus einer Liste in eine Dropdownmenüoption ändern möchten, wählen Sie im Bereich "Visualisierungen" das Symbol "Visueller Pinsel formatieren" aus, und wählen Sie die Dropdownoption anstelle von "Liste" aus.
Der Bericht wird wie folgt angezeigt.