Delen via

Voorbeeldrapport pijplijnpasfrequentie

  • Artikel

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

In dit artikel leest u hoe u een rapport maakt waarin de dagelijkse wachtwoordfrequentietrend van een pijplijn wordt weergegeven. De doorvoersnelheid van een pijplijn wordt gedefinieerd als het percentage geslaagde pijplijnuitvoeringen tot het totale aantal pijplijnuitvoeringen. Dit is vergelijkbaar met de grafiek 'Pass rate trend' van het rapport Pijplijnpasfrequentie. In de volgende afbeelding ziet u een voorbeeld van een dergelijke trend.

Schermopname van het rapport Pass Rate Trend voor Power BI Pipelines-uitvoeringen.

Belangrijk

Power BI-integratie en -toegang tot de OData-feed van de Analytics-service zijn algemeen beschikbaar voor Azure DevOps Services en Azure DevOps Server 2020 en latere versies. De voorbeeldquery's in dit artikel zijn alleen geldig voor Azure DevOps Server 2020 en latere versies en zijn afhankelijk van versie v3.0 of hoger. We raden u aan deze query's te gebruiken en ons feedback te geven.

Vereisten

Notitie

In dit artikel wordt ervan uitgegaan dat u overzicht van voorbeeldrapporten leest met behulp van OData-query's en basiskennis hebt van Power BI.

Voorbeeldquery's

U kunt de volgende query's van de PipelineRuns entiteitsset gebruiken om verschillende maar vergelijkbare rapporten voor de trendpercentage te maken.

Notitie

Als u de beschikbare eigenschappen voor filter- of rapportdoeleinden wilt bepalen, raadpleegt u de naslaginformatie over metagegevens voor Azure Pipelines. U kunt uw query's filteren of eigenschappen retourneren met behulp van een van de Property waarden onder een EntityType of NavigationPropertyBinding Path waarden die beschikbaar zijn met een EntitySet. Elk EntitySet komt overeen met een EntityType. Raadpleeg voor meer informatie over het gegevenstype van elke waarde de metagegevens die voor de bijbehorende EntityTypewaarde zijn opgegeven.

Rentetrend voor een benoemde pijplijn

De volgende query's retourneren de pijplijnuitvoeringen voor een specifieke pijplijn vanaf een opgegeven begindatum.

Kopieer en plak de volgende Power BI-query rechtstreeks in het venster Lege query ophalen>. Zie Overzicht van voorbeeldrapporten met behulp van OData-query's voor meer informatie.

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} "
                &"and CanceledCount ne 1 "
        &") "
        &"/groupby( "
            &"(CompletedOn/Date), "
                &"aggregate "
                &"($count as TotalCount, "
            &"SucceededCount with sum as SucceededCount , "
                &"FailedCount with sum as FailedCount, "
            &"PartiallySucceededCount with sum as PartiallySucceededCount)) "
        &"/compute( "
    &"SucceededCount mul 100.0 div TotalCount as PassRate, "
    &"FailedCount mul 100.0 div TotalCount as FailRate, "
    &"PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate) "
    &"&$orderby=CompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Uitsplitsing van tekenreeksen en query's vervangen

Vervang de volgende tekenreeksen door uw waarden. Neem geen vierkante haken {} op bij uw vervanging. Als de naam van uw organisatie bijvoorbeeld Fabrikam is, vervangt u door {organization} Fabrikam, niet {Fabrikam}.

  • {organization} - Naam van uw organisatie
  • {project} - De naam van uw teamproject
  • {pipelinename} - De naam van uw pijplijn. Voorbeeld: Fabrikam hourly build pipeline
  • {startdate} - De datum waarop het rapport moet worden gestart. Indeling: JJJJ-MM-DDZ. Voorbeeld: 2021-09-01Z vertegenwoordigt 1 september 2021. Plaats geen aanhalingstekens of vierkante haken en gebruik twee cijfers voor zowel maand als datum.

Uitsplitsing van query's

In de volgende tabel wordt elk deel van de query beschreven.

Queryonderdeel

Beschrijving

$apply=filter(

Begincomponent filter() .

Pipeline/PipelineName eq '{pipelinename}'

Retourpijplijnuitvoeringen voor de opgegeven pijplijn.

and CompletedDate ge {startdate}

Retourpijplijn wordt uitgevoerd op of na de opgegeven datum.

and CanceledCount ne 1

Geannuleerde pijplijnuitvoeringen weglaten.

)

Sluit filter() de component.

/groupby(

Begincomponent groupby() .

(CompletedOn/Date),

Groeperen op datum van voltooiing van pijplijnuitvoering.

aggregate

Begincomponent aggregate voor alle pijplijnuitvoeringen die overeenkomen met de filtercriteria.

($count as TotalCount,

Het totale aantal uitvoeringen tellen als TotalCount.

SucceededCount with sum as SucceededCount ,

Het aantal geslaagde uitvoeringen tellen als SucceededCount.

FailedCount with sum as FailedCount,

Het aantal mislukte uitvoeringen tellen als FailedCount.

PartiallySucceededCount with sum as PartiallySucceededCount))

