Freigeben über

Metadatenreferenz für Azure Pipelines Analytics

  • Artikel

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

Der Analysedienst sammelt Pipeline- und Testaktivitäten, die über Azure-Pipelines generiert werden. In diesem Artikel werden die Eigenschaften beschrieben, die Sie zum Generieren eines Analyseberichts für Pipelines verwenden 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 enumerierten Typen, die vom Analytics-Datenmodell unterstützt werden, werden bereitgestellt. Dies ist ein früher Entwurf. Bitte geben Sie Feedback zu Bereichen, die Sie gerne mehr Informationen haben möchten. 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 Analyseversion v3.0-preview unterstützt keine Momentaufnahmen.

EntitySet EntityType Beschreibung
Branches Branch Grundlegende Informationen zu Verzweigungen, die in Tests oder Pipelines verwendet werden. Ein Beispielbericht finden Sie im Statusstatus-Beispielbericht.
ParallelPipelineJobsSnapshot ParallelPipelineJobsSnapshot (Zusammengesetzt) Unterstützt das Verständnis der parallelen Pipelinenutzung. Weitere Informationen zu parallelen Pipelinetests finden Sie unter Paralleles Ausführen von Tests mithilfe der Visual Studio Test-Aufgabe.
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 im Beispielbericht zur Pipelinedurchlaufrate.
PipelineRunActivityResults PipelineRunActivityResult Zusammengeführtes Protokoll aller Phasen, Schritte, Aufträge und Aufgaben innerhalb einer bestimmten Pipelineausführung. Einen Beispielbericht finden Sie im Beispielbericht zu Pipelineaufgabendauer.
PipelineTasks PipelineTask Eigenschaften für Aufgaben, die in 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 für Task-Agent-Anforderungen.

Branches

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

Anzeigename Name Datentyp Beschreibung
AnalyticsUpdatedDate DateTime Wasserzeichen, das den Zeitpunkt angibt, zu dem die Analysedaten zuletzt aktualisiert wurden.
Verzweigungsname BranchName String Der Name, der einer Verzweigung 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 ist, wenn es erstellt wird.

Navigationseigenschaften umfassen Project und deren referenzielle Einschränkung ProjectSK.

ParallelPipelineJobsSnapshot

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

  • IsHosted
  • ParallelismTag
  • SamplingDate
Anzeigename Name Datentyp Beschreibung
Gehostet oder selbst gehostet IsHosted Boolean Gibt an, ob die parallele Pipeline auf einem von Microsoft gehosteten Agent (True) ausgeführt wird oder selbst gehostet wird (False). Weitere Informationen finden Sie unter Azure Pipelines-Agents.
Fehler beim Erreichen aller Anbieter FailedToReachAllProviders Boolean Gibt an, ob der Auftrag alle Anbieter (True) erreicht hat oder nicht (False).
Anzahl der Parallelpipelineaufträge TotalCount Int32 Die Anzahl der Aufträge, die als Teil der Momentaufnahme ausgeführt werden.
Anzahl der parallelen Pipelines Minuten TotalMinutes Int32 Die Anzahl der Minuten, die zum Ausführen der Momentaufnahme unternommen wurden.
Parallelitätstyp ParallelismTag String Ein Tag, das den Typ der Parallelität angibt, die der Auftragsmomentaufnahme zugeordnet ist.
Premium-Typ IsPremium Boolean Gibt an, ob die parallele Pipeline Premium (True) ist oder nicht (False).
Beispieldatum SamplingDate DateTime Das Datum, das der 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 Name, der der Pipeline zugewiesen ist.
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.

Elemente des PipelineProcessType-Aufzählungstyps

Die folgenden Member werden für den PipelineProcessType Aufzählungstyp definiert, der die Zum Definieren der Pipeline verwendete Methode angibt.

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

PipelineJobs

Ein Pipelineauftrag ist eine 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 hat mindestens einen Auftrag. Weitere Informationen finden Sie unter Angeben von Aufträgen in Ihrer Pipeline.

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

Anzeigename Name Datentyp Beschreibung
Name des vollständigen Auftrags der Pipeline 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.
Name des Pipelineauftrags JobName String Der Name, der dem Pipelineauftrag zugewiesen ist.
Name der Pipelinephase StageName String Der Dem Pipelineauftrag zugeordnete Phasenname.
Attribute der Pipelineauftragsstrategie StrategyAttributes String Die Attribute, die für den Pipelineauftrag definiert sind.
Phasenbezeichner StageId String Der Phasenbezeichner, der dem Pipelineauftrag zugeordnet ist.

