Metadatenreferenz für Azure Pipelines Analytics

  • Artikel

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

Der Analytics-Dienst erfasst Pipeline- und Testaktivitäten, die über Azure Pipelines generiert wurden. In diesem Artikel werden die Eigenschaften beschrieben, mit denen Sie einen Analysebericht für Pipelines generieren können. Sie verwenden eine Kombination von Eigenschaften, um eine Abfrage zu filtern, Daten zu aggregieren oder einen Bericht zu erstellen.

Hinweis

Beschreibungen der Entitäten, Eigenschaften und aufgezählten Typen, die vom Analytics-Datenmodell unterstützt werden, werden bereitgestellt. Dies ist ein früher Entwurf. Bitte geben Sie Feedback zu Bereichen, in denen Sie weitere Informationen wünschen. Informationen zum Abfragen des Datenmodells finden Sie unter Erstellen von OData-Abfragen für Analytics.

Entitätssätze und Entitätstypen

In der folgenden Tabelle sind die Entitätstypen und Entitätssätze zusammengefasst, die Azure Pipelines unterstützen. Alle Entitätstypen/Entitätssätze sind mit der Vorschauversion von Analytics v4.0 verfügbar. Die Analytics-Version v3.0-preview unterstützt keine Momentaufnahmen.

EntitySet EntityType BESCHREIBUNG
Branches Branch Grundlegende Informationen zu Branches, die in Tests oder Pipelines verwendet werden. Einen Beispielbericht finden Sie unter Status status Beispielberichts.
ParallelPipelineJobsSnapshot ParallelPipelineJobsSnapshot (Zusammengesetzt) Unterstützt das Verständnis der parallelen Pipelinenutzung. Weitere Informationen zu parallelen Pipelinetests finden Sie unter Paralleles Ausführen von Tests mit dem Visual Studio-Testtask.
Pipelines Pipeline Eigenschaften für eine Pipeline.
PipelineJobs PipelineJob Einzelne Ausführungsergebnisse für einen bestimmten Test, der einem TestRun zugeordnet ist
PipelineRuns PipelineRun Ausführungsinformationen für Pipelines. Einen Beispielbericht finden Sie unter Beispielbericht zum Trend der Pipelinedurchlaufrate.
PipelineRunActivityResults PipelineRunActivityResult Zusammengeführtes Protokoll aller Phasen, Schritte, Aufträge und Aufgaben innerhalb einer bestimmten Pipelineausführung. Einen Beispielbericht finden Sie unter Beispielbericht zur Dauer des Pipelinetasks.
PipelineTasks PipelineTask Eigenschaften für Aufgaben, die innerhalb einer Pipeline verwendet werden.
TaskAgentPoolSizeSnapshots TaskAgentPoolSizeSnapshot (Zusammengesetzt) Unterstützt das Verständnis von Poolgröße, Pipelineaufträgen und Parallelität. Das Verlaufsdiagramm für Agentpools veranschaulicht, wie dieser Entitätssatz verwendet werden kann.
TaskAgentRequestSnapshots TaskAgentRequestSnapshot (Zusammengesetzt) Unterstützt die Berichterstellung zu Task-Agent-Anforderungen.

Branches

Die folgenden Eigenschaften sind für den Entitätssatz Branches gültig. Ersatzschlüssel, die Branch zugeordnet sind, umfassen BranchSK und ProjectSK.

Anzeigename Name Datentyp Beschreibung
AnalyticsUpdatedDate Datetime Wasserzeichen, das den Zeitpunkt angibt, zu dem die Analysedaten zuletzt aktualisiert wurden.
Branchname BranchName String Der Name, der einem Branch zugewiesen ist, wenn er erstellt wird.
Repository-ID RepositoryId String Die Nummer, die einem Repository zugewiesen ist, wenn es erstellt wird.
Repository-Vsts-ID RepositoryVstsId String Die Nummer, die einem TFVC-Repository zugewiesen ist, wenn es erstellt wird.
RepositoryUrl RepositoryUrl String Die URL, die für ein Repository definiert wird, wenn es erstellt wird.

Navigationseigenschaften umfassen Project und deren referenzielle Einschränkung ProjectSK.

ParallelPipelineJobsSnapshot

Die folgenden Eigenschaften sind für den Entitätssatz ParallelPipelineJobsSnapshot gültig. Zu den Referenzschlüsseln gehören:

  • IsHosted
  • ParallelismTag
  • SamplingDate
