Metadatareferens för Azure Pipelines Analytics

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Analytics-tjänsten samlar in pipeline- och testaktivitet som genereras via Azure Pipelines. Den här artikeln beskriver de egenskaper som du kan använda för att generera en analysrapport för pipelines. Du använder en kombination av egenskaper för att filtrera en fråga, aggregera data eller skapa en rapport.

Kommentar

Beskrivningar av entiteter, egenskaper och uppräknade typer som stöds av analysdatamodellen tillhandahålls. Det här är ett tidigt utkast. Ge feedback om områden som du vill ha mer information om. Information om hur du kör frågor mot datamodellen finns i Skapa OData-frågor för analys.

Entitetsuppsättningar och entitetstyper

I följande tabell sammanfattas de entitetstyper och entitetsuppsättningar som stöder Azure Pipelines. Alla entitetstyper/entitetsuppsättningar är tillgängliga med förhandsversionen av Analytics v4.0. Analysversion v3.0-preview stöder inte ögonblicksbilder.

EntitySet EntityType beskrivning
Grenar Gren Grundläggande information om grenar som används i tester eller pipelines. En exempelrapport finns i Exempelrapport för statusstatus.
ParallelPipelineJobsSnapshot ParallelPipelineJobsSnapshot (Sammansatt) Stöder förståelse för parallell pipelineförbrukning. Mer information om parallella pipelinetester finns i Köra tester parallellt med hjälp av Visual Studio-testuppgiften.
Pipelines Rörledning Egenskaper för en pipeline.
PipelineJobs PipelineJob Enskilda körningsresultat för ett specifikt test som är associerat med en TestRun
PipelineRuns PipelineRun Körningsinformation för pipelines. En exempelrapport finns i Exempelrapport för pipelineflödestrend.
PipelineRunActivityResults PipelineRunActivityResult Sammanslagen logg över alla steg, steg, jobb och uppgifter i en specifik pipelinekörning. En exempelrapport finns i Exempelrapport för pipelineaktivitetsvaraktighet.
PipelineTasks PipelineTask Egenskaper för uppgifter som används i en pipeline.
TaskAgentPoolSizeSnapshots TaskAgentPoolSizeSnapshot (Sammansatt) Stöder förståelse för poolstorlek, pipelinejobb och samtidighet. Det historiska diagrammet för agentpooler visar hur den här entitetsuppsättningen kan användas.
TaskAgentRequestSnapshots TaskAgentRequestSnapshot (Sammansatt) Stöder rapportering av uppgiftsagentbegäranden.

Grenar

Följande egenskaper är giltiga för entitetsuppsättningen Grenar . Surrogatnycklar som är associerade med Branch inkluderar BranchSK och ProjectSK.

Visningsnamn Namn Datatyp Beskrivning
AnalyticsUpdatedDate Datum/tid Vattenstämpel som anger den senaste gången Analytics-data uppdaterades.
Grennamn BranchName String Namnet som tilldelades en gren när den skapades.
Lagringsplats-ID RepositoryId String Numret som tilldelas till en lagringsplats när det skapas.
Vsts-ID för lagringsplats RepositoryVstsId String Numret som tilldelats till en TFVC-lagringsplats när den skapas.
RepositoryUrl RepositoryUrl String Url:en som definierats för en lagringsplats när den skapas.

Navigeringsegenskaper inkluderar Project och dess referensvillkor ProjectSK.

ParallelPipelineJobsSnapshot

Följande egenskaper är giltiga för entitetsuppsättningen ParallelPipelineJobsSnapshot . Referensnycklar är:

  • IsHosted
  • ParallelismTag
  • SamplingDate
Visningsnamn Namn Datatyp Beskrivning
Värdbaserad eller lokalt installerad IsHosted Booleskt Anger om den parallella pipelinen körs på en Microsoft-värdbaserad agent (True) eller är lokalt installerad (False). Mer information finns i Azure Pipelines-agenter.
Det gick inte att nå alla leverantörer FailedToReachAllProviders Booleskt Anger om jobbkörningen nådde alla leverantörer (Sant) eller inte (falskt).
Antal parallella pipelines-jobb TotalCount Int32 Antalet jobb som körs som en del av ögonblicksbilden.
Antal parallella pipelines minuter TotalMinutes Int32 Antalet minuter som det tar att köra ögonblicksbilden.
Parallellitetstyp ParallelismTag String En tagg som anger vilken typ av parallellitet som är associerad med jobbögonblicksbilden.
Premiumtyp IsPremium Booleskt Anger om den parallella pipelinen är premium (True) eller inte (False).
Exempeldatum SamplingDate Datum/tid Datumet som är associerat med ögonblicksbilden.

Pipelines

Följande egenskaper är giltiga för Pipelines och dess surrogatnyckel PipelineSK.

