Dela via

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 Entitetstyp beskrivning
Grenar Gren Information om grundläggande grenar som används i testprocesser eller pipelines. För en exempelrapport, se Exempelrapport för statusförlopp.
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 Pipeline-egenskaper
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. För en exempelrapport, se Exempelrapport för varaktighet av pipelineuppgifter.
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 parallellitet. Det historiska diagrammet för agentpooler visar hur den här entitetsuppsättningen kan användas.
TaskAgentRequestSnapshots TaskAgentRequestSnapshot (Sammansatt) Stöder rapportering av förfrågningar från uppgiftsagenter.

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 Sträng Namnet som tilldelades en gren när den skapades.
Lagringsplats-ID RepositoryId Sträng 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 sträng 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
Hostad eller självhärbärgerad IsHosted Booleskt Anger om den parallella pipelinen körs på en Microsoft-värdad agent (True) eller är lokalt installerad (False). Mer information finns i Azure Pipelines-agenter.
Det gick inte att nå alla leverantörer FailedToReachAllProviders Boolean 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 Sträng En tagg som anger vilken typ av parallellitet som är associerad med jobbögonblicksbilden.
Premiumtyp IsPremium Booleskt Anger om parallellpipelinen ä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 Sträng Namnet som tilldelats pipelinen.
Pipeline-version PipelineVersion Int32 Den version som är kopplad till rörledningen.
Processtyp för pipeline PipelineProcessType Uppräknad 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-rördefinition.
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 är organiserade 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
Pipeline Jobbets Fullständiga Namn FullJobName Sträng Det fullständiga namnet på ett pipeline-jobb.
Pipeline-ID PipelineId Int32 Det ID som tilldelats den pipeline där jobbet har definierats.
Pipelinejobbidentifierare JobId Sträng Jobbidentifieraren som tilldelats ett pipelinejobb vid skapandet.
Pipeline-jobbnamn JobName Sträng Namnet som tilldelats pipelinejobbet.
Pipelinestegnamn StageName String Det fasnamn som är associerat med pipelinejobbet.
Strategiattribut för pipeline-jobb StrategyAttributes Sträng Attributen som definierats för pipelinejobbet.
Stegidentifierare StageId Sträng Stegidentifieraren som är associerad med pipelinejobbet.

Navigeringsegenskaper inkluderar Project och dess referensvillkor ProjectSK.

Använd en exempelrapport som frågar efter entitytypen PipelineJob, se Exempelrapport för pipelinestegsvisa 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 avbokningar CanceledCount Int32 Antalet pipelinekörningar som avbröts.
Slutförande datum CompletedDate Datum/tid Datum och tid när pipelinen har avslutat sin körning.
Antal misslyckade FailedCount Int32 Antalet pipelinelopp som lyckades.
Nummerrevision RunNumberRevision Int32 Numret som har tilldelats en körning av en pipeline med sekventiella exekveringar.
Delvis lyckat antal PartiallySucceededCount Int32 Antalet pipelinekörningar som delvis lyckades.
Pipelinekörnings-ID PipelineRunId Int32 Numret som tilldelats en pipelinekörning.
Ködatum QueuedDate Datum/tid Datum och tid då pipelinen sattes i kö för att köras.
Kövaraktighet sekunder QueueDurationSeconds Decimal Antalet sekunder som pipelinen stod kvar i kön.
Körningsnummer RunNumber Sträng Numret som tilldelats en pipelinekörning när den körs.
Körningsresultat RunOutcome Uppräknad Resultatet som tilldelas en pipeline när dess körning har slutförts. Giltiga värden visas nedan för PipelineRunOutcome.
Körningsorsak RunReason Uppräknad Villkoret som fick pipelinen att köras. 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.
Lyckat antal SucceededCount Int32 Antalet pipelinekörningar som lyckades.
Totalt antal varaktighetssekunder TotalDurationSeconds Decimal Det totala antalet sekunder som rörledningen fanns i kön samt kördes.

Följande navigeringsegenskaper stöds.

Visningsnamn Name -Referensbegränsning Refererad egenskap
Filial Branch BranchSK BranchSK
Slutförd 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 Shelveset
CheckInShelveset 128 Checka in Shelveset
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 lyckades
Failed 6 Misslyckad
Canceled 32 Avbruten