Navigationseigenschaften umfassen Project und deren referenzielle Einschränkung ProjectSK.

Einen Beispielbericht, der den PipelineJob-Entitätstyp abfragt, finden Sie im Beispielbericht zu Pipelinephasenfehlern.

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 gelten für den PipelineRun-Entitätstyp und dessen PipelineRunSK Ersatzschlüssel.

Anzeigename Name Datentyp Beschreibung
Abgebrochene Anzahl CanceledCount Int32 Die Anzahl der Pipelineausführungen, die abgebrochen wurden.
Abschlussdatum CompletedDate DateTime Das Datum und die Uhrzeit, zu dem die Pipeline die Ausführung abgeschlossen hat.
Fehleranzahl FailedCount Int32 Die Anzahl der erfolgreichen Pipelineausführungen.
Nummernrevision RunNumberRevision Int32 Die nummer, die einer Pipelineausführung mit sequenziellen Ausführungen zugewiesen ist.
Teilweise erfolgreich anzahl PartiallySucceededCount Int32 Die Anzahl der Pipelineläufe, die teilweise erfolgreich waren.
Pipelineausführungs-ID PipelineRunId Int32 Die Nummer, die einer Pipelineausführung zugewiesen ist.
In die Warteschlange eingereihtes Datum QueuedDate DateTime Das Datum und die Uhrzeit der Ausführung der Pipeline in der Warteschlange.
Warteschlangendauer Sekunden QueueDurationSeconds Decimal Die Anzahl der Sekunden, die die Pipeline in der Warteschlange blieb.
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 wurde. Gültige Werte sind unten für PipelineRunOutcome aufgeführt.
Ausführungsgrund RunReason Enumerated Die Bedingung, die dazu führte, dass die Pipeline ausgeführt wurde. Gültige Werte sind unten für PipelineRunReason aufgeführt.
Laufzeitdauer Sekunden RunDurationSeconds Decimal Die Anzahl der Sekunden, die für den Abschluss der Pipeline benötigt wurden.
Startdatum StartedDate DateTime Das Datum und die Uhrzeit, zu dem die Pipelineausführung begonnen hat.
Anzahl erfolgreich SucceededCount Int32 Die Anzahl der erfolgreichen Pipelineausführungen.
Gesamtdauer Sekunden TotalDurationSeconds Decimal Die Gesamtanzahl der Sekunden, die die Pipeline in der Warteschlange war und ausgeführt wurde.

Die folgenden Navigationseigenschaften werden unterstützt.

Anzeigename Name -Referentielle Einschränkung Referenzierte Eigenschaft
Branch Branch BranchSK BranchSK
Abgeschlossen am CompletedOn CompletedDateSK DateSK
In die Warteschlange eingereiht am QueuedOn QueuedDateSK DateSK
Gestartet am StartedOn QueuedDateSK DateSK
Pipeline Pipeline PipelineSK PipelineSK
Projekt Project ProjectSK ProjectSK

Elemente des PipelineRunReason-Aufzählungstyps

Die folgenden Member werden für den PipelineRunReason Aufzählungstyp 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 Validate Shelveset
CheckInShelveset 128 Einchecken von Regalen
PullRequest 256 Pull Request
PipelineRunCompletion 512 Buildabschluss

Elemente des PipelineRunOutcome-Aufzählungstyps

Die folgenden Member werden für den PipelineRunOutcome Aufzählungstyp 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 Storniert

