Naslaginformatie over metagegevens voor Azure Pipelines Analytics

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

De Analytics-service verzamelt pijplijn- en testactiviteiten die zijn gegenereerd via Azure Pipelines. In dit artikel worden de eigenschappen beschreven die u kunt gebruiken om een analyserapport voor pijplijnen te genereren. U gebruikt een combinatie van eigenschappen om een query te filteren, gegevens samen te voegen of een rapport te maken.

Notitie

Er worden beschrijvingen gegeven van de entiteiten, eigenschappen en geïnventareerde typen die worden ondersteund door het Analytics-gegevensmodel. Dit is een vroeg concept. Geef feedback over gebieden die u graag meer informatie wilt. Zie OData-query's maken voor analyse om een query uit te voeren op het gegevensmodel.

Entiteitssets en entiteitstypen

De volgende tabel bevat een overzicht van de entiteitstypen en entiteitssets die Ondersteuning bieden voor Azure Pipelines. Alle entiteitstypen/entiteitssets zijn beschikbaar met de preview-versie van Analytics v4.0 . Analyseversie v3.0-preview biedt geen ondersteuning voor momentopnamen.

EntitySet EntityType Beschrijving
Vertakkingen Vertakking Basisinformatie over vertakkingen die worden gebruikt in tests of pijplijnen. Zie Voorbeeldrapport Voortgangsstatus voor een voorbeeldrapport.
ParallelPipelineJobsSnapshot ParallelPipelineJobsSnapshot (Samengesteld) Ondersteunt inzicht in het verbruik van parallelle pijplijnen. Zie Tests parallel uitvoeren met behulp van de Visual Studio Test-taak voor meer informatie over parallelle pijplijntests.
Pipelines Pijplijn Eigenschappen voor een pijplijn.
Pijplijntaken Pijplijntaak Afzonderlijke uitvoeringsresultaten voor een specifieke test die is gekoppeld aan een TestRun
PipelineRuns PijplijnUitvoeren Uitvoeringsinformatie voor pijplijnen. Zie Voorbeeldrapport trend voor pijplijnpassage voor een voorbeeldrapport.
PipelineRunActivityResults PipelineRunActivityResult Samengevoegd logboek van alle fasen, stappen, taken en taken binnen een specifieke pijplijnuitvoering. Zie Voorbeeldrapport Duur pijplijntaak voor een voorbeeldrapport.
Pijplijntaken PipelineTask Eigenschappen voor taken die binnen een pijplijn worden gebruikt.
TaskAgentPoolSizeSnapshots TaskAgentPoolSizeSnapshot (Samengesteld) Ondersteunt inzicht in poolgrootte, pijplijntaken en gelijktijdigheid. De historische grafiek voor agentpools laat zien hoe deze entiteitsset kan worden gebruikt.
TaskAgentRequestSnapshots TaskAgentRequestSnapshot (Samengesteld) Biedt ondersteuning voor rapportage over aanvragen van taakagents.

Vertakkingen

De volgende eigenschappen zijn geldig voor de entiteitsset Branches . Surrogaatsleutels die zijn gekoppeld aan Branch omvatten BranchSK en ProjectSK.

Weergavenaam Naam Gegevenstype Beschrijving
AnalyticsUpdatedDate DateTime Watermerk dat aangeeft wanneer de Analytics-gegevens voor het laatst zijn bijgewerkt.
Naam van vertakking BranchName Tekenreeks De naam die wordt toegewezen aan een vertakking wanneer deze wordt gemaakt.
Opslagplaats-id RepositoryId Tekenreeks Het nummer dat is toegewezen aan een opslagplaats wanneer deze wordt gemaakt.
Vsts-id van opslagplaats RepositoryVstsId Tekenreeks Het nummer dat is toegewezen aan een TFVC-opslagplaats wanneer deze wordt gemaakt.
RepositoryUrl RepositoryUrl Tekenreeks De URL die is gedefinieerd voor een opslagplaats wanneer deze wordt gemaakt.

Navigatie-eigenschappen omvatten Project en de bijbehorende referentiële beperking ProjectSK.

ParallelPipelineJobsSnapshot

De volgende eigenschappen zijn geldig voor de entiteitsset ParallelPipelineJobsSnapshot . Referentiesleutels zijn onder andere:

  • IsHosted
  • ParallelismTag
  • SamplingDate