Anzeigename Name Datentyp Beschreibung
Gehostet oder selbstgehostet IsHosted Boolean Gibt an, ob die parallele Pipeline auf einem von Microsoft gehosteten Agent (True) oder selbstgehostet (False) ausgeführt wird. Weitere Informationen finden Sie unter Azure Pipelines-Agents.
Fehler beim Erreichen aller Anbieter FailedToReachAllProviders Boolean Gibt an, ob die Auftragsausführung alle Anbieter erreicht hat (True) oder nicht (False).
Anzahl paralleler Pipelineaufträge TotalCount Int32 Die Anzahl der Aufträge, die im Rahmen des Momentaufnahme ausgeführt werden.
Anzahl paralleler Pipelines minuten TotalMinutes Int32 Die Anzahl der Minuten, die zum Ausführen des Momentaufnahme.
Parallelitätstyp ParallelismTag String Ein Tag, das den Typ der Parallelität angibt, die dem auftrag Momentaufnahme zugeordnet ist.
Premium-Typ IsPremium Boolean Gibt an, ob die parallele Pipeline Premium (True) oder nicht (False) ist.
Beispieldatum SamplingDate Datetime Das Datum, das dem Momentaufnahme zugeordnet ist.

Pipelines

Die folgenden Eigenschaften sind für Pipelines und deren Ersatzschlüssel PipelineSKgültig.

Anzeigename Name Datentyp Beschreibung
Pipeline-ID PipelineId Int32 Die der Pipeline zugewiesene ID.
Pipelinename PipelineName String Der der Pipeline zugewiesene Name.
Pipelineversion PipelineVersion Int32 Die der Pipeline zugeordnete Version.
Pipelineprozesstyp PipelineProcessType Enumerated Der Typ der Pipelinedefinition. Gültige Werte sind unten für PipelineProcessType aufgeführt.

Navigationseigenschaften umfassen Project und deren referenzielle Einschränkung ProjectSK.

PipelineProcessType enumerierte Typmber

Die folgenden Member sind für den enumerationierten Typ definiert, der PipelineProcessType die Methode angibt, die zum Definieren der Pipeline verwendet wird.

Membername Wert Definition
Designer 1 Klassische Pipelinedefinition.
Yaml 2 YAML-Pipelinedefinition.
Docker 3 Docker-Pipelinedefinition.

PipelineJobs

Ein Pipelineauftrag besteht aus einer Reihe von Schritten, die sequenziell als Einheit ausgeführt werden. Ein Auftrag ist die kleinste Arbeitseinheit, die Sie für die Ausführung planen können. Pipelines sind um Aufträge organisiert, und jede Pipeline verfügt über mindestens einen Auftrag. Weitere Informationen finden Sie unter Angeben von Aufträgen in Ihrer Pipeline.

Die folgenden Eigenschaften sind für PipelineJobs und dessen PipelineJobSK Ersatzschlüssel gültig.

Anzeigename Name Datentyp Beschreibung
Vollständiger Name des Pipelineauftrags FullJobName String Der vollständige Name eines Pipelineauftrags.
Pipeline-ID PipelineId Int32 Die ID, die der Pipeline zugewiesen ist, in der der Auftrag definiert ist.
Pipelineauftragsbezeichner JobId String Der Auftragsbezeichner, der einem Pipelineauftrag zugewiesen ist, wenn er erstellt wird.
Pipelineauftragsname JobName String Der dem Pipelineauftrag zugewiesene Name.
Name der Pipelinephase StageName String Der dem Pipelineauftrag zugeordnete Phasenname.
Attribute der Pipelineauftragsstrategie StrategyAttributes String Die für den Pipelineauftrag definierten Attribute.
Phasenbezeichner StageId String Der dem Pipelineauftrag zugeordnete Phasenbezeichner.

Navigationseigenschaften umfassen Project und deren referenzielle Einschränkung ProjectSK.

Einen Beispielbericht, der den Entitätstyp PipelineJob abfragt, finden Sie unter Beispielbericht zu Fehlern in der Pipelinephase.

PipelineRuns

Eine Pipelineausführung stellt eine einzelne Ausführung einer Pipeline dar. Während einer Ausführung wird die Pipeline verarbeitet, und Agents verarbeiten einen oder mehrere Aufträge. Eine Pipelineausführung umfasst Aufträge, Schritte und Aufgaben. Weitere Informationen finden Sie unter Pipelineausführungssequenz.

Die folgenden Eigenschaften sind für den Entitätstyp PipelineRun und dessen PipelineRunSK Ersatzschlüssel gültig.