Visningsnamn Namn Datatyp Beskrivning
Pipeline-ID PipelineId Int32 Det ID som tilldelats till pipelinen.
Pipelinenamn PipelineName String Namnet som tilldelats pipelinen.
Pipelineversion PipelineVersion Int32 Den version som är associerad med pipelinen.
Processtyp för pipeline PipelineProcessType Enumerated Typ av pipelinedefinition. Giltiga värden visas nedan för PipelineProcessType.

Navigeringsegenskaper inkluderar Project och dess referensvillkor ProjectSK.

PipelineProcessType-uppräknade typmedlemmar

Följande medlemmar definieras för den PipelineProcessType uppräknade typen som anger vilken metod som används för att definiera pipelinen.

Medlemsnamn Värde Definition
Designer 1 Klassisk pipelinedefinition.
Yaml 2 YAML-pipelinedefinition.
Docker 3 Docker-pipelinedefinition.

PipelineJobs

Ett pipelinejobb är en serie steg som körs sekventiellt som en enhet. Ett jobb är den minsta arbetsenheten som du kan schemalägga för att köra. Pipelines organiseras runt jobb och varje pipeline har minst ett jobb. Mer information finns i Ange jobb i din pipeline.

Följande egenskaper är giltiga för PipelineJobs och dess PipelineJobSK surrogatnyckel.

Visningsnamn Namn Datatyp Beskrivning
Fullständigt namn på pipelinejobb FullJobName String Det fullständiga namnet på ett pipelinejobb.
Pipeline-ID PipelineId Int32 Det ID som tilldelats pipelinen där jobbet har definierats.
Identifierare för pipelinejobb JobId String Jobbidentifieraren som tilldelats ett pipelinejobb när det skapas.
Namn på pipelinejobb JobName String Namnet som tilldelats pipelinejobbet.
Namn på pipelinesteg StageName String Det fasnamn som är associerat med pipelinejobbet.
Pipeline-jobbstrategiattribut StrategyAttributes String Attributen som definierats för pipelinejobbet.
Stegidentifierare StageId String Stegidentifieraren som är associerad med pipelinejobbet.

Navigeringsegenskaper inkluderar Project och dess referensvillkor ProjectSK.

En exempelrapport som frågar pipelinejob-entitetstypen finns i Exempelrapport för pipelinestegsvis fel.

Pipelinekörningar

En pipelinekörning representerar en enda körning av en pipeline. Under en körning bearbetas pipelinen och agenter bearbetar ett eller flera jobb. En pipelinekörning innehåller jobb, steg och uppgifter. Mer information finns i Pipeline-körningssekvens.

Följande egenskaper är giltiga för entitetstypen PipelineRun och dess PipelineRunSK surrogatnyckel.

Visningsnamn Namn Datatyp Beskrivning
Antal avbrutna CanceledCount Int32 Antalet pipelinekörningar som avbröts.
Slutfört den CompletedDate Datum/tid Datum och tid när pipelinen slutför körningen.
Antal misslyckade FailedCount Int32 Antalet pipelinekörningar som lyckades.
Nummerrevision RunNumberRevision Int32 Numret som tilldelats en pipelinekörning med sekventiella körningar.
Delvis lyckat antal PartiallySucceededCount Int32 Antalet pipelinekörningar som delvis lyckades.
Pipelinekörnings-ID PipelineRunId Int32 Numret som tilldelats en pipelinekörning.
Köat datum QueuedDate Datum/tid Datum och tid då pipelinen stod i kö för att köras.
Kövaraktighet sekunder QueueDurationSeconds Decimal Antalet sekunder som pipelinen fanns kvar i kön.
Körningsnummer RunNumber String Numret som tilldelats en pipelinekörning när den körs.
Körningsresultat RunOutcome Enumerated Resultatet som tilldelats en pipeline när körningen har slutförts. Giltiga värden visas nedan för PipelineRunOutcome.
Körningsorsak RunReason Enumerated Villkoret som gjorde att pipelinen kördes. Giltiga värden visas nedan för PipelineRunReason.
Körningsvaraktighet sekunder RunDurationSeconds Decimal Antalet sekunder som det tog för pipelinekörningen att slutföras.
Startdatum StartedDate Datum/tid Datum och tid då pipelinekörningen började.
Antal lyckade SucceededCount Int32 Antalet pipelinekörningar som lyckades.
Totalt antal varaktighetssekunder TotalDurationSeconds Decimal Det totala antalet sekunder som pipelinen fanns i kön och kördes.

Följande navigeringsegenskaper stöds.