Weergavenaam Naam Gegevenstype Beschrijving
Gehost of zelf-hostend IsHosted Booleaans Geeft aan of de parallelle pijplijn wordt uitgevoerd op een door Microsoft gehoste agent (True) of zelf-hostend is (Onwaar). Zie Azure Pipelines-agents voor meer informatie.
Kan niet alle providers bereiken FailedToReachAllProviders Booleaans Geeft aan of de uitvoering van de taak alle providers heeft bereikt (Waar) of niet (Onwaar).
Aantal parallelle pijplijntaken TotalCount Int32 Het aantal taken dat wordt uitgevoerd als onderdeel van de momentopname.
Aantal minuten parallelle pijplijnen TotalMinutes Int32 Het aantal minuten dat nodig is om de momentopname uit te voeren.
Parallellismetype ParallelismTag Tekenreeks Een tag die het type parallelle uitvoering aangeeft dat is gekoppeld aan de momentopname van de taak.
Premium-type IsPremium Booleaans Geeft aan of de parallelle pijplijn premium is (waar) of niet (onwaar).
Voorbeelddatum SamplingDate DateTime De datum die is gekoppeld aan de momentopname.

Pipelines

De volgende eigenschappen zijn geldig voor Pijplijnen en de bijbehorende surrogaatsleutel PipelineSK.

Weergavenaam Naam Gegevenstype Beschrijving
Pijplijn-id PipelineId Int32 De id die is toegewezen aan de pijplijn.
Pijplijnnaam PipelineName Tekenreeks De naam die is toegewezen aan de pijplijn.
Pijplijnversie PipelineVersion Int32 De versie die is gekoppeld aan de pijplijn.
Type pijplijnproces PipelineProcessType Enumerated Het type pijplijndefinitie. Geldige waarden worden hieronder weergegeven voor PipelineProcessType.

Navigatie-eigenschappen omvatten Project en de bijbehorende referentiële beperking ProjectSK.

Leden van het opgesomde type PipelineProcessType

De volgende leden zijn gedefinieerd voor het PipelineProcessType opgesomde type dat de methode aangeeft die wordt gebruikt om de pijplijn te definiëren.

Lidnaam Waarde Definitie
Designer 1 Klassieke pijplijndefinitie.
Yaml 2 DEFINITIE VAN YAML-pijplijn.
Docker 3 Definitie van Docker-pijplijn.

Pijplijntaken

Een pijplijntaak is een reeks stappen die opeenvolgend als een eenheid worden uitgevoerd. Een taak is de kleinste werkeenheid die u kunt plannen om uit te voeren. Pijplijnen zijn geordend rond taken en elke pijplijn heeft ten minste één taak. Zie Taken opgeven in uw pijplijn voor meer informatie.

De volgende eigenschappen zijn geldig voor PipelineJobs en de bijbehorende PipelineJobSK surrogaatsleutel.

Weergavenaam Naam Gegevenstype Beschrijving
Naam van volledige pijplijntaak FullJobName Tekenreeks De volledige naam van een pijplijntaak.
Pijplijn-id PipelineId Int32 De id die is toegewezen aan de pijplijn waarin de taak is gedefinieerd.
Id van pijplijntaak JobId Tekenreeks De taak-id die is toegewezen aan een pijplijntaak wanneer deze wordt gemaakt.
Naam pijplijntaak JobName Tekenreeks De naam die is toegewezen aan de pijplijntaak.
Naam van pijplijnfase StageName Tekenreeks De fasenaam die is gekoppeld aan de pijplijntaak.
Kenmerken van pijplijntaakstrategie StrategyAttributes Tekenreeks De kenmerken die zijn gedefinieerd voor de pijplijntaak.
Fase-id StageId Tekenreeks De fase-id die is gekoppeld aan de pijplijntaak.

Navigatie-eigenschappen omvatten Project en de bijbehorende referentiële beperking ProjectSK.

Voor een voorbeeldrapport dat query's uitvoert op het entiteitstype PipelineJob , raadpleegt u Voorbeeldrapport over fouten in pijplijnfasen.

PipelineRuns

Een pijplijnuitvoering vertegenwoordigt één uitvoering van een pijplijn. Tijdens een uitvoering wordt de pijplijn verwerkt en verwerken agents een of meer taken. Een pijplijnuitvoering bevat taken, stappen en taken. Zie Pijplijnuitvoeringsvolgorde voor meer informatie.

De volgende eigenschappen zijn geldig voor het entiteitstype PipelineRun en de bijbehorende PipelineRunSK surrogaatsleutel.

