Folyamat eredményeinek összegzése – mintajelentés

Cikk
01/10/2024

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

A folyamatfuttatások egy folyamat egyetlen végrehajtását jelölik. A futtatás során a folyamat feldolgozásra kerül, az ügynökök pedig egy vagy több feladatot dolgoznak fel. Az eredmények közé tartozik a sikeres, a sikertelen, a megszakított és a részlegesen sikeres. A folyamatfuttatások eredményeit megjelenítő jelentések létrehozásához lekérdezi a "PipelineRuns entity set" kifejezést.

Ez a cikk számos lekérdezést és utasítást tartalmaz arról, hogyan hozhat létre jelentést a különböző folyamatok eredményeihez tartozó futtatások számának lekéréséhez.

Az alábbi képen egy példa látható egy eredményösszegző jelentésre.

Képernyőkép a Power BI-folyamatok eredményösszegző 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 alábbi lekérdezéseivel PipelineRuns különböző, de hasonló folyamateredmény-összefoglaló jelentéseket hozhat 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.

Elnevezett folyamat folyamatának időtartama

Az alábbi lekérdezések egy megadott kezdési dátumtól egy adott folyamat folyamatfuttatását adják vissza.

Power BI-lekérdezés
OData-lekérdezés

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/PipelineRuns?"
        &"$apply=filter( "
                &"Pipeline/PipelineName eq '{pipelineName}' "
                &"and CompletedDate ge {startdate} "
                &") "
        &"/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

A következő OData-lekérdezési kóddal módosíthatja vagy tesztelheti a lekérdezést, mielőtt a Power BI-ban használaná. További információ: Csatlakozás Power BI- és OData-lekérdezések használatával.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?
$apply=filter(
	Pipeline/PipelineName eq '{pipelineName}'
	and CompletedDate ge {startdate}
	)
/aggregate(
	$count as TotalCount,
	SucceededCount with sum as SucceededCount ,
	FailedCount with sum as FailedCount,
	PartiallySucceededCount with sum as PartiallySucceededCount ,
	CanceledCount with sum as CanceledCount
	)

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}'

A megadott folyamat folyamatfuttatásainak visszaadása.

and CompletedDate ge {startdate}

A visszaadott folyamat a megadott dátumon vagy után fut.

)

Záradék bezárása filter()

/aggregate(

Az összes folyamat indítási aggregate záradéka megfelel a szűrési feltételeknek.

$count as TotalCount,

A futtatások teljes számának megszámlálása a következőképpen TotalCount: .

SucceededCount with sum as SucceededCount ,

A sikeres futtatások számának megszámlálása a következőképpen SucceededCount: .

FailedCount with sum as FailedCount,

A sikertelen futtatások számának megszámlálása a következőként FailedCount: .

PartiallySucceededCount with sum as PartiallySucceededCount ,

A részben sikeres futtatások számának megszámlálása a következőként PartiallySucceededCount: .

CanceledCount with sum as CanceledCount

A megszakított futtatások számának megszámlálása a következőként CanceledCount: .

)

Zárja be aggregate() a záradékot.

Folyamatfuttatás eredményeinek összegzése egy adott folyamatazonosítóhoz

A folyamatok átnevezhetők. Annak érdekében, hogy a Power BI-jelentések ne szakadjanak meg a folyamatnév módosításakor, használja a folyamatazonosítót a neve helyett. A folyamatazonosítót a folyamatfuttatási oldal URL-címéről szerezheti be.

https://dev.azure.com/{organization}/{project}/_build?definitionId={pipelineid}

Az alábbi lekérdezések egy adott folyamatazonosítóhoz és egy megadott kezdési dátumhoz adják vissza a folyamatfuttatásokat.

Power BI-lekérdezés
OData-lekérdezés

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
        &"$apply=filter( "
                &"PipelineId eq {pipelineId} "
                &"and CompletedDate ge {startdate} "
                &") "
        &"/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

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?
$apply=filter(
    PipelineId eq {pipelineId}
    and CompletedDate ge {startdate}
    )
/aggregate(
    $count as TotalCount,
    SucceededCount with sum as SucceededCount ,
    FailedCount with sum as FailedCount,
    PartiallySucceededCount with sum as PartiallySucceededCount ,
    CanceledCount with sum as CanceledCount
)

A folyamatfuttatás eredményeinek összegzése ág szerint szűrve

Egy adott ág folyamatának eredményösszesítőjének megtekintéséhez használja az alábbi lekérdezéseket. A jelentés létrehozásához hajtsa végre a következő lépéseket:

Bontsa ki Branch a Branch.BranchName
Oszlop adattípusának módosítása
A fánkdiagram-jelentés létrehozása
Válassza a Szeletelő lehetőséget a Vizualizációk panelen, és adja hozzá a Branch.BranchName szeletelő mezőjéhez
Válassza ki azt az ágat a szeletelőből, amelyhez látnia kell az eredmény összegzését.

Power BI-lekérdezés
OData-lekérdezés

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
        &"$apply=filter( "
                &"Pipeline/PipelineName eq '{pipelinename}' "
                &"and CompletedDate ge {startdate} "
                &") "
        &"/groupby( "
        &"(Branch/BranchName), "
            &"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

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?
$apply=filter(
    Pipeline/PipelineName eq '{pipelinename}'
    and CompletedDate ge {startdate}
    )