PipelineRunActivityResults

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

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
Verlassene Anzahl AbandonedCount Int32 Die Anzahl der Pipelineläufe, die als abgebrochen markiert wurden.
Abgeschlossenes Datum der Aktivität ActivityCompletedDate DateTime Das Datum und die Uhrzeit, zu dem die Pipelineausführung abgeschlossen ist.
Aktivitätsdauer Sekunden ActivityDurationSeconds Decimal Die Gesamtanzahl der Sekunden, die die Pipeline in der Warteschlange war und ausgeführt wurde.
Startdatum der Aktivität ActivityStartedDate DateTime Datum und Uhrzeit, zu der die Pipelineausführung gestartet wurde.
Abgebrochene Anzahl CanceledCount Int32 Die Anzahl der Pipelineausführungen, die abgebrochen wurden.
Fehleranzahl FailedCount Int32 Die Anzahl der pipelineausführungen, die fehlgeschlagen sind.
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 wurde. Gültige Werte werden unter PipelineRunOutcome aufgeführt.
Relative Startzeit von Auftrags sekunden RelativeStartTimeFromJobSeconds Int32 Die Anzahl der Sekunden, die vom Anfang des Auftrags verstrichen sind.
Relative Startzeit von Phasen sekunden RelativeStartTimeFromStageSeconds Int32 Die Anzahl der Sekunden, die vom Anfang der Phase verstrichen sind.
Relative Startzeit von Laufzeit sekunden RelativeStartTimeFromRunSeconds Int32 Die Anzahl der Sekunden, die beim Ausführen der Ausführung verstrichen sind.
Übersprungene Anzahl SkippedCount Int32 Die Anzahl der Pipelineausführungen, die übersprungen wurden.
Anzahl erfolgreich SucceededCount Int32 Die Anzahl der erfolgreichen Pipelineausführungen.
Mit der Anzahl der Probleme erfolgreich SucceededWithIssuesCount Int32 Die Anzahl der Pipelineläufe, die teilweise erfolgreich waren.
Anzeigename der Aufgabe 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 im Trendbericht zu Pipelineaufgabendauer.

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
Pipelinevorgang PipelineTask PipelineTaskSK PipelineTaskSK
Pipelineauftrag PipelineJob PipelineJobSK PipelineJobSK
Pipelineausführung in der Warteschlange aktiviert 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

Elemente des PipelineActivityType-Aufzählungstyps

Die folgenden Member werden für den PipelineActivityType Aufzählungstyp definiert.

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

PipelineTasks

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

Anzeigename Name Datentyp Beschreibung
Vorgangsdefinitions-ID TaskDefinitionId GUID Die GUID, die einem Pipelinevorgang zugewiesen ist.
Aufgabendefinitionsversion TaskDefinitionVersion String Die einer Pipelineaufgabe zugewiesene Version.

Navigationseigenschaften umfassen Project und deren referenzielle Einschränkung ProjectSK.

TaskAgentPoolSizeSnapshots

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

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

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

TaskAgentRequestSnapshots

Agentpools werden zugewiesen, wenn eine Aufgabe ausgeführt wird. Die TaskAgentRequestSnapshots-Entität erfasst Daten im Zusammenhang mit den Aufgaben-Agent-Anforderungen.

Die folgenden Eigenschaften gelten für den TaskAgentRequestSnapshot-Entitätstyp und dessen Ersatzschlüssel SamplingTime und SamplingDateSK.

Anzeigename Name Datentyp Beschreibung
Erstellen in der Warteschlange IsQueued Boolean Gibt an, ob der Build in die Warteschlange gestellt (True) oder nicht in die Warteschlange eingereiht ist (False).
Build wird ausgeführt IsRunning Boolean Gibt an, ob der Build ausgeführt wird (True) oder nicht ausgeführt wird (False).
Gehostet oder selbst gehostet IsHosted Boolean Gibt an, ob der der Aufgabe zugewiesene Agent gehostet wird (True) oder selbst gehostet (False).
Enddatum des Auftrags FinishedDate DateTime Datum und Uhrzeit der Ausführung der Task-Agent-Anforderung.
FinishedDateSK Int32 Das Datum, an dem die Ausführung der Task-Agent-Anforderung abgeschlossen ist, ausgedrückt in YYYYMMDD der Zeitzone, die für die Organisation definiert ist.
In die Warteschlange eingereihtes Datum QueuedDate DateTime Datum und Uhrzeit, zu der die Task-Agent-Anforderung in die Warteschlange gestellt wurde.
QueuedDateSK Int32 Das Datum, an dem die Task-Agent-Anforderung in die Warteschlange gestellt wurde, ausgedrückt in YYYYMMDD der Zeitzone, die für die Organisation definiert ist.
Warteschlangendauer Sekunden QueueDurationSeconds Decimal Die Anzahl der Sekunden, die die Task-Agent-Anforderung in der Warteschlange blieb, 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 stundenweise zugewiesen wurde, als die Anforderung empfangen wurde.
Beispielzeit SamplingTime DateTime Datum und Uhrzeit, zu der die Task-Agent-Anforderung empfangen wurde.
Startdatum StartedDate DateTime Datum und Uhrzeit der Ausführung der Task-Agent-Anforderung.
StartedDateSK Int32 Das Datum, an dem die Ausführung der Task-Agent-Anforderung gestartet wurde, ausgedrückt in YYYYMMDD der Zeitzone, die für die Organisation definiert ist.

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
In die Warteschlange eingereiht am QueuedOn QueuedDateSK DateSK
Pipeline Pipeline PipelineSK PipelineSK
Projekt Project ProjectSK ProjectSK
Gestartet am StartedOn QueuedDateSK DateSK