Metadatareferens för Azure Pipelines Analytics
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:
IsHostedParallelismTagSamplingDate
| 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. |
Navigeringsegenskaper
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 | Incheckning 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 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.
Navigeringsegenskaper
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 |