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.

Anteckning

Beskrivningar av de 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 Description
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 av parallell pipelineförbrukning. Mer information om parallella pipelinetester finns i Köra tester parallellt med Visual Studio-testuppgiften.
Pipelines Pipeline Egenskaper för en pipeline.
PipelineJobs PipelineJob Enskilda körningsresultat för ett specifikt test som är associerat med en TestRun
PipelineRuns PipelineKör Körningsinformation för pipelines. En exempelrapport finns i Exempelrapport för pipelineflödestrend.
PipelineRunActivityResults PipelineRunActivityResult Sammanslagen logg över alla faser, steg, jobb och uppgifter i en specifik pipelinekörning. En exempelrapport finns i Exempelrapport om varaktighet för pipelineaktivitet.
PipelineTasks PipelineTask Egenskaper för aktiviteter som används i en pipeline.
TaskAgentPoolSizeSnapshots TaskAgentPoolSizeSnapshot (Sammansatt) Stöder förståelse för poolstorlek, pipelinejobb och samtidighet. Diagrammet Historisk för agentpooler illustrerar 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 DateTime Vattenstämpel som anger den senaste gången Analytics-data uppdaterades.
Namn på förgrening BranchName Sträng Namnet som tilldelas till en gren när den skapas.
Lagringsplats-ID RepositoryId Sträng Numret som tilldelas till en lagringsplats när den skapas.
Vsts-ID för lagringsplats RepositoryVstsId Sträng Numret som tilldelas 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
Värdbaserad eller lokalt installerad IsHosted Boolesk 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 Boolesk Anger om jobbkörningen har nått alla providrar (Sant) eller inte (falskt).
Antal parallella pipelines-jobb TotalCount Int32 Antalet jobb som körs som en del av ögonblicksbilden.
Antal parallella pipelines i 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 Boolesk Anger om den parallella pipelinen är premium (Sant) eller inte (falskt).
Exempeldatum SamplingDate DateTime 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 till 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 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 jobbnamn för pipeline FullJobName Sträng Det fullständiga namnet på ett pipelinejobb.
Pipeline-ID PipelineId Int32 Det ID som tilldelats till pipelinen där jobbet har definierats.
Identifierare för pipelinejobb JobId Sträng Jobbidentifieraren som tilldelats ett pipelinejobb när det skapas.
Namn på pipelinejobb JobName Sträng Namnet som tilldelats pipelinejobbet.
Namn på pipelinesteg StageName Sträng Det fasnamn som är associerat med pipelinejobbet.
Attribut för pipelinejobbstrategi StrategyAttributes Sträng Attributen som definierats för pipelinejobbet.
Stegidentifierare StageId Sträng Fasidentifieraren som är associerad med pipelinejobbet.

Navigeringsegenskaper inkluderar Project och dess referensvillkor ProjectSK.

En exempelrapport som frågar entitetstypen PipelineJob finns i Exempelrapport för pipelinestegsvisa fel.

PipelineRuns

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 datum CompletedDate DateTime 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 till en pipelinekörning med sekventiella körningar.
Delvis lyckat antal PartiallySucceededCount Int32 Antalet pipelinekörningar som delvis lyckades.
Körnings-ID för pipeline PipelineRunId Int32 Numret som tilldelats till en pipelinekörning.
Köat datum QueuedDate DateTime 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 Sträng Numret som tilldelas till en pipeline körs när den körs.
Körningsresultat RunOutcome Enumerated Resultatet som tilldelats till 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 det tog för pipelinekörningen att slutföras.
Startdatum StartedDate DateTime Datum och tid då pipelinekörningen påbörjades.
Antal lyckade SucceededCount Int32 Antalet pipelinekörningar som lyckades.
Total varaktighet sekunder TotalDurationSeconds Decimal Det totala antalet sekunder som pipelinen fanns i kön och kördes.

Följande navigeringsegenskaper stöds.

Visningsnamn Namn -Referensvillkor Refererad egenskap
Gren Branch BranchSK BranchSK
Slutförd den CompletedOn CompletedDateSK DateSK
I kö på QueuedOn QueuedDateSK DateSK
Startad StartedOn QueuedDateSK DateSK
Pipeline Pipeline PipelineSK PipelineSK
Project Project ProjectSK ProjectSK

