Beispielbericht zu Fehlertrends

Artikel
10/16/2024

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

Fehlertrendberichte sind hilfreich, um zu sehen, wie gut ein Team aktive Fehler schließt. In diesem Artikel wird gezeigt, wie Die Anzahl der Fehler in einem bestimmten Zustand über einen bestimmten Zeitraum angezeigt wird. Die folgende Abbildung zeigt ein Beispiel für einen Fehlertrendsbericht.

Screenshot des Berichts über Fehlertrendsliniendiagramm.

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.

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.

Beispielabfragen

Die folgenden Abfragen geben Daten aus dem WorkItemSnapshot Entitätssatz zurück, um das Generieren von Trendberichten zu unterstützen.

Hinweis

Informationen zum Ermitteln verfügbarer Eigenschaften für Filter- oder Berichtszwecke finden Sie unter Metadatenreferenz für Azure Boards. 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.

Nach Bereichspfad gefilterter Fehlertrend

Die folgenden Abfragen filtern Fehler nach Bereichspfad und einem Startdatum.

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/WorkItemSnapshot? "
        &"$apply=filter( "
            &"WorkItemType eq 'Bug' "
            &"and State ne 'Closed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and DateValue ge {startdate}  "
            &") "
        &"/groupby( "
            &"(DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK), "
            &"aggregate($count as Count) "
            &") "
    ,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/WorkItemSnapshot? 
        $apply=filter(
            WorkItemType eq 'Bug'
            and State ne 'Closed'
            and startswith(Area/AreaPath,'{areapath}')
            and DateValue ge {startdate} 
            )
        /groupby(
            (DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK),
            aggregate($count as Count)
            )

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} - Der Name Ihres Teamprojekts oder das vollständige Auslassen von "/{project}" für eine projektübergreifende Abfrage
{areapath} - Ihr Bereichspfad. Beispielformat: Project\Level1\Level2
{startdate} - Beginnen Sie Ihren Bericht für Elemente, die am oder nach einem bestimmten Datum mit dem Format abgeschlossen wurden: YYYY-MM-DDZ. Beispiel: 2022-04-01Z stellt 2022-April-01 dar. Schließen Sie keine Anführungszeichen ein.

Abfrageaufschlüsselung

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

Abfrageteil

Beschreibung

