Metadatenreferenz für Azure Pipelines Analytics
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:
IsHostedParallelismTagSamplingDate
| 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. |
Navigationseigenschaften
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
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 |