ResultatFörPipelineKörningsAktivitet

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 avslutas.
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 och tid då pipelinekörningen startade.
Antal avbrutna CanceledCount Int32 Antalet avbrutna pipelinekörningar.
Antal misslyckanden FailedCount Int32 Antalet pipelinekörningar som misslyckades.
Typ av pipelineaktivitet ActivityType Uppräknad 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 Uppräknad Resultatet som tilldelats en pipeline när körningen har slutförts. Giltiga värden visas under PipelineRunOutcome.
Relativ starttid i förhållande till jobbsekunder RelativeStartTimeFromJobSeconds Int32 Antalet sekunder som förflutit från början av jobbet.
Relativ starttid från stegsekunder RelativeStartTimeFromStageSeconds Int32 Antalet sekunder som förflutit från början av fasen.
Relativ starttid från körningssekunder RelativeStartTimeFromRunSeconds Int32 Antalet sekunder som gått sedan körningen utfördes.
Överhoppat antal SkippedCount Int32 Antalet pipelinekörningar som hoppades över.
Antal lyckade resultat SucceededCount Int32 Antalet pipelinekörningar som lyckades.
Lyckades med problemantal SucceededWithIssuesCount Int32 Antalet pipelinekörningar som delvis lyckades.
Uppgiftsvisningsnamn TaskDisplayName Sträng Namnet på en uppgift som körs i pipelinekörningen.
Sökväg till aktivitetslogg TaskLogPath Sträng Sökvägen till loggfilen som genereras av en process.
Aktivitetsresultat TaskOutcome Anpassat Resultatet av den utförda uppgiften.

Exempelrapporter som gör förfrågningar mot entitetstypen PipelineRunActivityResult finns i Exempelrapport för trend av pipelineaktivitetens varaktighet.

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
Pipelineuppgift PipelineTask PipelineTaskSK PipelineTaskSK
Pipelinejobb PipelineJob PipelineJobSK PipelineJobSK
Pipelineskörning i kö PipelineRunQueuedOn PipelineRunQueuedDateSK DateSK
Pipelinekörningen startades på PipelineRunStartedOn PipelineRunStartedDateSK DateSK
Pipelinekörningen har slutförts på PipelineRunCompletedOn PipelineRunCompletedDateSK DateSK
Pipelinekörningen startades 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 Agent Väntan

Pipeline-uppgifter

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

Visningsnamn Namn Datatyp Beskrivning
Aktivitetsdefinitions-ID TaskDefinitionId GUID En GUID som tilldelats en pipelineuppgift.
Version av Uppgiftsdefinition TaskDefinitionVersion Sträng Den version som tilldelats till en pipelineaktivitet.

Navigeringsegenskaper inkluderar Project och dess referensvillkor ProjectSK.

UppgifterAgentPoolStorlekÖgonblicksbilder

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.
Offline antal 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

Agentpoolerna allokeras när en uppgift utfö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 Boolean Anger om bygget är i kö (Sant) eller inte i kö (falskt).
Build Running IsRunning Booleskt Indikerar om bygget körs (Sant) eller inte körs (Falskt).
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 och tid när uppgiftsagentens begäran avslutades.
FinishedDateSK Int32 Det datum då uppgiftsagentens begäran slutfördes, uttryckt som YYYYMMDD i den tidszon som definierats för organisationen.
Ködatum QueuedDate Datum/tid Datum och tid då uppgiftsagentens begäran köades.
QueuedDateSK Int32 Det datum då uppgiftsagentens begäran köades, uttryckt som YYYYMMDD i den tidszon som definierats för organisationen.
Kövaraktighet sekunder QueueDurationSeconds Decimal Antalet sekunder som uppdragsagentens begäran befann sig i kön innan en agent tilldelades.
Pool-ID PoolId Int32 Numret som tilldelats agentpoolen för uppgiftsagentens begäran.
Pipelinetyp PipelineType Sträng Typ av pipeline som innehåller uppgiftsagentens begäran.
Begärande-ID RequestId Int64 Numret som tilldelats uppgiftsagentens begäran.
Exempeltimme SamplingHour Int32 Det nummer som tilldelades till timme när begäran togs emot.
Exempeltid SamplingTime Datum/tid Datum och tid när uppgiftsagentens begäran togs emot.
Startdatum StartedDate Datum/tid Datum och tid då uppgiftsagentens begäran kördes.
StartedDateSK Int32 Det datum då begäran från uppgiftsagenten började verkställas, uttryckt som YYYYMMDD i den tidszon som definierats för organisationen.

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

Visningsnamn Name Referensbegränsning -Refererad egenskap
Gren Branch BranchSK BranchSK
Slutförd Den CompletedOn CompletedDateSK DateSK
Jobbsluttid FinishedOn FinishedDateSK DateSK
I kö på QueuedOn QueuedDateSK DateSK
Pipeline Pipeline PipelineSK PipelineSK
Projekt Project ProjectSK ProjectSK
Startad på StartedOn QueuedDateSK DateSK