Delen via


Naslaginformatie over metagegevens voor Azure Pipelines Analytics

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

De Analytics-service verzamelt pijplijn- en testactiviteit die is gegenereerd via Azure Pipelines. In dit artikel worden de eigenschappen beschreven die u kunt gebruiken om een Analytics-rapport 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

Beschrijvingen van de entiteiten, eigenschappen en opsommingstypen die worden ondersteund door het analysegegevensmodel, worden verstrekt. Dit is een vroeg concept. Geef feedback over gebieden waar u meer informatie over wilt hebben. 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. Analytics-versie v3.0-preview biedt geen ondersteuning voor momentopnamen.

EntitySet EntityType Beschrijving
Takken Vertakking Basisinformatie over vertakkingen die worden gebruikt in tests of pijplijnen. Zie het voorbeeldrapport Voortgangsstatus voor een voorbeeldrapport.
ParallelPipelineJobsSnapshot ParallelPipelineJobsSnapshot (Samengesteld) Ondersteunt inzicht in het gebruik van parallelle pijplijnen. Zie Testtests parallel uitvoeren met behulp van de Visual Studio-testtaak voor meer informatie over parallelle pijplijntests.
Pijplijnen Pijplijn Eigenschappen voor een pijplijn.
PipelineJobs PipelineJob Afzonderlijke uitvoeringsresultaten voor een specifieke test die is gekoppeld aan een TestRun
PipelineRuns PipelineRun Uitvoeringsinformatie voor pijplijnen. Zie het voorbeeldrapport pijplijnpasfrequentie voor een voorbeeldrapport voor een voorbeeldrapport.
PipelineRunActivityResults PipelineRunActivityResult Samengevoegd logboek van alle fasen, stappen, taken en taken binnen een specifieke pijplijnuitvoering. Zie het voorbeeldrapport Pijplijntaakduur voor een voorbeeldrapport voor een voorbeeldrapport.
PipelineTasks PipelineTask Eigenschappen voor taken die in een pijplijn worden gebruikt.
TaskAgentPoolSizeSnapshots TaskAgentPoolSizeSnapshot (Samengesteld) Ondersteunt inzicht in poolgrootte, pijplijntaken en gelijktijdigheid. In de historische grafiek voor agentpools ziet u hoe deze entiteitsset kan worden gebruikt.
TaskAgentRequestSnapshots TaskAgentRequestSnapshot (Samengesteld) Ondersteunt rapportage over taakagentaanvragen.

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 Datum en tijd Watermerk dat aangeeft wanneer de analysegegevens de laatste keer zijn bijgewerkt.
Naam van vertakking BranchName String De naam die is toegewezen aan een vertakking wanneer deze wordt gemaakt.
Opslagplaats-id RepositoryId String Het nummer dat is toegewezen aan een opslagplaats wanneer het wordt gemaakt.
Vsts-id van opslagplaats RepositoryVstsId String Het nummer dat is toegewezen aan een TFVC-opslagplaats wanneer het wordt gemaakt.
RepositoryUrl RepositoryUrl String 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 Booleaanse waarde Geeft aan of de parallelle pijplijn wordt uitgevoerd op een door Microsoft gehoste agent (Waar) of zelf-hostend (Onwaar). Zie Azure Pipelines-agents voor meer informatie.
Kan niet alle providers bereiken FailedToReachAllProviders Booleaanse waarde Geeft aan of de taakuitvoering alle providers (waar) heeft bereikt of niet (onwaar).
Aantal parallelle pijplijnentaken TotalCount Int32 Het aantal taken wordt uitgevoerd als onderdeel van de momentopname.
Aantal minuten voor parallelle pijplijnen TotalMinutes Int32 Het aantal minuten dat nodig is om de momentopname uit te voeren.
Parallellismetype ParallelismTag String Een tag die het type parallelle uitvoering aangeeft dat is gekoppeld aan de momentopname van de taak.
Premium-type IsPremium Booleaanse waarde Geeft aan of de parallelle pijplijn Premium (Waar) is of niet (Onwaar).
Voorbeelddatum SamplingDate Datum en tijd De datum die is gekoppeld aan de momentopname.

Pipelines

De volgende eigenschappen zijn geldig voor pijplijnen en de surrogaatsleutel PipelineSK.

Weergavenaam Naam Gegevenstype Beschrijving
Pijplijn-id PipelineId Int32 De id die is toegewezen aan de pijplijn.
Pijplijnnaam PipelineName String 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 type PipelineProcessType geïnventariseerd

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

De naam van lid Weergegeven als Definitie
Designer 1 Klassieke pijplijndefinitie.
Yaml 2 YAML-pijplijndefinitie.
Docker 3 Definitie van Docker-pijplijn.