Weergavenaam Naam Gegevenstype Beschrijving
Geannuleerd aantal CanceledCount Int32 Het aantal pijplijnuitvoeringen dat is geannuleerd.
Voltooide datum CompletedDate DateTime De datum en tijd waarop de uitvoering van de pijplijn is voltooid.
Aantal mislukte FailedCount Int32 Het aantal geslaagde pijplijnuitvoeringen.
Nummerrevisie RunNumberRevision Int32 Het nummer dat is toegewezen aan een pijplijnuitvoering met sequentiële uitvoeringen.
Aantal gedeeltelijk geslaagd PartiallySucceededCount Int32 Het aantal pijplijnuitvoeringen dat gedeeltelijk is geslaagd.
Pijplijnuitvoerings-id PipelineRunId Int32 Het nummer dat is toegewezen aan een pijplijnuitvoering.
Datum in wachtrij QueuedDate DateTime De datum en tijd waarop de pijplijn in de wachtrij is geplaatst om te worden uitgevoerd.
Wachtrijduur seconden QueueDurationSeconds Decimaal Het aantal seconden dat de pijplijn in de wachtrij is gebleven.
Uitvoeringsnummer RunNumber Tekenreeks Het nummer dat is toegewezen aan een pijplijnuitvoering wanneer deze wordt uitgevoerd.
Uitvoeringsresultaat RunOutcome Enumerated Het resultaat dat is toegewezen aan een pijplijn na voltooiing van de uitvoering. Geldige waarden worden hieronder vermeld voor PipelineRunOutcome.
Reden van uitvoering RunReason Enumerated De voorwaarde waardoor de pijplijn werd uitgevoerd. Geldige waarden worden hieronder vermeld voor PipelineRunReason.
Uitvoeringsduur seconden RunDurationSeconds Decimaal Het aantal seconden dat nodig was om de pijplijnuitvoering te voltooien.
Begindatum StartedDate DateTime De datum en tijd waarop de pijplijnuitvoering is gestart.
Aantal geslaagd SucceededCount Int32 Het aantal geslaagde pijplijnuitvoeringen.
Totale duur seconden TotalDurationSeconds Decimaal Het totale aantal seconden dat de pijplijn zich in de wachtrij bevond en werd uitgevoerd.

De volgende navigatie-eigenschappen worden ondersteund.

Weergavenaam Naam -Referentiële beperking Eigenschap Waarnaar wordt verwezen
Vertakking Branch BranchSK BranchSK
Voltooid op CompletedOn CompletedDateSK DateSK
In wachtrij geplaatst op QueuedOn QueuedDateSK DateSK
Gestart op StartedOn QueuedDateSK DateSK
Pijplijn Pipeline PipelineSK PipelineSK
Project Project ProjectSK ProjectSK

Leden van het opgesomde type PipelineRunReason

De volgende leden zijn gedefinieerd voor het PipelineRunReason geïnventareerde type dat de voorwaarden aangeeft waaronder elke pijplijnfase, -taak of -stap wordt uitgevoerd, zoals beschreven in Voorwaarden opgeven.

Lidnaam Waarde Weergavenaam
None 0 Geen
Manual 1 Handmatig
IndividualCI 2 Afzonderlijke CI
BatchedCI 4 Batchgewijze CI
Schedule 8 Schema
UserCreated 32 Gebruiker gemaakt
ValidateShelveset 64 Plankenset valideren
CheckInShelveset 128 Check In plankenset
PullRequest 256 Pull-aanvraag
PipelineRunCompletion 512 Build voltooid

Leden van het opgesomde type PipelineRunOutcome

De volgende leden zijn gedefinieerd voor het PipelineRunOutcome geïnventareerde type dat het resultaat van een pijplijnuitvoering aangeeft.

Lidnaam Waarde Weergavenaam
None 0 Geen
Succeed 2 Geslaagd
PartiallySucceeded 4 Gedeeltelijk geslaagd
Failed 6 Mislukt
Canceled 32 Geannuleerd

PipelineRunActivityResults

De volgende eigenschappen zijn geldig voor de entiteitsset PipelineRunActivityResults en de bijbehorende PipelineRunActivityResultSK surrogaatsleutel.

Veel eigenschappen zijn gebaseerd op datums of op basis van gebruikers. Deze eigenschappen zijn gekoppeld aan de entiteitenets CalendarDate en Gebruikers die worden beschreven in Agendadatum, Project en Naslaginformatie over gebruikersmetagegevens.

