Freigeben über

Beispielbericht zu Fehlertrends

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

Fehlertrendberichte helfen Ihnen 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 Zeitraum hinweg angezeigt werden kann. Die folgende Abbildung zeigt ein Beispiel für einen Fehlertrendsbericht.

Screenshot des Berichts über das Liniendiagramm zu Fehlertrends.

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.

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.

Beispielabfragen

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

Hinweis

Informationen zum Suchen verfügbarer Eigenschaften zum Filtern oder Melden finden Sie in der Metadata-Referenz für Azure Boards. 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.

Nach Bereichspfad gefilterter Fehlertrend

Die folgenden Abfragen filtern Fehler nach Bereichspfad und einem Startdatum.

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

Ersetzungszeichenfolgen und Abfrageaufschlüsselung

Ersetzen Sie die folgenden Zeichenfolgen durch Ihre Werte. Schließen Sie die geschweiften Klammern {} nicht in Ihre Ersetzung ein. Wenn Ihr Organisationsname z. B. "Fabrikam" lautet, ersetzen Sie {organization} durch Fabrikam, nicht durch {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 im geschlossenen Zustand aus.

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

Geben Sie Arbeitsaufgaben zurück, die unter einem von Ihnen angegebenen Bereichspfad liegen '{areapath}'. 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.

)

Die filter()-Klausel schließen.

/groupby(

Startklausel groupby() .

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

Gruppieren Sie nach DateValue, verwendet für Trendanalysen und alle anderen Felder, über die Sie berichten möchten.

aggregate($count as Count)

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

)

Die groupby()-Klausel schließen.

Nach Teams gefilterter Fehlertrend

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

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

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.

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

Fehlertrend mit einer Momentaufnahme am ersten jedes Monats

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

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

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

Erweitern Sie die Area/AreaPath- und Iteration/IterationPath-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 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 Liniendiagrammberichts

  1. Wählen Sie in Power BI unter Visualisierungen das Liniendiagramm-Bericht aus.

    Screenshot der Power BI Visualisierungen und Felderauswahl für den Fehlertrendsbericht.

  2. DateValue zur X-Achse hinzufügen. Klicken Sie mit der rechten Maustaste DateValue , und wählen Sie DateValue statt Date Hierarchy.

  3. Count zur Y-Achse hinzufügen. Klicken Sie mit der rechten Maustaste Count , und stellen Sie sicher, dass Summe ausgewählt ist.

  4. Füge State zur Legende hinzu.

Der Beispielbericht wird angezeigt.

Screenshot des Liniendiagrammberichts über Beispielfehlertrends.

Ändern von Berichtsformat-Visualisierungen

  • 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 z. B. die im Trenddiagramm verwendeten Linienfarben ändern.

    Screenshot der Power BI-Formatseiten für die visuellen Auswahlen im Fehlertrends-Bericht.

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

  • Last updated on