PipelineRunReason-uppräknade typmedlemmar

Följande medlemmar definieras för den PipelineRunReason uppräknade typen som anger under vilka villkor varje pipelinefas, 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 Batch-CI
Schedule 8 Schema
UserCreated 32 Användaren har skapats
ValidateShelveset 64 Validera hyllor
CheckInShelveset 128 Incheckning Shelveset
PullRequest 256 Pull-begäran
PipelineRunCompletion 512 Bygget slutförs

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 Avbrutna

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 DateTime Datum och tid när pipelinekörningen slutför körningen.
Aktivitetsvaraktighet sekunder ActivityDurationSeconds Decimal Det totala antalet sekunder som pipelinen fanns i kön och kördes.
Startdatum för aktivitet ActivityStartedDate DateTime Datum när 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 tilldelas till en pipelinekörning när den körs.
Resultat av pipelinekörning PipelineRunOutcome Enumerated Resultatet som tilldelats till 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 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 förflutit från när körningen kördes.
Antal överhoppade 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.
Visningsnamn för aktivitet TaskDisplayName Sträng Namnet på en aktivitet som körs i pipelinekörningen.
Sökväg till aktivitetslogg TaskLogPath Sträng Sökvägen till loggfilen som genereras av en aktivitet.
Aktivitetsresultat TaskOutcome Anpassat Resultatet av den aktivitet som kördes.

Exempelrapporter som frågar entitetstypen PipelineRunActivityResult finns i Exempelrapport om pipelineaktivitetens varaktighetstrend.

Navigeringsegenskaper inkluderar de som anges i följande tabell.

Visningsnamn Namn Referensvillkor Refererad egenskap
Aktiviteten startades den ActivityStartedOn ActivityStartedDateSK DateSK
Gren Branch BranchSK BranchSK
Pipeline Pipeline PipelineSK PipelineSK
Pipelineaktivitet PipelineTask PipelineTaskSK PipelineTaskSK
Pipelinejobb PipelineJob PipelineJobSK PipelineJobSK
Pipelinekörning i kö på PipelineRunQueuedOn PipelineRunQueuedDateSK DateSK
Pipelinekörningen startades PipelineRunStartedOn PipelineRunStartedDateSK DateSK
Pipelinekörningen har slutförts PipelineRunCompletedOn PipelineRunCompletedDateSK DateSK
Pipelinekörningen startades PipelineRunStartedOn PipelineRunStartedDateSK DateSK
Project 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 till en pipeline-uppgift.
Uppgiftsdefinitionsversion TaskDefinitionVersion Sträng Den version som tilldelats till 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 uppgiften kördes.
Antal offline OfflineCount Int32 Antalet agenter offline i agentpoolen när aktiviteten kördes.
Pool-ID PoolId Int32 Numret som tilldelats agentpoolen.
Exempeldatum SamplingDate DateTime Datum och tid då poolstorleken snappades.

En exempelrapport som skapats 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 Boolesk Anger om versionen är i kö (Sant) eller inte i kö (falskt).
Build Running IsRunning Boolesk Anger om versionen körs (Sant) eller inte körs (false).
Värdbaserad eller lokalt installerad IsHosted Boolesk Anger om agenten som tilldelats uppgiften är värdbaserad (Sant) eller lokalt installerad (false).
Jobbslutdatum FinishedDate DateTime Datum när 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 DateTime Datum när 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 uppgiftsagentens begäran.
Pipelinetyp PipelineType Sträng Pipelinetypen som innehåller uppgiftsagentens begäran.
Begärande-ID RequestId Int64 Det nummer som tilldelats till uppgiftsagentens begäran.
Exempeltimmes SamplingHour Int32 Det nummer som tilldelades till timmen när begäran togs emot.
Exempeltid SamplingTime DateTime Datum då uppgiftsagentens begäran togs emot.
Startdatum StartedDate DateTime Datum när 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.

Navigeringsegenskaper inkluderar de som anges i följande tabell.

Visningsnamn Namn Referensvillkor -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
Project Project ProjectSK ProjectSK
Startad StartedOn QueuedDateSK DateSK