Delen via

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 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 ontwerp. 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.

EntiteitSet Entiteitstype Beschrijving
Takken Filiaal Basisgegevens over takken die worden gebruikt in tests en pijplijnen. Zie Voorbeeldrapport voortgangsstatus voor een voorbeeldrapport.
ParallelPipelineJobsSnapshot ParallelPipelineJobsSnapshot (Samengesteld) Ondersteunt inzicht in het verbruik 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 Pipeline pass rate trend sample report voor meer informatie.
PipelineRunActivityResults PipelineRunActivityResult Samengevoegd logboek van alle fasen, stappen, banen en taken in een specifieke pijplijnuitvoering. Zie het voorbeeldrapport over de duur van pijplijntaken 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 vestiging BranchName String De naam die is toegewezen aan een tak 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 bij aanmaak.
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
Gehosted of zelfgehost IsHosted Booleaans 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 Booleaans 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.
Premiumtype IsPremium Booleaans 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.

Pijpleidingen

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.
Pijplijnproces type PipelineProcessType Opgesomd Het type pijplijndefinitie. Geldige waarden worden hieronder weergegeven voor PipelineProcessType.

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

Leden van het enumeratietype PipelineProcessType

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 Waarde 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-identificatie StageId String De fase-identificatie die is gekoppeld aan de pijplijnopdracht.

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 agenten een of meer taken. Een pijplijnuitvoering omvat opdrachten, 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
Geannuleerd aantal CanceledCount Int32 Het aantal pijplijnuitvoeringen dat is geannuleerd.
Datum van voltooiing CompletedDate Datum en tijd De datum en tijd waarop de pijplijn wordt voltooid.
Aantal mislukte pogingen FailedCount Int32 Het aantal geslaagde pijplijnuitvoeringen.
Revisie van nummer RunNumberRevision Int32 Het nummer dat is toegewezen aan een pijplijnuitvoering met opeenvolgende runs.
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 de wachtrij QueuedDate Datum en tijd De datum en tijd waarop de pijplijn in de wachtrij staat voor uitvoering.
Wachtrijduur seconden QueueDurationSeconds Decimal Het aantal seconden dat de pijplijn in de wachtrij bleef.
Uitvoeringsnummer RunNumber String Het nummer dat aan een pijplijnrun wordt toegewezen wanneer deze wordt uitgevoerd.
Resultaat uitvoeren RunOutcome Opgesomd Het resultaat dat is toegewezen aan een pijplijn na voltooiing van de uitvoering. Geldige waarden worden hieronder weergegeven voor PipelineRunOutcome.
Reden van uitvoering RunReason Opgesomd De voorwaarde waardoor de pijplijn werd gestart. Geldige waarden worden hieronder weergegeven voor PipelineRunReason.
Uitvoeringsduur seconden RunDurationSeconds Decimaal Het aantal seconden dat het duurde voordat de pijplijn was voltooid.
Begindatum StartedDate Datum en tijd 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 in de wachtrij stond en werd uitgevoerd.

De volgende navigatie-eigenschappen worden ondersteund.

Weergavenaam Naam -Referentiële beperking Gerefereerde eigenschap
Filiaal 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 enumeratietype PipelineRunReason

De volgende leden zijn gedefinieerd voor het PipelineRunReason enumeratietype dat de voorwaarden aangeeft waaronder elke pijplijnfase, taak of stap wordt uitgevoerd, zoals beschreven in Specificeer voorwaarden.

De naam van lid Waarde Weergavenaam
None 0 Geen
Manual 1 Handmatig
IndividualCI 2 Afzonderlijke CI
BatchedCI 4 Geclusterde CI
Schedule 8 Schema
UserCreated 32 Door gebruiker gemaakt
ValidateShelveset 64 Shelveset valideren
CheckInShelveset 128 Inchecken Shelveset
PullRequest 256 Pull-aanvraag
PipelineRunCompletion 512 Buildvoltooiing

Leden van het type PipelineRunOutcome geïnventariseerd