Visningsnamn Name -Referensvillkor Refererad egenskap
Gren Branch BranchSK BranchSK
Slutförd den CompletedOn CompletedDateSK DateSK
Köad på QueuedOn QueuedDateSK DateSK
Startad på StartedOn QueuedDateSK DateSK
Rörledning Pipeline PipelineSK PipelineSK
Projekt Project ProjectSK ProjectSK

PipelineRunReason-uppräknade typmedlemmar

Följande medlemmar definieras för den PipelineRunReason uppräknade typen som anger under vilka villkor varje pipelinesteg, jobb eller steg körs enligt beskrivningen i Ange villkor.

Medlemsnamn Värde Visningsnamn
None 0 Ingen
Manual 1 Manuell
IndividualCI 2 Individuell CI
BatchedCI 4 Batchbaserad CI
Schedule 8 Schema
UserCreated 32 Användaren har skapats
ValidateShelveset 64 Validera hyllor
CheckInShelveset 128 Checka in hyllor
PullRequest 256 Pull-begäran
PipelineRunCompletion 512 Bygge har slutförts

PipelineRunOutcome-uppräknade typmedlemmar

Följande medlemmar definieras för den PipelineRunOutcome uppräknade typen som anger resultatet av en pipelinekörning.

Medlemsnamn Värde Visningsnamn
None 0 Ingen
Succeed 2 Lyckas
PartiallySucceeded 4 Delvis slutförd
Failed 6 Misslyckad
Canceled 32 Avbruten

PipelineRunActivityResults

Följande egenskaper är giltiga för entitetsuppsättningen PipelineRunActivityResults och dess PipelineRunActivityResultSK surrogatnyckel.

Många egenskaper är datumbaserade eller användarbaserade. De här egenskaperna är associerade med entitetsuppsättningarna CalendarDate och User som beskrivs i Referens för kalenderdatum, Projekt och Användarmetadata.

Visningsnamn Namn Datatyp Beskrivning
Övergivet antal AbandonedCount Int32 Antalet pipelinekörningar som har markerats som övergivna.
Aktivitet slutfört datum ActivityCompletedDate Datum/tid Datum och tid när pipelinekörningen slutför körningen.
Sekunder för aktivitetsvaraktighet ActivityDurationSeconds Decimal Det totala antalet sekunder som pipelinen fanns i kön och kördes.
Startdatum för aktivitet ActivityStartedDate Datum/tid Datum då pipelinekörningen startade.
Antal avbrutna CanceledCount Int32 Antalet pipelinekörningar som avbröts.
Antal misslyckade FailedCount Int32 Antalet pipelinekörningar som misslyckades.
Typ av pipelineaktivitet ActivityType Enumerated Typen av pipelineaktivitet. Giltiga värden visas nedan för PipelineActivityType.
Pipelinekörnings-ID PipelineRunId Int32 Numret som tilldelats en pipelinekörning när den körs.
Utfall för pipelinekörning PipelineRunOutcome Enumerated Resultatet som tilldelats en pipeline när körningen har slutförts. Giltiga värden visas under PipelineRunOutcome.
Relativ starttid från jobbsekunder RelativeStartTimeFromJobSeconds Int32 Antalet sekunder som förflutit från början av jobbet.
Relativ starttid från fassekunder RelativeStartTimeFromStageSeconds Int32 Antalet sekunder som förflutit från början av fasen.
Relativ starttid från körningssekunder RelativeStartTimeFromRunSeconds Int32 Antalet sekunder som förflutit från när körningen kördes.
Överhoppat antal SkippedCount Int32 Antalet pipelinekörningar som hoppades över.
Antal lyckade SucceededCount Int32 Antalet pipelinekörningar som lyckades.
Lyckades med antal problem SucceededWithIssuesCount Int32 Antalet pipelinekörningar som delvis lyckades.
Uppgiftsvisningsnamn TaskDisplayName String Namnet på en uppgift som körs i pipelinekörningen.
Sökväg till aktivitetslogg TaskLogPath String Sökvägen till loggfilen som genereras av en uppgift.
Aktivitetsresultat TaskOutcome Anpassat Resultatet av uppgiften som kördes.

Exempelrapporter som kör frågor mot entitetstypen PipelineRunActivityResult finns i Exempelrapport för pipelineaktivitetens varaktighetstrend.

Navigeringsegenskaperna innehåller de som anges i följande tabell.

Visningsnamn Namn Referensvillkor Refererad egenskap
Aktiviteten startades den ActivityStartedOn ActivityStartedDateSK DateSK
Gren Branch BranchSK BranchSK
Rörledning Pipeline PipelineSK PipelineSK
Pipelineaktivitet PipelineTask PipelineTaskSK PipelineTaskSK
Pipelinejobb PipelineJob PipelineJobSK PipelineJobSK
Pipelinekörning i kö på PipelineRunQueuedOn PipelineRunQueuedDateSK DateSK
Pipelinekörningen startades på PipelineRunStartedOn PipelineRunStartedDateSK DateSK
Pipelinekörningen har slutförts på PipelineRunCompletedOn PipelineRunCompletedDateSK DateSK
Pipelinekörningen startades på PipelineRunStartedOn PipelineRunStartedDateSK DateSK
Projekt Project ProjectSK ProjectSK