Tel het aantal gedeeltelijk geslaagde uitvoeringen als PartiallySucceededCount. Sluiten aggregate() en groupby() componenten.

/compute(

Begin van compute() component.

SucceededCount mul 100.0 div TotalCount as PassRate,

Bereken PassRate elke dag door het aantal geslaagde uitvoeringen te delen op basis van het aantal totale uitvoeringen.

FailedCount mul 100.0 div TotalCount as FailRate,

Bereken FailRate elke dag door het aantal mislukte uitvoeringen te delen op basis van het aantal totale uitvoeringen.

PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate)

Bereken PartiallySuccessfulRate elke dag door het aantal gedeeltelijk geslaagde uitvoeringen te delen op basis van het aantal totale uitvoeringen.

&$orderby=CompletedOn/Date asc

Bestel het resultaat in oplopende volgorde op basis van de datum van de pijplijnuitvoering.

Trend voor de doorvoersnelheid voor een pijplijn-id

De naam van pijplijnen kan worden gewijzigd. Gebruik de pijplijn-id in plaats van de naam van de pijplijn om ervoor te zorgen dat de Power BI-rapporten niet worden verbroken wanneer de naam van de pijplijn wordt gewijzigd. U kunt de pijplijn-id verkrijgen via de URL van de pagina pijplijnenuitvoeringen.

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

De volgende query's retourneren de pijplijnuitvoeringen voor een specifieke pijplijn-id vanaf een opgegeven begindatum.

Kopieer en plak de volgende Power BI-query rechtstreeks in het venster Lege query ophalen>. Zie Overzicht van voorbeeldrapporten met behulp van OData-query's voor meer informatie.

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} "
                &"and CanceledCount ne 1 "
        &") "
        &"/groupby( "
            &"(CompletedOn/Date), "
                &"aggregate "
                &"($count as TotalCount, "
            &"SucceededCount with sum as SucceededCount , "
                &"FailedCount with sum as FailedCount, "
            &"PartiallySucceededCount with sum as PartiallySucceededCount)) "
        &"/compute( "
    &"SucceededCount mul 100.0 div TotalCount as PassRate, "
    &"FailedCount mul 100.0 div TotalCount as FailRate, "
    &"PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate) "
    &"&$orderby=CompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Trend voor wachtwoordsnelheid, filteren op vertakking

Mogelijk wilt u alleen de trend van de wachtwoordfrequentie van een pijplijn voor een bepaalde vertakking bekijken. Als u het rapport wilt maken, voert u de volgende extra stappen uit, samen met wat wordt beschreven in het gegevenstype Kolom wijzigen en de secties Rapport lijndiagram maken.

  • Uitvouwen Branch tot Branch.BranchName.
  • Selecteer Power BI-visualisatieslicer en voeg deze toe aan Branch.BranchName het veld van de slicer.
  • Selecteer de vertakking in de slicer waarvoor u de trend van de wachtwoordfrequentie wilt zien.

Kopieer en plak de volgende Power BI-query rechtstreeks in het venster Lege query ophalen>. Zie Overzicht van voorbeeldrapporten met behulp van OData-query's voor meer informatie.

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} "
                &"and CanceledCount ne 1 "
        &") "
        &"/groupby( "
            &"(Branch/BranchName, CompletedOn/Date), "
                &"aggregate "
                &"($count as TotalCount, "
            &"SucceededCount with sum as SucceededCount , "
                &"FailedCount with sum as FailedCount, "
            &"PartiallySucceededCount with sum as PartiallySucceededCount)) "
        &"/compute( "
    &"SucceededCount mul 100.0 div TotalCount as PassRate, "
    &"FailedCount mul 100.0 div TotalCount as FailRate, "
    &"PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate) "
    &"&$orderby=CompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Trend voor wachtwoordsnelheid, filter op buildreden

U kunt de trend van de wachtwoordfrequentie van een pijplijn alleen voor specifieke buildredenen bekijken (handmatig/batchedCI, pull-aanvraag, enzovoort). Als u het rapport wilt maken, voert u de volgende extra stappen uit, samen met wat wordt beschreven in het gegevenstype Kolom wijzigen en de secties Rapport lijndiagram maken.

  • Selecteer Slicer in het deelvenster Visualisaties en voeg de RunReason slicer toe aan het veld van de slicer.
  • Selecteer de pijplijn in de slicer waarvoor u de doorvoersnelheidstrend wilt zien.