/groupby(
(Branch/BranchName),
aggregate(
    $count as TotalCount,
    SucceededCount with sum as SucceededCount ,
    FailedCount with sum as FailedCount,
    PartiallySucceededCount with sum as PartiallySucceededCount ,
    CanceledCount with sum as CanceledCount
    ))

A folyamatfuttatás eredményeinek összegzése a buildelési ok alapján szűrve

Előfordulhat, hogy csak bizonyos buildelési okokból (manuális/ BatchedCI, lekéréses kérelem stb.) szeretné megtekinteni egy folyamat eredményösszesítését. A jelentés létrehozásához hajtsa végre a következő lépéseket:

Oszlop adattípusának módosítása
A fánkdiagram-jelentés létrehozása
Válassza a Szeletelő lehetőséget a Vizualizációk panelen, és adja hozzá a Pipeline.PipelineName szeletelő mezőjéhez
Válassza ki azt a folyamatot a szeletelőből, amelyhez látnia kell az eredmény összegzését.

Power BI-lekérdezés
OData-lekérdezés

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
        &"$apply=filter( "
                &"Pipeline/PipelineName eq '{pipelinename}' "
                &"and CompletedDate ge {startdate} "
                &") "
        &"/groupby( "
        &"(RunReason), "
            &"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

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?
$apply=filter(
    Pipeline/PipelineName eq '{pipelinename}'
    and CompletedDate ge {startdate}
    )
/groupby(
(RunReason),
aggregate(
    $count as TotalCount,
    SucceededCount with sum as SucceededCount ,
    FailedCount with sum as FailedCount,
    PartiallySucceededCount with sum as PartiallySucceededCount ,
    CanceledCount with sum as CanceledCount
))

Az összes projektfolyamat eredményének összegzése

Előfordulhat, hogy egyetlen jelentésben szeretné megtekinteni az összes projektfolyamat folyamatkimenetének összegzését. A jelentés létrehozásához hajtsa végre a következő lépéseket:

Bontsa ki Pipeline a Pipeline.PipelineName
Oszlop adattípusának módosítása
A fánkdiagram-jelentés létrehozása
Válassza a Szeletelő lehetőséget a Vizualizációk panelen, és adja hozzá a Pipeline.PipelineName szeletelő mezőjéhez
Válassza ki azt a folyamatot a szeletelőből, amelyhez látnia kell az eredmény összegzését.

A részletes lépésekért tekintse meg az összes folyamat mintajelentésének eredmény-összegzését is.

Power BI-lekérdezés
OData-lekérdezés

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

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

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

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

A Power Query-szerkesztő válassza ki az TotalCount oszlopot, majd az Átalakítás menüBen válassza az Adattípus lehetőséget, majd a Teljes szám lehetőséget. Az adattípus módosításáról a Power BI-jelentések létrehozásához készült Transform Analytics-adatok, oszlop adattípus átalakítása című témakörben olvashat bővebben.

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

Átnevezheti az oszlopmezőket. Á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.

A fánkdiagram-jelentés létrehozása

A Power BI Vizualizációk területén válassza a fánkjelentést.
Adja hozzá a következő mezőket az Értékekhez a megadott sorrendben. Kattintson a jobb gombbal az egyes mezőkre, és győződjön meg arról, hogy az Összeg ki van jelölve.
- CanceledCount
- PartiallySucceededCount.
- SucceededCount
- FailedCount
A jelentés címének módosításához válassza a Vizualizációk panelen a Vizualizációk panelen a vizualizációk ecsetének formázása ikont, válassza az Általános lehetőséget, bontsa ki a Cím elemet, és cserélje le a meglévő szöveget.

Az alábbi képen az eredményként kapott jelentés látható.

Share via

Folyamat eredményeinek összegzése – mintajelentés

Előfeltételek

Minta lekérdezések

Elnevezett folyamat folyamatának időtartama

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

Lekérdezések lebontása

Folyamatfuttatás eredményeinek összegzése egy adott folyamatazonosítóhoz

A folyamatfuttatás eredményeinek összegzése ág szerint szűrve

A folyamatfuttatás eredményeinek összegzése a buildelési ok alapján szűrve

Az összes projektfolyamat eredményének összegzése

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

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

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

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

A fánkdiagram-jelentés létrehozása

Visszajelzés

Visszajelzés

További források

Share via

Folyamat eredményeinek összegzése – mintajelentés

Előfeltételek

Minta lekérdezések

Elnevezett folyamat folyamatának időtartama

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

Lekérdezések lebontása

Folyamatfuttatás eredményeinek összegzése egy adott folyamatazonosítóhoz

A folyamatfuttatás eredményeinek összegzése ág szerint szűrve

A folyamatfuttatás eredményeinek összegzése a buildelési ok alapján szűrve

Az összes projektfolyamat eredményének összegzése

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

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

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

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

A fánkdiagram-jelentés létrehozása

Kapcsolódó cikkek

Visszajelzés

Visszajelzés

További források