Anzeigename Name Datentyp Beschreibung
Anzahl abgebrochener Daten CanceledCount Int32 Die Anzahl der pipelineausführungen, die abgebrochen wurden.
Fertigstellungsdatum CompletedDate Datetime Das Datum und die Uhrzeit, zu dem die Ausführung der Pipeline abgeschlossen ist.
Anzahl der Fehler FailedCount Int32 Die Anzahl der erfolgreichen Pipelineausführungen.
Nummernrevision RunNumberRevision Int32 Die Nummer, die einer Pipelineausführung mit sequenziellen Ausführungen zugewiesen ist.
Teilweise erfolgreiche Anzahl PartiallySucceededCount Int32 Die Anzahl der Pipelineausführungen, die teilweise erfolgreich waren.
Pipelineausführungs-ID PipelineRunId Int32 Die Nummer, die einer Pipelineausführung zugewiesen ist.
Datum in der Warteschlange QueuedDate Datetime Das Datum und die Uhrzeit der Ausführung der Pipeline in der Warteschlange.
Warteschlangendauer in Sekunden QueueDurationSeconds Decimal Die Anzahl der Sekunden, für die die Pipeline in der Warteschlange verblieb.
Run Number RunNumber String Die Nummer, die einer Pipelineausführung zugewiesen ist, wenn sie ausgeführt wird.
Ergebnis ausführen RunOutcome Enumerated Das Ergebnis, das einer Pipeline nach Abschluss der Ausführung zugewiesen wird. Gültige Werte sind unten für PipelineRunOutcome aufgeführt.
Ausführungsgrund RunReason Enumerated Die Bedingung, die die Ausführung der Pipeline verursacht hat. Gültige Werte sind unten für PipelineRunReason aufgeführt.
Ausführungsdauer sekunden RunDurationSeconds Decimal Die Anzahl der Sekunden, die bis zum Abschluss der Pipelineausführung benötigt wurden.
Startdatum StartedDate Datetime Datum und Uhrzeit des Beginns der Pipelineausführung.
Anzahl erfolgreich SucceededCount Int32 Die Anzahl der erfolgreichen Pipelineausführungen.
Gesamtdauer in Sekunden TotalDurationSeconds Decimal Die Gesamtanzahl der Sekunden, die sich die Pipeline in der Warteschlange befand und ausgeführt wurde.

Die folgenden Navigationseigenschaften werden unterstützt.

Anzeigename Name -Referenzielle Einschränkung Eigenschaft referenziert
Branch Branch BranchSK BranchSK
Abgeschlossen am CompletedOn CompletedDateSK DateSK
In der Warteschlange ein QueuedOn QueuedDateSK DateSK
Gestartet am StartedOn QueuedDateSK DateSK
Pipeline Pipeline PipelineSK PipelineSK
Projekt Project ProjectSK ProjectSK

PipelineRunReason enumerierte Typenmber

Die folgenden Member sind für den PipelineRunReason aufgezählten Typ definiert, der die Bedingungen angibt, unter denen jede Pipelinephase, jeder Auftrag oder jeder Schritt ausgeführt wird, wie unter Bedingungen angeben beschrieben.

Membername Wert `Display name`
None 0 Keine
Manual 1 Manuell
IndividualCI 2 Individuelle CI
BatchedCI 4 Batch-CI
Schedule 8 Zeitplan
UserCreated 32 Benutzer erstellt
ValidateShelveset 64 Überprüfen von Shelveset
CheckInShelveset 128 Check In Shelveset
PullRequest 256 Pull Request
PipelineRunCompletion 512 Buildabschluss

PipelineRunOutcome enumerierte Typmember

Die folgenden Member sind für den PipelineRunOutcome aufgezählten Typ definiert, der das Ergebnis einer Pipelineausführung angibt.

Membername Wert `Display name`
None 0 Keine
Succeed 2 Erfolg
PartiallySucceeded 4 Teilweise erfolgreich
Failed 6 Fehler
Canceled 32 Canceled

PipelineRunActivityResults

Die folgenden Eigenschaften sind für den PipelineRunActivityResults-Entitätssatz und dessen PipelineRunActivityResultSK Ersatzschlüssel gültig.

Viele Eigenschaften sind datums- oder benutzerbasiert. Diese Eigenschaften sind den Entitätssätzen CalendarDate und User zugeordnet, die unter Kalenderdatum, Projekt und Benutzermetadatenreferenz beschrieben sind.

