Dela via

Exempelrapport för exempel på pipelinestegsfel

  • Artikel

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

Den här artikeln visar hur du skapar en rapport om en pipelines dagliga fasfel. Den här rapporten liknar diagrammet "Feltrend" i rapporten pipelinepassfrekvens.

Följande bild visar ett exempel på en rapport om stegvisa fel för en specifik pipeline från oktober 2022 till 15 december 2022.

Skärmbild av rapporten med stegvisa fel i en staplad kolumn i Power BI Pipelines.

Viktigt!

Power BI-integrering och åtkomst till OData-flödet i Analytics Service är allmänt tillgängliga för Azure DevOps Services och Azure DevOps Server 2020 och senare versioner. Exempelfrågorna i den här artikeln är endast giltiga mot Azure DevOps Server 2020 och senare versioner och är beroende av v3.0-förhandsversion eller senare version. Vi rekommenderar att du använder dessa frågor och ger oss feedback.

Förutsättningar

  • Om du vill visa analysdata och fråga tjänsten måste du vara medlem i ett projekt med grundläggande åtkomst eller större. Som standard beviljas alla projektmedlemmar behörighet att köra frågor mot Analytics och definiera analysvyer.
  • Mer information om andra förutsättningar för tjänst- och funktionsaktivering och allmänna dataspårningsaktiviteter finns i Behörigheter och krav för åtkomst till analys.

Kommentar

Den här artikeln förutsätter att du har läst Översikt över exempelrapporter med OData-frågor och har en grundläggande förståelse för Power BI.

Exempelfrågor

Trendrapporter för scen-, aktivitets- eller jobbfel kan skapas genom att fråga entitetsuppsättningen PipelineRunActivityResults .

Kommentar

Information om hur du fastställer tillgängliga egenskaper för filter- eller rapportändamål finns i Metadatareferens för Azure Pipelines. Du kan filtrera dina frågor eller returnera egenskaper med något av värdena Property under ett EntityType eller NavigationPropertyBinding Path flera värden som är tillgängliga med en EntitySet. Var och EntitySet en motsvarar en EntityType. Mer information om datatypen för varje värde finns i metadata för motsvarande EntityType.

Trend för stegvisa fel

Om du vill visa trend för stegvisa fel för en specifik pipeline från ett angivet datum använder du följande frågor.

Du kan klistra in Power BI-frågan nedan direkt i fönstret Hämta data-tom> fråga . Mer information finns i Översikt över exempelrapporter med OData-frågor.

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

Ersättningssträngar och frågeuppdelning

Ersätt följande strängar med dina värden. Ta inte med hakparenteser {} med din ersättning. Om ditt organisationsnamn till exempel är "Fabrikam" ersätter du {organization} med Fabrikam, inte {Fabrikam}.

  • {organization} – Organisationens namn
  • {project} – Namnet på ditt teamprojekt
  • {pipelinename} - Ditt pipelinenamn. Exempel: Fabrikam hourly build pipeline
  • {startdate} - Datumet då rapporten skulle startas. Format: ÅÅÅÅ-MM-DDZ. Exempel: 2021-09-01Z representerar 1 september 2021. Omslut inte citattecken eller hakparenteser och använd inte två siffror för både månad och datum.

Frågeuppdelning

I följande tabell beskrivs varje del av frågan.

Frågedel

Beskrivning

$apply=filter(

Start-sats filter() .

Pipeline/PipelineName eq '{pipelinename}'

Returnera aktivitetsresultat för en specifik pipeline.

and PipelineRunCompletedOn/Date ge {startdate}

Returnera aktivitetsresultat för pipelinekörningar på eller efter det angivna datumet.

and PipelineRunOutcome eq 'Failed'

Returnera aktivitetsresultat där byggresultatet misslyckades.

and TaskOutcome eq 'Failed'

Returnera aktivitetsresultat där aktivitetsresultatet misslyckades.

)

Stäng-satsen filter .

/groupby(

Start-sats groupby() .

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

Gruppera efter datum då pipelinekörningen har slutförts, bygg-ID och fasnamn.

aggregate (FailedCount with sum as FailedCount))

För varje dag skapar du ID och steg. räkna det totala antalet fel. Det blir det totala antalet aktivitetsfel och inte fasfel.

/groupby(

Start-sats groupby() .

(PipelineRunCompletedOn/Date, PipelineJob/StageName ),

Gruppera efter dag och fasnamn.

aggregate

Start-sats aggregate .

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

För varje dag summerar du antalet gånger som ett steg misslyckades och stänger aggregate sedan satsen.

Trend för aktivitetsvis misslyckande

Om du vill visa trend för aktivitetsvisa fel använder du följande frågor.

Du kan klistra in Power BI-frågan nedan direkt i fönstret Hämta data-tom> fråga . Mer information finns i Översikt över exempelrapporter med OData-frågor.

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

Jobbvis feltrend

Om du vill visa trenden för jobbvisa fel använder du följande frågor.

Du kan klistra in Power BI-frågan nedan direkt i fönstret Hämta data-tom> fråga . Mer information finns i Översikt över exempelrapporter med OData-frågor.

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

(Valfritt) Byt namn på fråga

Du kan byta namn på standardfrågans etikett, Query1, till något mer meningsfullt. Ange bara ett nytt namn från fönstret Fråga Inställningar.

Skärmbild av alternativ för Power BI-frågemenyer, byt namn på fråga.

Expandera kolumner i Power Query-redigeraren

Innan du skapar rapporten måste du expandera följande två kolumner. Information om hur du expanderar arbetsobjekt finns i Transformera analysdata för att generera Power BI-rapporter.

  • Expandera PipelineJob till PipelineJob.StageName
  • Expandera PipelineRunCompletedOn till PipelineRunCompletedOn.Date

Ändra kolumndatatyp

På menyn Transformera ändrar du datatypen för FailedStageCount kolumnen till Vem läsnummer. Mer information finns i Transformera en kolumndatatyp.

(Valfritt) Byt namn på kolumnfält

Du kan byta namn på kolumnfält till de som är mer användarvänliga. Du kan till exempel byta namn på kolumnen Pipeline.PipelineName till Pipeline Nameeller TotalCount till Total Count. Mer information finns i Byt namn på kolumnfält.

Stäng frågan och tillämpa ändringarna

När du har slutfört alla dina datatransformeringar väljer du Stäng och använd på startmenyn för att spara frågan och återgå till fliken Rapport i Power BI.

Skärmbild av alternativet stäng och tillämpa Power Query-redigeraren.

Skapa rapporten staplat stapeldiagram

  1. Under Visualiseringar i Power BI väljer du rapporten Staplat stapeldiagram. I följande exempel förutsätts att ingen har bytt namn på några kolumner.

    Skärmbild av val av visualiseringsfält för stegvisa fel i rapporten Staplat stapeldiagram.

  2. Lägg till PipelineRunCompletedOn.Date i X-axeln, högerklicka på den och välj PipelineRunCompletedOn.Date i stället för Datumhierarki.

  3. Lägg till FailedStagedCount i Y-axelns högerklicka på den och se till att Summa är markerat.

  4. Lägg till PipelineJob.StageName i Förklaring.

  5. Om du vill ändra rapportens rubrik, förklaring eller andra visuella rapportobjekt väljer du ikonen Formatera din visuella pensel i fönstret Visualiseringar och justerar en eller flera inställningar.

Rapporten bör se ut ungefär som i följande bild.

Skärmbild av exempel på fel i en stående kolumn i Power BI-pipelines.