PipelineJobs

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 georganiseerd rond taken en elke pijplijn heeft ten minste één taak. Raadpleeg Taken opgeven in uw pijplijn voor meer informatie.

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

Weergavenaam Naam Gegevenstype Beschrijving
Volledige taaknaam pijplijn FullJobName String 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 String De taak-id die is toegewezen aan een pijplijntaak wanneer deze wordt gemaakt.
Naam van pijplijntaak JobName String De naam die is toegewezen aan de pijplijntaak.
Naam van pijplijnfase StageName String De fasenaam die is gekoppeld aan de pijplijntaak.
Kenmerken van pijplijntaakstrategie StrategyAttributes String De kenmerken die zijn gedefinieerd voor de pijplijntaak.
Fase-id StageId String De fase-id die is gekoppeld aan de pijplijntaak.

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

Zie het voorbeeldrapport pijplijnfasefouten voor een voorbeeldrapport dat een query uitvoert op het entiteitstype PipelineJob.

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 omvat taken, stappen en taken. Zie Pijplijnuitvoeringsvolgorde voor meer informatie.

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

Weergavenaam Naam Gegevenstype Beschrijving
Aantal geannuleerd CanceledCount Int32 Het aantal pijplijnuitvoeringen dat is geannuleerd.
Datum van voltooiing CompletedDate Datum en tijd De datum en tijd waarop de pijplijn is uitgevoerd.
Aantal mislukte pogingen FailedCount Int32 Het aantal pijplijnuitvoeringen dat is geslaagd.
Revisie van nummer RunNumberRevision Int32 Het nummer dat is toegewezen aan een pijplijnuitvoering met opeenvolgende uitvoeringen.
Gedeeltelijk geslaagd aantal 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 Datum en tijd De datum en tijd waarop de pijplijn in de wachtrij is geplaatst om uit te voeren.
Wachtrijduur seconden QueueDurationSeconds Decimal Het aantal seconden dat de pijplijn in de wachtrij bleef.
Uitvoeringsnummer RunNumber String Het nummer dat is toegewezen aan een pijplijnuitvoering wanneer deze wordt uitgevoerd.
Resultaat uitvoeren RunOutcome Enumerated Het resultaat dat is toegewezen aan een pijplijn na voltooiing van de uitvoering. Geldige waarden worden hieronder weergegeven voor PipelineRunOutcome.
Reden van uitvoering RunReason Enumerated De voorwaarde waardoor de pijplijn werd uitgevoerd. Geldige waarden worden hieronder weergegeven voor PipelineRunReason.
Uitvoeringsduur seconden RunDurationSeconds Decimal Het aantal seconden dat het duurt voordat de pijplijn is uitgevoerd.
Begindatum StartedDate Datum en tijd De datum en tijd waarop de pijplijnuitvoering is gestart.
Geslaagd aantal SucceededCount Int32 Het aantal pijplijnuitvoeringen dat is geslaagd.
Totale duur seconden TotalDurationSeconds Decimal Het totale aantal seconden dat de pijplijn zich in de wachtrij bevindt en wordt 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 type PipelineRunReason geïnventariseerd

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

De naam van lid Weergegeven als Display name
None 0 Geen
Manual 1 Handmatig
IndividualCI 2 Afzonderlijke CI
BatchedCI 4 Batch-CI
Schedule 8 Schema
UserCreated 32 Gebruiker gemaakt
ValidateShelveset 64 Plankenset valideren
CheckInShelveset 128 Check In plankenset
PullRequest 256 Pull-aanvraag
PipelineRunCompletion 512 Buildvoltooiing

Leden van het type PipelineRunOutcome geïnventariseerd

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

De naam van lid Weergegeven als Display name
None 0 Geen
Succeed 2 Geslaagd
PartiallySucceeded 4 Gedeeltelijk geslaagd
Failed 6 Mislukt
Canceled 32 Geannuleerd

PipelineRunActivityResults

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

Veel eigenschappen zijn op datum of op basis van een gebruiker. Deze eigenschappen zijn gekoppeld aan de entiteiten CalendarDate en User die worden beschreven in de naslaginformatie over kalenderdatum, Project en Gebruikersmetagegevens.

