Przykładowy raport dotyczący trendów błędów

Artykuł
01/10/2024

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

Raporty trendów błędów są przydatne, aby zobaczyć, jak dobrze zespół zamyka aktywne usterki. W tym artykule pokazano, jak wyświetlić liczbę usterek w danym stanie w danym okresie. Na poniższej ilustracji przedstawiono przykład raportu trendów błędów.

Zrzut ekranu przedstawiający raport wykresu liniowego trendów błędów.

Uwaga

W tym artykule założono, że znasz artykuł Omówienie przykładowych raportów przy użyciu zapytań OData i masz podstawową wiedzę na temat usługi Power BI.

Wymagania wstępne

Aby wyświetlić dane analizy i wykonać zapytanie dotyczące usługi, musisz być członkiem projektu z dostępem podstawowym lub większym. Domyślnie wszyscy członkowie projektu otrzymują uprawnienia do wykonywania zapytań w usłudze Analytics i definiowania widoków analizy.
Aby dowiedzieć się więcej o innych wymaganiach wstępnych dotyczących włączania usługi i funkcji oraz ogólnych działań śledzenia danych, zobacz Uprawnienia i wymagania wstępne dotyczące dostępu do analizy.

Przykładowe zapytania

Następujące zapytania zwracają dane z WorkItemSnapshot zestawu jednostek w celu obsługi generowania raportów trendów.

Uwaga

Aby określić dostępne właściwości dla celów filtru lub raportu, zobacz Dokumentacja metadanych dla usługi Azure Boards. Możesz filtrować zapytania lub zwracać właściwości przy użyciu dowolnej z Property wartości dostępnych EntityType w elemecie EntitySetlub NavigationPropertyBinding Path . Każda z nich EntitySet odpowiada elementowi EntityType. Aby dowiedzieć się więcej o typie danych każdej wartości, przejrzyj metadane podane dla odpowiedniego EntityTypeelementu .

Trend usterki filtrowany według ścieżki obszaru

Poniższe zapytania filtrować usterki według ścieżki obszaru i daty rozpoczęcia.

Zapytanie usługi Power BI
Zapytanie OData

Możesz wkleić zapytanie usługi Power BI wymienione poniżej bezpośrednio w oknie Pobieranie zapytania pustego> danych. Aby uzyskać więcej informacji, zobacz Omówienie przykładowych raportów przy użyciu zapytań OData.

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

Możesz użyć następującego kodu zapytania OData, aby zmodyfikować lub przetestować zapytanie przed użyciem go w usłudze Power BI. Aby uzyskać więcej informacji, zobacz Połączenie przy użyciu zapytań usługi Power BI i OData.

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

Ciągi podstawienia i podział zapytań

Zastąp następujące ciągi wartościami. Nie dołączaj nawiasów {} do podstawienia. Na przykład jeśli nazwa organizacji to "Fabrikam", zastąp Fabrikamciąg {organization} , a nie {Fabrikam}.

{organization} — Nazwa organizacji
{project} — Nazwa projektu zespołowego lub całkowicie pomiń "/{project}" dla zapytania obejmującego wiele projektów
{areapath} — Ścieżka obszaru. Przykładowy format: Project\Level1\Level2
{startdate} — Rozpocznij raport dla elementów zakończonych w dniu lub po danej dacie z formatem: YYYY-MM-DDZ. Na przykład: 2022-04-01Z reprezentuje 2022-Kwiecień-01. Nie ujęć w cudzysłów.

Podział zapytań

W poniższej tabeli opisano każdą część zapytania.

Część kwerendy

Opis

