Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Azure DevOps Services | Azure DevOps Server | 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.
| Kategória | Követelmények |
|---|---|
| hozzáférési szintek |
-
Projekt tagja. - Legalább alapszintű hozzáférést. |
| Jogosultságok | 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. |
Megjegyzé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.
Megjegyzé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 bármelyik Property érték segítségével egy EntityType alatt, vagy bármely NavigationPropertyBinding Path értékkel, amely elérhető egy 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 karakterláncok és lekérdezések elemzése
Cserélje le a következő karakterláncokat az ön értékeivel. Ne szerepeljenek zárójelek {} a helyettesítés során. Ha például a szervezet neve "Fabrikam", cserélje le a {organization}-t Fabrikam-re, ne pedig {Fabrikam}-re.
-
{organization}- A szervezet neve -
{project}– A csapat projektneve -
{pipelinename}- Az adatcsatorna 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(
Kezdés 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,
Számold össze a futtatások teljes számát TotalCount.
SucceededCount with sum as SucceededCount ,
Számolja meg a sikeres futtatások számát 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 ,
Számold meg a részben sikeres futtatások számát mint PartiallySucceededCount.
CanceledCount with sum as CanceledCount
Számolja meg a megszakított futtatások számát, mint CanceledCount.
)
Zárja le aggregate() záradékot.
Folyamatfuttatás eredményeinek összegzése egy adott folyamatazonosítóhoz
A csővezetékek á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:
- Alakítsa át
Branch-tBranch.BranchName-vé - Oszlop adattípusának módosítása
- Hozza létre a fánkdiagram-jelentést
- Válassza ki a Szeletelő elemet a Vizualizációk panelről, és adja hozzá a
Branch.BranchNamea szeletelő Mező területére. - 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 Build okok (manuális/BatchedCI, pull-kérelem stb.) miatt 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
- Hozza létre a fánkdiagram-jelentést
- Válassza ki a Szeletelő elemet a Vizualizációk panelről, és adja hozzá a
Pipeline.PipelineNamea szeletelő Mező területére. - 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:
- Alakítsa át
Pipeline-tPipeline.PipelineName-vé - Oszlop adattípusának módosítása
- Hozza létre a fánkdiagram-jelentést
- Válassza ki a Szeletelő elemet a Vizualizációk panelről, és adja hozzá a
Pipeline.PipelineNamea szeletelő Mező területére. - 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.
Az oszlopmezők átnevezése (opcionálisan)
Átnevezheti az oszlopmezőket. Átnevezheti például az oszlopot Pipeline.PipelineNamePipeline Namea következőre: vagy TotalCount .Total Count A megtanuláshoz, hogyan, lásd: 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.
Hozd létre a fánkdiagram-jelentést
A Power BI Vizualizációk alatt válassza a gyűrűdiagram jelenté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. SucceededCountFailedCount
A jelentés címének módosításához válassza a Vizuális formázás ecset ikonját a Vizualizációk panelen, 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ó.