$apply=filter(

Beginn der Filter-Anweisungsklausel.

WorkItemType eq 'Bug'

Gibt Fehler zurück.

and State ne 'Closed'

Lassen Sie Fehler in einem geschlossenen Zustand aus.

and startswith(Area/AreaPath,'{areapath}')

Geben Sie Arbeitsaufgaben unter einem bestimmten Bereichspfad zurück, in'{areapath}' dem Sie angeben. Verwenden Sie die Filteranweisung Teams/any(x:x/TeamName eq '{teamname})', um nach Teamnamen zu filtern.

and DateValue ge {startdate}

Beginnen Sie den Trend am oder nach dem angegebenen Datum. Beispiel: 2021-04-01Z steht für 2021-April-01.

)

Close-Klausel filter() .

/groupby(

Startklausel groupby() .

(DateValue, State, WorkItemType, Priority, Severity, Area/AreaPath, Iteration/IterationPath),

Gruppieren Sie nach DateValue, die für den Trend verwendet wird, und alle anderen Felder, zu denen Sie berichten möchten.

aggregate($count as Count)

Aggregiert durch Zählen von Fehlern, die den Kriterien an jedem Datum entsprechen.

)

Close-Klausel groupby() .

Von Teams gefilterter Fehlertrend

Sie können Fehlertrends anhand des Teamnamens anstelle des Bereichspfads abfragen.

Power BI-Abfrage
OData-Abfrage

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot? "
        &"$apply=filter( "
            &"WorkItemType eq 'Bug' "
            &"and State ne 'Closed' "
            &"and (Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}')"
            &"and DateValue ge {startdate}  "
            &") "
        &"/groupby( "
            &"(DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK), "
            &"aggregate($count as Count) "
            &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot? 
        $apply=filter(
            WorkItemType eq 'Bug'
            and State ne 'Closed'
            and (Teams/any(x:x/TeamName eq '{teamname}' or Teams/any(x:x/TeamName eq '{teamname}' or Teams/any(x:x/TeamName eq '{teamname}')
            and DateValue ge {startdate} 
            )
        /groupby(
            (DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK),
            aggregate($count as Count)
            )

Fehlertrend mit einer Momentaufnahme jeden Freitag

Die Verwendung einer wöchentlichen Momentaufnahme reduziert die Datenmenge, die in Power BI abgerufen wird, und erhöht die Abfrageleistung.

Power BI-Abfrage
OData-Abfrage

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot? "
        &"$apply=filter( "
            &"WorkItemType eq 'Bug' "
            &"and State ne 'Closed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and DateValue ge {startdate} "
            &"and Date/DayName eq 'Friday'  "
        &") "
        &"/groupby( "
            &"(DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK), "
            &"aggregate($count as Count) "
        &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot? 
        $apply=filter(
            WorkItemType eq 'Bug'
            and State ne 'Closed'
            and startswith(Area/AreaPath,'{areapath}')
            and DateValue ge {startdate}
            and Date/DayName eq 'Friday' 
        )
        /groupby(
            (DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK),
            aggregate($count as Count)
        )

Fehlertrend mit einer Momentaufnahme am ersten jeden Monat

Die Verwendung einer monatlichen Momentaufnahme reduziert die Datenmenge, die in Power BI abgerufen wird, und erhöht die Abfrageleistung.

Power BI-Abfrage
OData-Abfrage

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot? "
        &"$apply=filter( "
            &"WorkItemType eq 'Bug' "
            &"and State ne 'Closed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and DateValue ge {startdate} "
            &"and Date/DayOfMonth eq 1  "
        &") "
        &"/groupby( "
            &"(DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK), "
            &"aggregate($count as Count) "
        &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot? 
        $apply=filter(
            WorkItemType eq 'Bug'
            and State ne 'Closed'
            and startswith(Area/AreaPath,'{areapath}')
            and DateValue ge {startdate}
            and Date/DayOfMonth eq 1 
        )
        /groupby(
            (DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK),
            aggregate($count as Count)
        )

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

Erweitern von Spalten in Power BI

Erweitern Sie die Spalten und Iteration/IterationPath die Area/AreaPath Spalten. Durch das Erweitern der Spalten wird der Datensatz in bestimmte Felder vereinfacht. Informationen dazu finden Sie unter Transform Analytics-Daten zum Generieren von Power BI-Berichten.

(Optional) Umbenennen von Feldern

Nachdem Sie die Spalten erweitert haben, können Sie ein oder mehrere Felder umbenennen. Sie können z. B. die Spalte AreaPath umbenennen in Area Path. 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 Liniendiagrammberichts

Wählen Sie in Power BI den Bericht "Liniendiagramm" unter "Visualisierungen" aus.
Fügen Sie DateValue" zur X-Achse hinzu, klicken Sie mit der rechten Maustaste, DateValue und wählen Sie anstelle Date Hierarchyvon ausDateValue.
Zur Y-Achse hinzufügenCount, klicken Sie mit der rechten MaustasteCount, und stellen Sie sicher, dass Summe ausgewählt ist.
Zur Legende hinzufügenState.

Der Beispielbericht wird angezeigt.

Screenshot des Diagrammberichts

Ändern von visuellen Berichtsformaten

Wenn Sie Formatelemente des Berichts ändern möchten, wählen Sie das Symbol "Visuelles Formatieren" (Pinsel) aus, und ändern Sie eine oder mehrere verfügbare Einstellungen. Sie können beispielsweise die Linienfarben ändern, die im Trenddiagramm verwendet werden.

Weitere Informationen finden Sie unter "Erste Schritte mit dem Formatierungsbereich".

Teilen über

Beispielbericht zu Fehlertrends

Voraussetzungen

Beispielabfragen

Nach Bereichspfad gefilterter Fehlertrend

Ersetzungszeichenfolgen und Abfrageaufschlüsselung

Abfrageaufschlüsselung

Von Teams gefilterter Fehlertrend

Fehlertrend mit einer Momentaufnahme jeden Freitag

Fehlertrend mit einer Momentaufnahme am ersten jeden Monat

(Optional) Abfrage umbenennen

Erweitern von Spalten in Power BI

(Optional) Umbenennen von Feldern

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

Erstellen des Liniendiagrammberichts

Ändern von visuellen Berichtsformaten

Feedback

Zusätzliche Ressourcen

Teilen über

Beispielbericht zu Fehlertrends

Voraussetzungen

Beispielabfragen

Nach Bereichspfad gefilterter Fehlertrend

Ersetzungszeichenfolgen und Abfrageaufschlüsselung

Abfrageaufschlüsselung

Von Teams gefilterter Fehlertrend

Fehlertrend mit einer Momentaufnahme jeden Freitag

Fehlertrend mit einer Momentaufnahme am ersten jeden Monat

(Optional) Abfrage umbenennen

Erweitern von Spalten in Power BI

(Optional) Umbenennen von Feldern

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

Erstellen des Liniendiagrammberichts

Ändern von visuellen Berichtsformaten

Verwandte Artikel

Feedback

Zusätzliche Ressourcen