$apply=filter(

Początek klauzuli filter statement.

WorkItemType eq 'Bug'

Zwracanie usterek.

and State ne 'Closed'

Pomiń usterki w stanie Zamknięty.

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

Zwracanie elementów roboczych w ramach określonej ścieżki obszaru określonej w'{areapath}'. Aby filtrować według nazwy zespołu, użyj instrukcji Teams/any(x:x/TeamName eq '{teamname})'filter .

and DateValue ge {startdate}

Rozpocznij trend w określonym dniu lub po określonej dacie. Przykład: 2021-04-01Z reprezentuje 2021-kwiecień-01.

)

Zamknij filter() klauzulę.

/groupby(

Klauzula Start groupby() .

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

Grupuj według DateValue, używaną do trendów i innych pól, dla których chcesz raportować.

aggregate($count as Count)

Agregowanie przez zliczanie usterek spełniających kryteria w każdej dacie.

)

Zamknij groupby() klauzulę.

Trend usterki filtrowany przez usługę Teams

Możesz wykonywać zapytania dotyczące trendów błędów według nazwy zespołu, a nie ścieżki obszaru.

Zapytanie usługi Power BI
Zapytanie OData

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

Trend usterki z migawką co piątek

Użycie cotygodniowej migawki zmniejsza ilość danych ściągniętych do usługi Power BI i zwiększa wydajność zapytań.

Zapytanie usługi Power BI
Zapytanie OData

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

Trend usterki z migawką pierwszego miesiąca

Użycie migawki miesięcznej zmniejsza ilość danych ściągniętych do usługi Power BI i zwiększa wydajność zapytań.

Zapytanie usługi Power BI
Zapytanie OData

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

(Opcjonalnie) Zmienianie nazwy zapytania

Możesz zmienić nazwę domyślnej etykiety zapytania Query1 na bardziej zrozumiałą. Po prostu wprowadź nową nazwę w okienku Zapytanie Ustawienia.

Zrzut ekranu przedstawiający opcje menu zapytania usługi Power BI, zmień nazwę zapytania.

Rozwijanie kolumn w usłudze Power BI

Rozwiń kolumny Area/AreaPath i Iteration/IterationPath . Rozszerzanie kolumn spłaszcza rekord do określonych pól. Aby dowiedzieć się, jak to zrobić, zobacz Transform Analytics data to generate Power BI reports (Przekształcanie danych analizy w celu generowania raportów usługi Power BI).

(Opcjonalnie) Zmienianie nazwy pól

Po rozwinięciu kolumn możesz zmienić nazwę co najmniej jednego pola. Możesz na przykład zmienić nazwę kolumny AreaPath na Area Path. Aby dowiedzieć się, jak to zrobić, zobacz Zmienianie nazwy pól kolumn.

Zamknij zapytanie i zastosuj zmiany

Po zakończeniu wszystkich przekształceń danych wybierz pozycję Zamknij i zastosuj z menu Narzędzia główne , aby zapisać zapytanie i wrócić do karty Raport w usłudze Power BI.

Tworzenie raportu wykresu liniowego

W usłudze Power BI wybierz raport Wykres liniowy w obszarze Wizualizacje.
Dodaj znak DateValue" do osi X, a następnie kliknij prawym przyciskiem myszy DateValue i wybierz DateValue zamiast Date Hierarchy.
Dodaj Count do osi Y, a następnie kliknij prawym przyciskiem myszy Count i upewnij się, że wybrano pozycję Suma .
Dodaj State do legendy.

Zostanie wyświetlony przykładowy raport.

Zrzut ekranu przedstawiający przykładowy raport wykresu liniowego trendów błędów.

Modyfikowanie wizualizacji w formacie raportu

Aby zmodyfikować elementy formatu raportu, wybierz ikonę Formatuj wizualizację (paintbrush) i zmodyfikuj co najmniej jedno dostępne ustawienia. Można na przykład zmodyfikować kolory linii używane na wykresie trendu.

Aby dowiedzieć się więcej, zobacz Wprowadzenie do okienka formatowania.

Przykładowy raport dotyczący trendów błędów

Wymagania wstępne

Przykładowe zapytania

Trend usterki filtrowany według ścieżki obszaru

Ciągi podstawienia i podział zapytań

Podział zapytań

Trend usterki filtrowany przez usługę Teams

Trend usterki z migawką co piątek

Trend usterki z migawką pierwszego miesiąca

(Opcjonalnie) Zmienianie nazwy zapytania

Rozwijanie kolumn w usłudze Power BI

(Opcjonalnie) Zmienianie nazwy pól

Zamknij zapytanie i zastosuj zmiany

Tworzenie raportu wykresu liniowego

Modyfikowanie wizualizacji w formacie raportu

Opinia

Opinia

Dodatkowe zasoby

Przykładowy raport dotyczący trendów błędów

Wymagania wstępne

Przykładowe zapytania

Trend usterki filtrowany według ścieżki obszaru

Ciągi podstawienia i podział zapytań

Podział zapytań

Trend usterki filtrowany przez usługę Teams

Trend usterki z migawką co piątek

Trend usterki z migawką pierwszego miesiąca

(Opcjonalnie) Zmienianie nazwy zapytania

Rozwijanie kolumn w usłudze Power BI

(Opcjonalnie) Zmienianie nazwy pól

Zamknij zapytanie i zastosuj zmiany

Tworzenie raportu wykresu liniowego

Modyfikowanie wizualizacji w formacie raportu

Powiązane artykuły

Opinia

Opinia

Dodatkowe zasoby