Weergavenaam Naam Gegevenstype Beschrijving
Aantal verlaten AbandonedCount Int32 Het aantal pijplijnuitvoeringen dat is gemarkeerd als verlaten.
Voltooide activiteitsdatum ActivityCompletedDate DateTime De datum en tijd waarop de uitvoering van de pijplijn is voltooid.
Activiteitsduur seconden ActivityDurationSeconds Decimaal Het totale aantal seconden dat de pijplijn zich in de wachtrij bevond en werd uitgevoerd.
Begindatum van activiteit ActivityStartedDate DateTime De datum/tijd waarop de pijplijnuitvoering is gestart.
Geannuleerd aantal CanceledCount Int32 Het aantal pijplijnuitvoeringen dat is geannuleerd.
Aantal mislukte FailedCount Int32 Het aantal mislukte pijplijnuitvoeringen.
Type pijplijnactiviteit ActivityType Enumerated Het type pijplijnactiviteit. Geldige waarden worden hieronder vermeld voor PipelineActivityType.
Id van pijplijnuitvoering PipelineRunId Int32 Het nummer dat is toegewezen aan een pijplijnuitvoering wanneer deze wordt uitgevoerd.
Resultaat pijplijnuitvoering PipelineRunOutcome Enumerated Het resultaat dat is toegewezen aan een pijplijn na voltooiing van de uitvoering. Geldige waarden worden vermeld onder PipelineRunOutcome.
Relatieve begintijd vanaf taakseconden RelativeStartTimeFromJobSeconds Int32 Het aantal seconden dat is verstreken vanaf het begin van de taak.
Relatieve begintijd vanaf fase-seconden RelativeStartTimeFromStageSeconds Int32 Het aantal seconden dat is verstreken vanaf het begin van de fase.
Relatieve begintijd vanaf uitvoeringsseconden RelativeStartTimeFromRunSeconds Int32 Het aantal seconden dat is verstreken vanaf het moment dat de uitvoering werd uitgevoerd.
Aantal overgeslagen SkippedCount Int32 Het aantal pijplijnuitvoeringen dat is overgeslagen.
Aantal geslaagd SucceededCount Int32 Het aantal geslaagde pijplijnuitvoeringen.
Geslaagd met aantal problemen SucceededWithIssuesCount Int32 Het aantal pijplijnuitvoeringen dat gedeeltelijk is geslaagd.
Weergavenaam van taak TaskDisplayName Tekenreeks Naam van een taak die is uitgevoerd in de pijplijnuitvoering.
Pad naar taaklogboek TaskLogPath Tekenreeks Het pad van het logboekbestand dat is gegenereerd door een taak.
Taakresultaat TaskOutcome Aangepast telefoonnummer Het resultaat van de taak die is uitgevoerd.

Zie Trendvoorbeeldrapport Pijplijntaakduur voor voorbeeldrapporten die een query uitvoeren op het entiteitstype PipelineRunActivityResult.

Navigatie-eigenschappen omvatten de eigenschappen die in de volgende tabel worden vermeld.

Weergavenaam Naam Referentiële beperking Eigenschap Waarnaar wordt verwezen
Activiteit gestart op ActivityStartedOn ActivityStartedDateSK DateSK
Vertakking Branch BranchSK BranchSK
Pijplijn Pipeline PipelineSK PipelineSK
Pijplijntaak PipelineTask PipelineTaskSK PipelineTaskSK
Pijplijntaak PipelineJob PipelineJobSK PipelineJobSK
Pijplijnuitvoering in wachtrij PipelineRunQueuedOn PipelineRunQueuedDateSK DateSK
Pijplijnuitvoering gestart op PipelineRunStartedOn PipelineRunStartedDateSK DateSK
Pijplijnuitvoering voltooid op PipelineRunCompletedOn PipelineRunCompletedDateSK DateSK
Pijplijnuitvoering gestart op PipelineRunStartedOn PipelineRunStartedDateSK DateSK
Project Project ProjectSK ProjectSK

Leden van het geïnventariseerd type PipelineActivityType

De volgende leden zijn gedefinieerd voor het PipelineActivityType opgesomde type.

Lidnaam Waarde Weergavenaam
Task 0 Taak
Approval 1 Goedkeuring
AgentWait 2 Wachten op agent

Pijplijntaken

De volgende eigenschappen zijn geldig voor de entiteitsset PipelineTasks en de surrogaatsleutel PipelineTaskSK.

Weergavenaam Naam Gegevenstype Beschrijving
Taakdefinitie-id TaskDefinitionId GUID De GUID die is toegewezen aan een pijplijntaak.
Versie van taakdefinitie TaskDefinitionVersion Tekenreeks De versie die is toegewezen aan een pijplijntaak.