Anzeigename Name Datentyp Beschreibung
Anzahl aufgegeben AbandonedCount Int32 Die Anzahl der Pipelineausführungen, die als abgebrochen markiert wurden.
Aktivität abgeschlossen ActivityCompletedDate Datetime Das Datum und die Uhrzeit, zu dem die Pipelineausführung abgeschlossen ist.
Aktivitätsdauer in Sekunden ActivityDurationSeconds Decimal Die Gesamtanzahl der Sekunden, die sich die Pipeline in der Warteschlange befand und ausgeführt wurde.
Startdatum der Aktivität ActivityStartedDate Datetime Datum und Uhrzeit des Startdatums der Pipelineausführung.
Anzahl abgebrochen CanceledCount Int32 Die Anzahl der pipelineausführungen, die abgebrochen wurden.
Anzahl der Fehler FailedCount Int32 Die Anzahl der pipelineausführungen, bei denen ein Fehler aufgetreten ist.
Pipelineaktivitätstyp ActivityType Enumerated Der Typ der Pipelineaktivität. Gültige Werte sind unten für PipelineActivityType aufgeführt.
Pipelineausführungs-ID PipelineRunId Int32 Die Nummer, die einer Pipelineausführung zugewiesen ist, wenn sie ausgeführt wird.
Ergebnis der Pipelineausführung PipelineRunOutcome Enumerated Das Ergebnis, das einer Pipeline nach Abschluss der Ausführung zugewiesen wird. Gültige Werte werden unter PipelineRunOutcome aufgeführt.
Relative Startzeit von Auftragssekunden RelativeStartTimeFromJobSeconds Int32 Die Anzahl der Sekunden, die seit dem Beginn des Auftrags verstrichen sind.
Relative Startzeit von Phasensekunden RelativeStartTimeFromStageSeconds Int32 Die Anzahl der Sekunden, die vom Anfang der Phase verstrichen sind.
Relative Startzeit von Ausführungssekunden RelativeStartTimeFromRunSeconds Int32 Die Anzahl der Sekunden, die verstrichen ist, als die Ausführung ausgeführt wurde.
Übersprungene Anzahl SkippedCount Int32 Die Anzahl der Pipelineausführungen, die übersprungen wurden.
Anzahl der Erfolgreichen SucceededCount Int32 Die Anzahl der erfolgreichen Pipelineausführungen.
Erfolgreich mit Der Anzahl der Probleme SucceededWithIssuesCount Int32 Die Anzahl der Pipelineausführungen, die teilweise erfolgreich waren.
Anzeigename des Vorgangs TaskDisplayName String Name einer Aufgabe, die in der Pipelineausführung ausgeführt wird.
Vorgangsprotokollpfad TaskLogPath String Der Pfad der protokolldatei, die von einer Aufgabe generiert wird.
Vorgangsergebnis TaskOutcome Benutzerdefiniert Das Ergebnis der ausgeführten Aufgabe.

Beispielberichte, die den Entitätstyp PipelineRunActivityResult abfragen, finden Sie unter Beispielbericht zum Trendbericht für die Dauer des Pipelinetasks.

Navigationseigenschaften enthalten die in der folgenden Tabelle aufgeführten Eigenschaften.

Anzeigename Name Referenzielle Einschränkung Referenzierte Eigenschaft
Aktivität gestartet am ActivityStartedOn ActivityStartedDateSK DateSK
Branch Branch BranchSK BranchSK
Pipeline Pipeline PipelineSK PipelineSK
Pipelinetask PipelineTask PipelineTaskSK PipelineTaskSK
Pipelineauftrag PipelineJob PipelineJobSK PipelineJobSK
Pipelineausführung in der Warteschlange ein PipelineRunQueuedOn PipelineRunQueuedDateSK DateSK
Pipelineausführung gestartet am PipelineRunStartedOn PipelineRunStartedDateSK DateSK
Pipelineausführung abgeschlossen am PipelineRunCompletedOn PipelineRunCompletedDateSK DateSK
Pipelineausführung gestartet am PipelineRunStartedOn PipelineRunStartedDateSK DateSK
Projekt Project ProjectSK ProjectSK

PipelineActivityType enumerierte Typmber

Die folgenden Member sind für den PipelineActivityType enumerationierten Typ definiert.

Membername Wert `Display name`
Task 0 Aufgabe
Approval 1 Genehmigung
AgentWait 2 Agent-Wartevorgang

PipelineTasks

Die folgenden Eigenschaften gelten für den PipelineTasks-Entitätssatz und dessen Ersatzschlüssel PipelineTaskSK.

Anzeigename Name Datentyp Beschreibung
Aufgabendefinitions-ID TaskDefinitionId GUID Die GUID, die einem Pipelinetask zugewiesen ist.
Aufgabendefinitionsversion TaskDefinitionVersion String Die einem Pipelinetask zugewiesene Version.

Navigationseigenschaften umfassen Project und deren referenzielle Einschränkung ProjectSK.