De volgende leden zijn gedefinieerd voor het PipelineRunOutcome enumeratietype dat de uitkomst van een pijplijnuitvoering aangeeft.

De naam van lid Waarde Weergavenaam
None 0 Geen
Succeed 2 Geslaagd
PartiallySucceeded 4 Gedeeltelijk geslaagd
Failed 6 Mislukt
Canceled 32 Geannuleerd

ResultatenVanPipelineRunActiviteit

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

Veel eigenschappen zijn datumgebonden of gebruikersgebonden. 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.
Duur van de activiteit in seconden ActivityDurationSeconds Decimaal Het totale aantal seconden dat de pijplijn in de wachtrij stond en werd uitgevoerd.
Begindatum van activiteit ActivityStartedDate Datum en tijd De datum/tijd waarop de pijplijnuitvoering is gestart.
Geannuleerde aantal CanceledCount Int32 Het aantal pijplijnuitvoeringen dat is geannuleerd.
Aantal mislukte pogingen FailedCount Int32 Het aantal pijplijnuitvoeringen dat is mislukt.
Pijplijnactiviteitstype ActivityType Genummerd Het type pijplijnactiviteit. Geldige waarden worden hieronder weergegeven voor PipelineActivityType.
Pijplijnrun-id PipelineRunId Int32 Het nummer dat is toegewezen aan een pijplijnuitvoering wanneer deze wordt uitgevoerd.
Resultaat pijplijnuitvoering PipelineRunOutcome Genummerd 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 in seconden vanaf fase 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 sinds het proces werd uitgevoerd.
Aantal overgeslagen SkippedCount Int32 Het aantal pijplijnuitvoeringen dat is overgeslagen.
Geslaagd aantal SucceededCount Int32 Het aantal pijplijnuitvoeringen dat succesvol is.
Geslaagd met aantal gemelde problemen SucceededWithIssuesCount Int32 Het aantal pijplijnuitvoeringen dat gedeeltelijk geslaagd is.
Weergavenaam van taak TaskDisplayName String De naam van een taak die wordt uitgevoerd in de pijplijnuitvoering.
Pad naar takenlogboek TaskLogPath String Het pad van het logboekbestand dat door een taak is gegenereerd.
Taakresultaat TaskOutcome Aanpassen Het resultaat van de taak die is uitgevoerd.

Voor voorbeeldrapporten die een query uitvoeren op het entiteitstype PipelineRunActivityResult, zie voorbeeldrapport van de duurtrend van pijplijntaken.

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
Filiaal 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 enumeratietype PipelineActivityType

De volgende leden worden gedefinieerd voor het PipelineActivityType opgesomde type.

De naam van lid Waarde Weergavenaam
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 SamplingDate

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 offline agents in de agentgroep op het moment dat de taak werd uitgevoerd.
Pool-id PoolId Int32 Het nummer dat is toegewezen aan de agentenpool.
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 Booleaans Geeft aan of de build in de wachtrij staat (Waar) of niet in de wachtrij staat (Onwaar).
Build wordt uitgevoerd IsRunning Booleaans Geeft aan of de build actief is (True) of niet actief is (False).
Gehost of zelf-hostend IsHosted Boolean Geeft aan of de agent die is toegewezen aan de taak gehost (Waar) of zelfgehost (Onwaar) is.
Einddatum van taak FinishedDate Datum en tijd De datum en tijd waarop het taakagentverzoek is voltooid.
FinishedDateSK Int32 De datum waarop de taakagentaanvraag is uitgevoerd, uitgedrukt op 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 taakagent-aanvraag in de wachtrij is geplaatst, uitgedrukt als YYYYMMDD in de tijdzone die is gedefinieerd voor de organisatie.
Wachtrijduur seconden QueueDurationSeconds Decimaal 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 aan het verzoek van de taakagent is toegewezen.
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 het verzoek van de taakagent is begonnen met uitvoeren, uitgedrukt als 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 -Gereferentieerde eigenschap
Filiaal 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