Share via

Folyamatszakaszok – bölcs hibák – mintajelentés

  • Cikk

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

Ez a cikk bemutatja, hogyan hozhat létre jelentést egy folyamat napi szakaszhibáiról. Ez a jelentés hasonlít a Folyamatátengedési sebesség jelentés "Hibatrend" diagramjára.

Az alábbi képen egy példa látható egy adott folyamat 2022. októbere és 2022. december 15. közötti szakaszenkénti meghibásodási jelentésére.

Képernyőkép a Power BI-folyamatok szakaszos hibáiról halmozott oszlop jelentéséről.

Fontos

Az Elemzési szolgáltatás OData-hírcsatornájának Power BI-integrációja és hozzáférése általánosan elérhető az Azure DevOps Serviceshez, valamint az Azure DevOps Server 2020- és újabb verzióihoz. A cikkben szereplő minta lekérdezések csak az Azure DevOps Server 2020 és újabb verzióira érvényesek, és a 3.0-s vagy újabb verziótól függnek. Javasoljuk, hogy használja ezeket a lekérdezéseket, és küldjön nekünk visszajelzést.

Előfeltételek

  • Az Analytics-adatok megtekintéséhez és a szolgáltatás lekérdezéséhez egy alapszintű hozzáféréssel rendelkező vagy annál nagyobb hozzáférésű projekt tagjának kell lennie. Alapértelmezés szerint minden projekttag rendelkezik az Analytics lekérdezéséhez és az Analytics-nézetek meghatározásához szükséges engedélyekkel.
  • A szolgáltatás- és szolgáltatás-engedélyezéssel, valamint az általános adatkövetési tevékenységekkel kapcsolatos egyéb előfeltételekről az Analytics eléréséhez szükséges engedélyek és előfeltételek című témakörben olvashat.

Feljegyzés

Ez a cikk feltételezi, hogy OData-lekérdezésekkel olvasta a mintajelentések áttekintését, és alapszintű ismeretekkel rendelkezik a Power BI-ról.

Minta lekérdezések

Az entitáskészlet lekérdezésével PipelineRunActivityResults szakasz-, tevékenység- vagy feladathiba-trendjelentések hozhatók létre.

Feljegyzés

A szűrési vagy jelentéskészítési célokra elérhető tulajdonságok meghatározásához tekintse meg az Azure Pipelines metaadat-referenciáit. Szűrheti a lekérdezéseket, vagy visszaadhatja a tulajdonságokat egy Property adott vagy egy adott értékkel elérhető értékek EntityTypeNavigationPropertyBinding Path bármelyikével EntitySet. Mindegyik EntitySet egy EntityType. Ha többet szeretne megtudni az egyes értékek adattípusáról, tekintse át a megfelelő EntityTypemetaadatokat.

Szakaszenkénti meghibásodási trend

Egy adott folyamat szakaszenkénti meghibásodási trendjének megtekintéséhez használja az alábbi lekérdezéseket.

Az alábbi Power BI-lekérdezést közvetlenül az Adat-üres> lekérdezés lekérése ablakba illessze be. További információkért tekintse át a mintajelentések áttekintését OData-lekérdezésekkel.

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

Helyettesítési sztringek és lekérdezések lebontása

Cserélje le a következő sztringeket az értékekkel. Ne tartalmazzon szögletes zárójeleket {} a helyettesítéssel. Ha például a szervezet neve "Fabrikam", cserélje le a Fabrikamhelyére {organization} a nem {Fabrikam}.

  • {organization} - A szervezet neve
  • {project} – A csapat projektneve
  • {pipelinename} - A folyamat neve. Példa: Fabrikam hourly build pipeline
  • {startdate} - A jelentés indításának dátuma. Formátum: YYYYY-MM-DDZ. Példa: 2021-09-01Z 2021. szeptember 1. Ne foglaljon össze idézőjeleket vagy szögletes zárójeleket, és használjon két számjegyet mind a hónap, mind a dátum esetében.

Lekérdezések lebontása

Az alábbi táblázat a lekérdezés egyes részeit ismerteti.

Lekérdezési rész

Leírás

$apply=filter(

Start filter() záradék.

Pipeline/PipelineName eq '{pipelinename}'

Adott folyamat tevékenységeredményeinek visszaadása.

and PipelineRunCompletedOn/Date ge {startdate}

A megadott dátumon vagy után futó folyamatok tevékenységeredményeinek visszaadása.

and PipelineRunOutcome eq 'Failed'

Olyan feladateredményeket ad vissza, ahol a build eredménye sikertelen.

and TaskOutcome eq 'Failed'

Olyan tevékenységeredményeket ad vissza, ahol a tevékenység eredménye sikertelen.

)