TaskAgentPoolSizeSnapshots

Die folgenden Eigenschaften sind für den Entitätssatz TaskAgentPoolSizeSnapshots und dessen Ersatzschlüssel SamplingDategültig.

Anzeigename Eigenschaftenname Datentyp Beschreibung
Onlineanzahl OnlineCount Int32 Die Anzahl der Agents, die im Agentpool online sind, als die Aufgabe ausgeführt wurde.
Offlineanzahl OfflineCount Int32 Die Anzahl der Agents, die im Agentpool offline sind, als die Aufgabe ausgeführt wurde.
Pool-ID PoolId Int32 Die Nummer, die dem Agentpool zugewiesen ist.
Beispieldatum SamplingDate Datetime Das Datum und die Uhrzeit, zu dem die Poolgröße angedockt wurde.

Einen Beispielbericht, der aus der TaskAgentPoolSizeSnapshot-Entität erstellt wurde, finden Sie unter Verlaufsdiagramm für Agentpools (Vorschau).

TaskAgentRequestSnapshots

Agentpools werden zugeordnet, wenn eine Aufgabe ausgeführt wird. Der TaskAgentRequestSnapshots-Entitätssatz erfasst Daten im Zusammenhang mit den Anforderungen des Task-Agents.

Die folgenden Eigenschaften sind für den Entitätstyp TaskAgentRequestSnapshot und dessen Ersatzschlüssel SamplingTime und SamplingDateSKgültig.

Anzeigename Name Datentyp Beschreibung
Build in der Warteschlange IsQueued Boolean Gibt an, ob der Build in die Warteschlange (True) oder nicht in die Warteschlange (False) eingereiht wird.
Build wird ausgeführt IsRunning Boolean Gibt an, ob der Build ausgeführt wird (True) oder nicht ausgeführt wird (False).
Gehostet oder selbstgehostet IsHosted Boolean Gibt an, ob der der Aufgabe zugewiesene Agent gehostet (True) oder selbstgehostet (False) ist.
Auftragsenddatum FinishedDate Datetime Das Datum und die Uhrzeit, zu dem die Ausführung der Task-Agent-Anforderung beendet wurde.
FinishedDateSK Int32 Das Datum, an dem die Ausführung der Task-Agent-Anforderung abgeschlossen wurde, ausgedrückt als YYYYMMDD in der Zeitzone, die für die organization definiert ist.
Datum in der Warteschlange QueuedDate Datetime Das Datum und die Uhrzeit, zu dem die Task-Agent-Anforderung in die Warteschlange gestellt wurde.
QueuedDateSK Int32 Das Datum, an dem die Task-Agent-Anforderung in die Warteschlange eingereiht wurde, ausgedrückt in YYYYMMDD der Zeitzone, die für die organization definiert wurde.
Warteschlangendauer in Sekunden QueueDurationSeconds Decimal Die Anzahl der Sekunden, in denen die Task-Agent-Anforderung in der Warteschlange verblieb, bevor ein Agent zugewiesen wurde.
Pool-ID PoolId Int32 Die Nummer, die dem Agentpool zugewiesen ist, der der Task-Agent-Anforderung zugewiesen ist.
Pipelinetyp PipelineType String Der Pipelinetyp, der die Task-Agent-Anforderung enthält.
Anforderungs-ID RequestId Int64 Die Nummer, die der Task-Agent-Anforderung zugewiesen ist.
Beispielstunde SamplingHour Int32 Die Zahl, die der Stunde zugewiesen wurde, als die Anforderung empfangen wurde.
Beispielzeit SamplingTime Datetime Datum und Uhrzeit des Empfangens der Task-Agent-Anforderung.
Startdatum StartedDate Datetime Das Datum und die Uhrzeit der Ausführung der Task-Agent-Anforderung.
StartedDateSK Int32 Das Datum, an dem die Task-Agent-Anforderung mit der Ausführung begonnen hat, ausgedrückt in YYYYMMDD der für die organization definierten Zeitzone.

Navigationseigenschaften enthalten die in der folgenden Tabelle aufgeführten Eigenschaften.

Anzeigename Name Referenzielle Einschränkung -Referenced-Eigenschaft
Branch Branch BranchSK BranchSK
Abgeschlossen am CompletedOn CompletedDateSK DateSK
Auftragsendzeit FinishedOn FinishedDateSK DateSK
Ein in die Warteschlange eingereiht QueuedOn QueuedDateSK DateSK
Pipeline Pipeline PipelineSK PipelineSK
Projekt Project ProjectSK ProjectSK
Gestartet am StartedOn QueuedDateSK DateSK