Kopieer en plak de volgende Power BI-query rechtstreeks in het venster Lege query ophalen>. Zie Overzicht van voorbeeldrapporten met behulp van OData-query's voor meer informatie.

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} "
                &"and CanceledCount ne 1 "
        &") "
        &"/groupby( "
            &"(RunReason, CompletedOn/Date), "
                &"aggregate "
                &"($count as TotalCount, "
            &"SucceededCount with sum as SucceededCount , "
                &"FailedCount with sum as FailedCount, "
            &"PartiallySucceededCount with sum as PartiallySucceededCount)) "
        &"/compute( "
    &"SucceededCount mul 100.0 div TotalCount as PassRate, "
    &"FailedCount mul 100.0 div TotalCount as FailRate, "
    &"PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate) "
    &"&$orderby=CompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Trend voor de doorvoersnelheid voor alle projectpijplijnen

Gebruik de volgende query's om de trend van de wachtwoordsnelheid voor alle pijplijnen van het project in één rapport weer te geven. Als u het rapport wilt maken, voert u de volgende extra stappen uit, samen met wat wordt beschreven in het gegevenstype Kolom wijzigen en de secties Rapport lijndiagram maken.

  • Uitvouwen Pipeline tot Pipeline.PipelineName.
  • Selecteer Slicer in het deelvenster Visualisaties en voeg het veld toe aan het veld Pipeline.PipelineNamevan de slicer.
  • Selecteer de build-pijplijn in de slicer waarvoor u de trend van de wachtwoordfrequentie wilt zien.

Raadpleeg het resultaatoverzicht voor alle voorbeeldrapport van pijplijnen met gedetailleerde vergelijkbare stappen, zoals hier is vereist.

Kopieer en plak de volgende Power BI-query rechtstreeks in het venster Lege query ophalen>. Zie Overzicht van voorbeeldrapporten met behulp van OData-query's voor meer informatie.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
        &"$apply=filter( "
                &"CompletedDate ge {startdate} "
                &"and CanceledCount ne 1 "
                &") "
        &"/groupby( "
        &"(Pipeline/PipelineName, CompletedOn/Date), "
            &"aggregate "
                &"($count as TotalCount, "
                &"SucceededCount with sum as SucceededCount , "
            &"FailedCount with sum as FailedCount, "
                &"PartiallySucceededCount with sum as PartiallySucceededCount)) "
            &"/compute( "
        &"SucceededCount mul 100.0 div TotalCount as PassRate, "
    &"FailedCount mul 100.0 div TotalCount as FailRate, "
    &"PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate) "
    &"&$orderby=CompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

(Optioneel) Naam van query wijzigen

U kunt de naam van het standaardquerylabel Query1 wijzigen in iets zinvoller. Voer gewoon een nieuwe naam in het deelvenster Queryinstellingen in.

Schermopname van menuopties voor Power BI-query's, naam van query wijzigen.

Kolommen uitvouwen in Power Query-editor

Voordat u het rapport maakt, moet u kolommen uitvouwen die records met verschillende velden retourneren. In dit geval wilt u de kolom uitbreiden om deze CompletedOn plat CompletedOn.Datete maken.
Zie Transform Analytics-gegevens voor het genereren van Power BI-rapporten voor meer informatie over het uitvouwen van werkitems.

Kolomgegevenstype wijzigen

Wijzig in het menu Transformeren het gegevenstype voor de volgende kolommen. Zie Een kolomgegevenstype transformeren voor meer informatie.

  • PassRateen FailRate PartiallySuccessfulRate kolommen naar Decimaal getal.'
  • TotalCount naar geheel getal.

(Optioneel) Kolomvelden een andere naam geven

U kunt de naam van kolomvelden wijzigen. U kunt bijvoorbeeld de naam van de kolom Pipeline.PipelineName wijzigen in Pipeline Name, of TotalCount in Total Count. Zie Kolomvelden een andere naam geven.

Sluit de query en pas uw wijzigingen toe

Zodra u al uw gegevenstransformaties hebt voltooid, kiest u Sluiten en toepassen in het menu Start om de query op te slaan en terug te keren naar het tabblad Rapport in Power BI.

Schermopname van Power Query-editor optie Sluiten en toepassen.

Het rapport Lijndiagram maken

  1. Kies in Power BI onder Visualisaties het rapport Lijndiagram .

    Schermopname van selecties van visualisatievelden voor het lijndiagram met een lijndiagram voor de doorvoersnelheid.

  2. Toevoegen CompletedOn.Date aan X-as. Klik met de rechtermuisknop op het veld en kies CompletedOn.Date.

  3. Voeg deze PassRate toe aan de Y-as en klik er met de rechtermuisknop op om ervoor te zorgen dat Som is geselecteerd.

  4. Als u de rapporttitel wilt wijzigen, selecteert u het pictogram Uw visuele verfborstel opmaken in het deelvenster Visualisaties, selecteert u Algemeen, vouwt u Titel uit en vervangt u de bestaande tekst.

    In de volgende afbeelding ziet u het resulterende rapport.

    Schermopname van het rapport Pass Rate Trend voor Power BI-voorbeeldpijplijnen.