Zárja be filter a záradékot.

/groupby(

Start groupby() záradék.

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

Csoportosítsa a folyamatfuttatás befejezésének dátuma, a build azonosítója és a szakasz neve szerint.

aggregate (FailedCount with sum as FailedCount))

Minden napra vonatkozóan a buildazonosítót és a szakaszt; a hibák teljes számának megszámlálása. A feladathibák teljes száma lesz, nem pedig a fázishibák.

/groupby(

Start groupby() záradék.

(PipelineRunCompletedOn/Date, PipelineJob/StageName ),

Csoportosítás nap és szakasz neve szerint.

aggregate

Start aggregate záradék.

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

Minden nap összegzi, hogy egy szakasz hány alkalommal nem sikerült, majd zárja be a aggregate záradékot.

Tevékenységbölcsés hibák trendje

A tevékenységekkel kapcsolatos hibák trendjének megtekintéséhez használja az alábbi lekérdezéseket.

Az alábbi Power BI-lekérdezést közvetlenül az Adat-üres> lekérdezés lekérése ablakba illessze be. További információkért tekintse át a mintajelentések áttekintését OData-lekérdezésekkel.

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

A feladathoz kapcsolódó hibák trendje

A feladathoz kapcsolódó hibák trendjének megtekintéséhez használja az alábbi lekérdezéseket.

Az alábbi Power BI-lekérdezést közvetlenül az Adat-üres> lekérdezés lekérése ablakba illessze be. További információkért tekintse át a mintajelentések áttekintését OData-lekérdezésekkel.

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

(Nem kötelező) Lekérdezés átnevezése

Az alapértelmezett lekérdezéscímkét (Query1) átnevezheti valami értelmesebbre. Egyszerűen adjon meg egy új nevet a Lekérdezés Gépház panelen.

Képernyőkép a Power BI lekérdezési menüjének beállításairól, a lekérdezés átnevezéséről.

Oszlopok kibontása Power Query-szerkesztő

A jelentés létrehozása előtt ki kell bontania a következő két oszlopot. A munkaelemek kibontásával kapcsolatos további információkért tekintse meg a Power BI-jelentések létrehozásához használható Transform Analytics-adatokat.

  • Bontsa ki PipelineJob a PipelineJob.StageName
  • Bontsa ki PipelineRunCompletedOn a PipelineRunCompletedOn.Date

Oszlop adattípusának módosítása

Az Átalakítás menüben módosítsa az oszlop adattípusát FailedStageCount Egész szám értékre. A cikkből megtudhatja, hogyan alakíthatja át az oszlop adattípusát.

(Nem kötelező) Oszlopmezők átnevezése

Az oszlopmezőket átnevezheti felhasználóbarátabbra. Átnevezheti például az oszlopot Pipeline.PipelineNamePipeline Namea következőre: vagy TotalCount .Total Count További információ: Oszlopmezők átnevezése.

Zárja be a lekérdezést, és alkalmazza a módosításokat

Miután elvégezte az összes adatátalakítást, válassza a Kezdőlap menü Bezárás &alkalmaz elemét a lekérdezés mentéséhez és a Power BI Jelentés lapjára való visszatéréshez.

Képernyőkép a Power Query-szerkesztő Bezárás és alkalmazás lehetőségről.

Halmozott oszlopdiagram-jelentés létrehozása

  1. A Power BI Vizualizációk területén válassza a Halmozott oszlopdiagram jelentést. Az alábbi példa feltételezi, hogy senki sem átnevezett oszlopokat.

    Képernyőkép a Vizualizáció mezőinek a szakaszenkénti hibák halmozott oszlopdiagram jelentéséhez való kiválasztásáról.

  2. Adja hozzá PipelineRunCompletedOn.Date az X tengelyhez, kattintson rá a jobb gombbal, és válassza a PipelineRunCompletedOn.Date lehetőséget a Dátumhierarchia helyett.

  3. Kattintson FailedStagedCount rá a jobb gombbal az Y tengelyhez, és győződjön meg arról, hogy az Összeg ki van jelölve.

  4. Hozzáadás PipelineJob.StageName a jelmagyarázathoz.

  5. A jelentés címének, jelmagyarázatának vagy más jelentésvizualizációinak módosításához válassza a Vizualizációk panelen a Vizualizációk panelen a Vizualizációk panelen a Vizualizációk ecset formázása ikont, és módosítsa egy vagy több beállítást.

A jelentésnek az alábbi képhez hasonlóan kell kinéznie.

Képernyőkép a Power BI-folyamatok mintájáról, szakaszenkénti hibák halmozott oszlop jelentéséről.