Folyamat eredményeinek összegzése – mintajelentés
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.
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
- Hozzáférés: Legyen legalább alapszintű hozzáféréssel rendelkező projekt tagja.
- Engedélyek: Alapértelmezés szerint a projekttagok jogosultak az Analytics lekérdezésére és nézetek létrehozására.
- 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 további információt az Analytics eléréséhez szükséges engedélyek és előfeltételek című témakörben talál.
Feljegyzés
Ez a cikk feltételezi, hogy OData-lekérdezések használatával olvassa el 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 EntityType NavigationPropertyBinding Path bármelyikével EntitySet. Mindegyik EntitySet egy EntityType. Az egyes értékek adattípusával kapcsolatos további információkért 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.
Másolja és illessze be közvetlenül az alábbi Power BI-lekérdezést az Üres adat>lekérdezés lekérése ablakba. További információ: OData-lekérdezéseket használó mintajelentések áttekintése.
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
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-01Z2021. 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.
Másolja és illessze be közvetlenül az alábbi Power BI-lekérdezést az Üres adat>lekérdezés lekérése ablakba. További információ: OData-lekérdezéseket használó mintajelentések áttekintése.
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
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
BranchaBranch.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.BranchNameszeletelő mezőjéhez - Válassza ki azt az ágat a szeletelőből, amelyhez látnia kell az eredmény összegzését.
Másolja és illessze be közvetlenül az alábbi Power BI-lekérdezést az Üres adat>lekérdezés lekérése ablakba. További információ: OData-lekérdezéseket használó mintajelentések áttekintése.
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
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.PipelineNameszeletelő mezőjéhez - Válassza ki azt a folyamatot a szeletelőből, amelyhez látnia kell az eredmény összegzését.
Másolja és illessze be közvetlenül az alábbi Power BI-lekérdezést az Üres adat>lekérdezés lekérése ablakba. További információ: OData-lekérdezéseket használó mintajelentések áttekintése.
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
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
PipelineaPipeline.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.PipelineNameszeletelő 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.
Másolja és illessze be közvetlenül az alábbi Power BI-lekérdezést az Üres adat>lekérdezés lekérése ablakba. További információ: OData-lekérdezéseket használó mintajelentések áttekintése.
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
(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 beállításai panelen.
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 további információt a Power BI-jelentések létrehozásához használt Transform Analytics-adatok, oszlop adattípus átalakítása című témakörben talál.
(Nem kötelező) Oszlopmezők átnevezése
Átnevezheti az oszlopmezőket. Átnevezheti például az oszlopot Pipeline.PipelineName Pipeline 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.
CanceledCountPartiallySucceededCount.SucceededCountFailedCount
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ó.