PipelineActivityType-uppräknade typmedlemmar

Följande medlemmar definieras för den PipelineActivityType uppräknade typen.

Medlemsnamn Värde Visningsnamn
Task 0 Uppgift
Approval 1 Godkännande
AgentWait 2 Agentvänte

PipelineTasks

Följande egenskaper är giltiga för PipelineTasks-entitetsuppsättningen och dess surrogatnyckel PipelineTaskSK.

Visningsnamn Namn Datatyp Beskrivning
Aktivitetsdefinitions-ID TaskDefinitionId GUID GUID som tilldelats en pipelineaktivitet.
Uppgiftsdefinitionsversion TaskDefinitionVersion String Den version som tilldelats en pipelineaktivitet.

Navigeringsegenskaper inkluderar Project och dess referensvillkor ProjectSK.

TaskAgentPoolSizeSnapshots

Följande egenskaper är giltiga för entitetsuppsättningen TaskAgentPoolSizeSnapshots och dess surrogatnyckel SamplingDate.

Visningsnamn Egenskapsnamn Datatyp Beskrivning
Antal online OnlineCount Int32 Antalet agenter online i agentpoolen när aktiviteten kördes.
Antal offline OfflineCount Int32 Antalet agenter offline i agentpoolen när aktiviteten kördes.
Pool-ID PoolId Int32 Numret som tilldelats till agentpoolen.
Exempeldatum SamplingDate Datum/tid Datum och tid då poolstorleken snappades.

En exempelrapport som är byggd av entiteten TaskAgentPoolSizeSnapshot finns i Historisk graf för agentpooler (förhandsversion).

TaskAgentRequestSnapshots

Agentpooler allokeras när en uppgift körs. Entitetsuppsättningen TaskAgentRequestSnapshots samlar in data som är relaterade till uppgiftsagentbegäranden.

Följande egenskaper är giltiga för entitetstypen TaskAgentRequestSnapshot och dess surrogatnycklar SamplingTime och SamplingDateSK.

Visningsnamn Namn Datatyp Beskrivning
Skapa i kö IsQueued Booleskt Anger om bygget är i kö (Sant) eller inte i kö (falskt).
Build Running IsRunning Booleskt Anger om bygget körs (Sant) eller inte körs (false).
Värdbaserad eller lokalt installerad IsHosted Booleskt Anger om agenten som tilldelats uppgiften är värdbaserad (Sant) eller lokalt värdbaserad (false).
Jobbets slutdatum FinishedDate Datum/tid Datum då uppgiftsagentens begäran har körts.
FinishedDateSK Int32 Det datum då uppgiftsagentens begäran slutfördes, uttryckt som i den tidszon som YYYYMMDD definierats för organisationen.
Köat datum QueuedDate Datum/tid Datum då uppgiftsagentens begäran köades.
QueuedDateSK Int32 Det datum då uppgiftsagentens begäran köades, uttryckt som i den tidszon som YYYYMMDD definierats för organisationen.
Kövaraktighet sekunder QueueDurationSeconds Decimal Antalet sekunder som uppgiftsagentens begäran fanns kvar i kön innan en agent tilldelades.
Pool-ID PoolId Int32 Numret som tilldelats till agentpoolen som tilldelats uppgiftsagentbegäran.
Pipelinetyp PipelineType String Pipelinetypen som innehåller uppgiftsagentens begäran.
Begärande-ID RequestId Int64 Numret som tilldelats uppgiftsagentens begäran.
Exempeltimmes SamplingHour Int32 Det nummer som tilldelades till timme när begäran togs emot.
Exempeltid SamplingTime Datum/tid Datum då uppgiftsagentens begäran togs emot.
Startdatum StartedDate Datum/tid Datum då uppgiftsagentens begäran kördes.
StartedDateSK Int32 Det datum då uppgiftsagentens begäran startade körningen, uttryckt som i den tidszon som YYYYMMDD definierats för organisationen.

Navigeringsegenskaperna innehåller de som anges i följande tabell.

Visningsnamn Name Referensvillkor -Refererad egenskap
Gren Branch BranchSK BranchSK
Slutförd den CompletedOn CompletedDateSK DateSK
Jobbsluttid FinishedOn FinishedDateSK DateSK
Köad på QueuedOn QueuedDateSK DateSK
Rörledning Pipeline PipelineSK PipelineSK
Projekt Project ProjectSK ProjectSK
Startad på StartedOn QueuedDateSK DateSK