Weergavenaam Naam Gegevenstype Beschrijving
Verlaten aantal AbandonedCount Int32 Het aantal pijplijnuitvoeringen dat is gemarkeerd als verlaten.
Voltooide activiteitsdatum ActivityCompletedDate Datum en tijd De datum en tijd waarop de uitvoering van de pijplijn is voltooid.
Seconden activiteitsduur ActivityDurationSeconds Decimal Het totale aantal seconden dat de pijplijn zich in de wachtrij bevindt en wordt uitgevoerd.
Begindatum van activiteit ActivityStartedDate Datum en tijd De datum/tijd waarop de pijplijnuitvoering is gestart.
Aantal geannuleerd CanceledCount Int32 Het aantal pijplijnuitvoeringen dat is geannuleerd.
Aantal mislukte pogingen FailedCount Int32 Het aantal pijplijnuitvoeringen dat is mislukt.
Type pijplijnactiviteit ActivityType Enumerated Het type pijplijnactiviteit. Geldige waarden worden hieronder weergegeven voor PipelineActivityType.
Pijplijnuitvoerings-id 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 taak seconden 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 uitvoerings seconden RelativeStartTimeFromRunSeconds Int32 Het aantal seconden dat is verstreken toen de uitvoering werd uitgevoerd.
Aantal overgeslagen SkippedCount Int32 Het aantal pijplijnuitvoeringen dat is overgeslagen.
Geslaagd aantal SucceededCount Int32 Het aantal pijplijnuitvoeringen dat is geslaagd.
Geslaagd met aantal problemen SucceededWithIssuesCount Int32 Het aantal pijplijnuitvoeringen dat gedeeltelijk is geslaagd.
Weergavenaam van taak TaskDisplayName String De naam van een taak die wordt uitgevoerd in de pijplijnuitvoering.
Pad naar taaklogboek TaskLogPath String Het pad van het logboekbestand dat door een taak is gegenereerd.
Taakresultaat TaskOutcome Aanpassen Het resultaat van de taak die is uitgevoerd.

Zie het voorbeeldrapport Van de duur van de pijplijntaak voor voorbeeldrapporten die een query uitvoeren op het entiteitstype PipelineRunActivityResult.

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

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 op 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 type PipelineActivityType geïnventariseerd

De volgende leden worden gedefinieerd voor het PipelineActivityType geïnventariseerd type.

De naam van lid Weergegeven als Display name
Task 0 Opdracht
Approval 1 Goedkeuring
AgentWait 2 Wacht van agent

PipelineTasks

De volgende eigenschappen zijn geldig voor de entity Set PipelineTasks en de bijbehorende surrogaatsleutel PipelineTaskSK.

Weergavenaam Naam Gegevenstype Beschrijving
Taakdefinitie-id TaskDefinitionId GUID De GUID die is toegewezen aan een pijplijntaak.
Versie van taakdefinitie TaskDefinitionVersion String 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 entiteit TaskAgentPoolSizeSnapshots en de bijbehorende surrogaatsleutelSamplingDate.

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

Zie de historische grafiek voor agentpools (preview) voor een voorbeeldrapport dat is gebouwd op basis van de entiteit TaskAgentPoolSizeSnapshot.

TaskAgentRequestSnapshots

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

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

Weergavenaam Naam Gegevenstype Beschrijving
Build Queued IsQueued Booleaanse waarde Geeft aan of de build in de wachtrij staat (Waar) of niet in de wachtrij staat (Onwaar).
Build wordt uitgevoerd IsRunning Booleaanse waarde Geeft aan of de build wordt uitgevoerd (waar) of niet wordt uitgevoerd (onwaar).
Gehost of zelf-hostend IsHosted Booleaanse waarde Geeft aan of de agent die is toegewezen aan de taak wordt gehost (waar) of zelf-hostend (onwaar).
Einddatum van taak FinishedDate Datum en tijd De datum/tijd waarop de taakagentaanvraag is uitgevoerd.
FinishedDateSK Int32 De datum waarop de taakagentaanvraag is uitgevoerd, uitgedrukt YYYYMMDD in de tijdzone die is gedefinieerd voor de organisatie.
Datum in wachtrij QueuedDate Datum en tijd De datum waarop de aanvraag van de taakagent in de wachtrij is geplaatst.
QueuedDateSK Int32 De datum waarop de taakagentaanvraag in de wachtrij is geplaatst, uitgedrukt YYYYMMDD in de tijdzone die is gedefinieerd voor de organisatie.
Wachtrijduur seconden QueueDurationSeconds Decimal Het aantal seconden dat de aanvraag van de taakagent 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 String 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 Datum en tijd De datum waarop de aanvraag van de taakagent is ontvangen.
Begindatum StartedDate Datum en tijd De datum waarop de taakagentaanvraag is uitgevoerd.
StartedDateSK Int32 De datum waarop de taakagentaanvraag is gestart, uitgedrukt YYYYMMDD in de tijdzone die is gedefinieerd voor de organisatie.

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

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