Navigatie-eigenschappen omvatten Project en de bijbehorende referentiële beperking ProjectSK.

TaskAgentPoolSizeSnapshots

De volgende eigenschappen zijn geldig voor de entiteitsset TaskAgentPoolSizeSnapshots en de bijbehorende surrogaatsleutel SamplingDate.

Weergavenaam Eigenschapsnaam Gegevenstype Beschrijving
Onlineaantal OnlineCount Int32 Het aantal agents dat online was in de agentgroep toen de taak werd uitgevoerd.
Aantal offline OfflineCount Int32 Het aantal agents dat offline was in de agentgroep toen de taak werd uitgevoerd.
Pool-id PoolId Int32 Het nummer dat is toegewezen aan de agentgroep.
Voorbeelddatum SamplingDate DateTime De datum en tijd waarop de poolgrootte is vastgeklikt.

Zie Historische grafiek voor agentpools (preview) voor een voorbeeldrapport dat is gebaseerd op de entiteit TaskAgentPoolSizeSnapshot.

TaskAgentRequestSnapshots

Agentpools worden toegewezen wanneer een taak wordt uitgevoerd. De entiteitsset TaskAgentRequestSnapshots legt gegevens vast met betrekking tot de aanvragen van de taakagent.

De volgende eigenschappen zijn geldig voor het entiteitstype TaskAgentRequestSnapshot en de surrogaatsleutels SamplingTime en SamplingDateSK.

Weergavenaam Naam Gegevenstype Beschrijving
Build in wachtrij IsQueued Booleaans Geeft aan of de build in de wachtrij staat (Waar) of niet in de wachtrij (Onwaar).
Build wordt uitgevoerd IsRunning Booleaans Geeft aan of de build wordt uitgevoerd (Waar) of niet wordt uitgevoerd (Onwaar).
Gehost of zelf-hostend IsHosted Booleaans Geeft aan of de agent die aan de taak is toegewezen, wordt gehost (True) of zelf-hostend (Onwaar).
Einddatum van taak FinishedDate DateTime De datum/tijd waarop de taakagentaanvraag is uitgevoerd.
FinishedDateSK Int32 De datum waarop de taakagentaanvraag is voltooid, uitgedrukt in YYYYMMDD de tijdzone die voor de organisatie is gedefinieerd.
Datum in wachtrij QueuedDate DateTime De datum en tijd waarop de aanvraag van de taakagent in de wachtrij is geplaatst.
QueuedDateSK Int32 De datum waarop de aanvraag van de taakagent in de wachtrij is geplaatst, uitgedrukt in YYYYMMDD de tijdzone die voor de organisatie is gedefinieerd.
Wachtrijduur seconden QueueDurationSeconds Decimaal Het aantal seconden dat de taakagentaanvraag in de wachtrij bleef voordat een agent werd toegewezen.
Pool-id PoolId Int32 Het nummer dat is toegewezen aan de agentgroep die is toegewezen aan de taakagentaanvraag.
Pijplijntype PipelineType Tekenreeks Het pijplijntype met de taakagentaanvraag.
Aanvraag-id RequestId Int64 Het nummer dat is toegewezen aan de taakagentaanvraag.
Voorbeelduur SamplingHour Int32 Het nummer dat is toegewezen aan het uur waarop de aanvraag is ontvangen.
Voorbeeldtijd SamplingTime DateTime De datum/tijd waarop de aanvraag van de taakagent is ontvangen.
Begindatum StartedDate DateTime De datum/tijd waarop de taakagentaanvraag is uitgevoerd.
StartedDateSK Int32 De datum waarop de taakagentaanvraag is gestart met de uitvoering, uitgedrukt YYYYMMDD in de tijdzone die voor de organisatie is gedefinieerd.

Navigatie-eigenschappen omvatten de eigenschappen die in de volgende tabel worden vermeld.

Weergavenaam Naam Referentiële beperking -Eigenschap Waarnaar wordt verwezen
Vertakking Branch BranchSK BranchSK
Voltooid op CompletedOn CompletedDateSK DateSK
Eindtijd van de taak FinishedOn FinishedDateSK DateSK
In wachtrij geplaatst op QueuedOn QueuedDateSK DateSK
Pijplijn Pipeline PipelineSK PipelineSK
Project Project ProjectSK ProjectSK
Gestart op StartedOn QueuedDateSK DateSK