Datenmodell für Analytics

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

Das Analysedatenmodell für Azure DevOps besteht aus Entitätssätzen, deren Member (Entitäten) Eigenschaften enthalten, die gefiltert, aggregiert und zusammengefasst werden können. Darüber hinaus enthalten sie Navigationseigenschaften , die Entitäten miteinander in Beziehung setzen und zugriff auf andere Eigenschaften zum Auswählen, Filtern und Gruppieren ermöglichen.

Hinweis

Der Analytics-Dienst wird automatisch aktiviert und in der Produktion für alle Azure DevOps Services unterstützt. Die Power BI-Integration und der Zugriff auf den OData-Feed des Analytics-Diensts sind allgemein verfügbar. Wir empfehlen Ihnen, es zu verwenden und uns Feedback zu geben. Verfügbare Daten sind versionsabhängig. Die neueste unterstützte Version ist v2.0, und die neueste Vorschauversion ist v4.0-preview. Weitere Informationen finden Sie unter OData-API-Versionsverwaltung.

Schemanamespaces

Das Analytics-Datenmodell basiert auf zwei Schemanamespaces:

• Microsoft.VisualStudio.Services.Analytics.Model
• Microsoft.VisualStudio.Services.Analytics.

Entitätssätze und Entitätstypen

Entitätstypen werden als strukturierte Typen mit einem Schlüssel bezeichnet. Sie definieren die benannten Eigenschaften und Beziehungen jeder Entität. Der Schlüssel eines EntityType wird aus einer Teilmenge der primitiven Eigenschaften gebildet, z. B. WorkItemId, PipelineId, ReleasePipelineId und mehr des Entitätstyps.

Entitätssätze sind benannte Sammlungen von Entitäten. Beispielsweise ist ein Entitätssatz, WorkItems der Entitäten enthält WorkItem . Der Schlüssel einer Entität identifiziert die Entität innerhalb einer Entitätsgruppe eindeutig. Wenn mehrere Entitätssätze denselben Entitätstyp verwenden, kann dieselbe Kombination von Schlüsselwerten in mehr als einem Entitätssatz angezeigt werden und unterschiedliche Entitäten identifizieren, eine pro Entitätsgruppe, in der diese Tastenkombination angezeigt wird. Jede dieser Entitäten weist eine andere Entitäts-ID auf. Entitätssätze bieten Einstiegspunkte in das Datenmodell.

Entitätssätze werden in OData-Metadaten beschrieben und variieren je nach Projekt. Sie können die vollständige Liste der Entitätssätze, Entitätstypen und Eigenschaften untersuchen, indem Sie die OData-Metadaten für Ihr Projekt anfordern. Informationen dazu finden Sie unter Erstellen von OData-Abfragen für Analytics.

Zusammengesetzte Entitäten

Zusammengesetzte Entitäten unterstützen bestimmte Szenarien. Sie bestehen aus einfacheren Entitäten, erfordern häufig mehr Rechenressourcen für die Generierung und geben möglicherweise größere Resultsets zurück. Um die beste Leistung zu erzielen und unnötige Drosselung zu vermeiden, stellen Sie sicher, dass Sie die richtige Entität für Ihr Szenario abfragen.

Beispielsweise kombiniert WorkItemRevisions und Dates so, WorkItemSnapshot dass jedes Datum eine Revision für jedes Arbeitselement hat. Diese Darstellung unterstützt OData-Abfragen, die sich auf Trenddaten für einen gefilterten Satz von Arbeitselementen konzentrieren. Sie sollten diese zusammengesetzte Entität jedoch nicht verwenden, um den aktuellen Status von Arbeitselementen abzufragen. Stattdessen sollten Sie den Entitätssatz WorkItems verwenden, um eine schneller ausgeführte Abfrage zu generieren.

Ebenso können einige Entitäten alle Verlaufswerte enthalten, während andere nur aktuelle Werte enthalten. WorkItemRevisions enthält den gesamten Arbeitselementverlauf, den Sie nicht in Szenarien verwenden sollten, in denen die aktuellen Werte von Interesse sind.

Beziehungen

Um komplexere Abfrageergebnisse zu generieren, können Sie Entitäten mithilfe von Beziehungen kombinieren. Sie können Beziehungen verwenden, um Daten zu erweitern, zu filtern oder zusammenzufassen.

Einige Navigationseigenschaften führen zu einer einzelnen Entität, während andere zu einer Sammlung von Entitäten führen. Das folgende Diagramm zeigt ausgewählte Entitäten und deren Navigationseigenschaften. Zur Übersichtlichkeit wurden einige zusammengesetzte Entitäten und Beziehungen weggelassen.

Beziehungsschlüssel

Entitätsbeziehungen werden auch als Fremdschlüssel dargestellt, sodass externe Tools Entitäten verknüpfen können. Diese Eigenschaften haben das Suffix "SK" und sind entweder ganzzahlige oder GUID-Datentypen. Date-Eigenschaften verfügen über entsprechende ganzzahlige Datumsschlüsseleigenschaften im folgenden Format: JJJJMMDD.

Entitätstypen und Entitätsgruppen zur Arbeitsnachverfolgung

Die folgenden Entitätstypen und Entitätssätze werden mit den angegebenen API-Versionen unterstützt. Eine vollständige Referenz finden Sie unter Referenz zu Metadaten zur Arbeitsnachverfolgung für Azure Boards Analytics.

EntityType/EntitySet	BESCHREIBUNG	v1.0	v2.0	v3.0-preview	v4.0-preview
Bereich/ Bereiche	Das Arbeitselement Bereichspfade mit Eigenschaften zum Gruppieren und Filtern nach Bereichshierarchie.	✔️	✔️	✔️	✔️
Iteration/ Iterationen	Das Arbeitselement Iterationspfade mit Eigenschaften zum Gruppieren und Filtern nach Iterationshierarchie.	✔️	✔️	✔️	✔️
BoardLocation/ BoardLocations	Die Zellenstandorte des Kanban-Boards, die durch Boardspalte, Swimlane und Split identifiziert werden, enthalten historische Boardeinstellungen. Eine Beschreibung der einzelnen Kanban-Boardfelder finden Sie unter Workflow- und Kanban-Boardfelder.	✔️	✔️	✔️	✔️
CalendarDate/ Datumsangaben	Die Datumsangaben, die zum Filtern und Gruppieren anderer Entitäten mithilfe von Beziehungen verwendet werden.	✔️	✔️	✔️	✔️
Project/ Projekte	Alle Projekte, die für eine organization (Cloud) oder Projektsammlung (lokal) definiert sind.	✔️	✔️	✔️	✔️
Prozess/ Prozesse	Backloginformationen, die zum Erweitern oder Filtern von Arbeitselementen und Arbeitselementtypen verwendet werden. Ein Beispiel, das Prozesse zum Filtern eines Berichts verwendet, finden Sie unter Beispielbericht zur Anforderungsnachverfolgung.		✔️	✔️	✔️
Etikett/ Tags	Alle Arbeitselementtags für jedes Projekt. Ein Beispiel, das Tags zum Filtern eines Berichts verwendet, finden Sie unter Release Burndown-Beispielbericht.	✔️	✔️	✔️	✔️
Team/ Teams	Alle teams, die für das Projekt definiert sind. Ein Beispiel, das Teams zum Filtern eines Berichts verwendet, finden Sie unter Hinzufügen eines Team-Slicers zu einem Power BI-Bericht.	✔️	✔️	✔️	✔️
Benutzer/ Benutzer	Benutzerinformationen, die zum Erweitern oder Filtern verschiedener Arbeitselementeigenschaften verwendet werden, z. B . Zugewiesen an, Erstellt von.	✔️	✔️	✔️	✔️
WorkItemBoardSnapshot/ WorkItemBoardSnapshot	(Zusammengesetzt) Der Zustand jedes Arbeitselements für jedes Kalenderdatum, einschließlich des Standorts des Kanban-Boards, der zum Generieren von Trendberichten verwendet wird. Einen Beispielbericht finden Sie unter Cfd-Beispielbericht (Kumulatives Flussdiagramm).	✔️	✔️	✔️	✔️
WorkItemLink/ WorkItemLinks	Die Verknüpfungen zwischen Arbeitselementen, z. B . untergeordneter, übergeordneter und verwandter Elemente. Enthält nur die neueste Revision von Links, keinen Verlauf. Hyperlinks sind nicht enthalten.	✔️	✔️	✔️	✔️
WorkItemRevision/ WorkItemRevisions	Alle historischen Überarbeitungen von Arbeitselementen, einschließlich der aktuellen Überarbeitung. Enthält keine gelöschten Arbeitselemente.	✔️	✔️	✔️	✔️
WorkItemSnapshot/ WorkItemSnapshot	(Zusammengesetzt) Der Status jedes Arbeitselements an jedem Kalenderdatum, der zur Unterstützung der Trendberichterstattung verwendet wird. Einen Beispielbericht finden Sie unter Beispielbericht zu Fehlertrends.	✔️	✔️	✔️	✔️
Workitem/ WorkItems	Der aktuelle Status der Arbeitselemente. Wird verwendet, um status Berichte zu unterstützen. Einen Beispielbericht finden Sie unter Rollup untergeordneter Arbeitselementwerte in einen übergeordneten Beispielbericht.	✔️	✔️	✔️	✔️
WorkItemTypeField/ WorkItemTypeFields	Die Arbeitselementeigenschaften für jeden Arbeitselementtyp und -prozess. Wird zur Unterstützung von Erstellungsberichten verwendet.	✔️	✔️	✔️	✔️

Pipelines-Entitätstypen und Entitätssätze

Die folgenden Entitätstypen und Entitätssätze werden mit der Analytics-Version v3.0-preview oder v4.0-preview unterstützt. Eine vollständige Referenz finden Sie unter Referenz zu Pipelinemetadaten .

EntityType/EntitySet	BESCHREIBUNG	v3.0-preview	v4.0-preview
Zweig/ Branches	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.		✔️
Pipeline/ Pipelines	Eigenschaften für eine Pipeline.	✔️	✔️
PipelineJob/ PipelineJobs	Einzelne Ausführungsergebnisse für einen bestimmten Test, der einem TestRun zugeordnet ist	✔️	✔️
PipelineRun/ PipelineRuns	Ausführungsinformationen für Pipelines. Einen Beispielbericht finden Sie unter Beispielbericht zum Trend der Pipelinedurchlaufrate.	✔️	✔️
PipelineRunActivityResult/ PipelineRunActivityResults	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.	✔️	✔️
PipelineTask/ PipelineTasks	Eigenschaften für Aufgaben, die innerhalb einer Pipeline verwendet werden.	✔️	✔️
TaskAgentPoolSizeSnapshot/ TaskAgentPoolSizeSnapshots	(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.		✔️
TaskAgentRequestSnapshot/ TaskAgentRequestSnapshots	(Zusammengesetzt)		✔️

Testen von Entitätstypen und Entitätsgruppen

Die folgenden Entitätstypen und Entitätssätze werden mit der Analytics-Version v3.0-preview oder v4.0-preview unterstützt. Eine vollständige Referenz finden Sie unter Referenz zu Testmetadaten.

EntityType/EntitySet	BESCHREIBUNG	v3.0-preview	v4.0-preview
Testconfiguration/ TestConfigurations	Testen Sie Plankonfigurationsinformationen. Ausführliche Informationen zum Konfigurieren von Tests finden Sie unter Testen verschiedener Konfigurationen.	✔️	✔️
Testresult/ TestResults	Einzelne Ausführungsergebnisse für einen bestimmten Test , der einer TestRun zugeordnet ist.	✔️	✔️
TestResultsDaily/ TestResultsDaily	Ein tägliches Momentaufnahme Aggregat von TestResult-Ausführungen, gruppiert nach Test (nicht TestRun). Einen Beispielbericht finden Sie unter Test summary trend sample report.	✔️	✔️
Testrun/ TestRuns	Ausführungsinformationen für Tests, die unter einer Pipeline mit aggregiertem TestResult ausgeführt werden.	✔️	✔️
Test/ Tests	Eigenschaften für einen Testfall, z. B. Testname und Testbesitzer. Ausführliche Informationen zum Definieren von Testfällen finden Sie unter Erstellen manueller Testfälle.	✔️	✔️
TestPoint/ TestPoints	Ausführungsinformationen für Testpunkte. Ein Testpunkt ist eine einzigartige Kombination aus Testfall, Testsammlung, Konfiguration und Tester. Einen Beispielbericht finden Sie unter Status status Beispielberichts.	✔️	✔️
TestPointHistorySnapshot/ TestPointHistorySnapshots	(Zusammengesetzt) Einzelne Ausführungsergebnisse für einen bestimmten Test , der einer TestRun zugeordnet ist. Einen Beispielbericht finden Sie unter Trendbeispielbericht zur manuellen Testausführung.	✔️	✔️
Testsuite/ TestSuites	Testsammlungsinformationen. Ausführliche Informationen zum Definieren von Testsammlungen finden Sie unter Erstellen von Testplänen und Testsammlungen.	✔️	✔️

Verwandte Artikel

• OData Analytics-Abfragerichtlinien
• WIT-Analysen
• Daten aggregieren
• Untersuchen von Analyse-OData-Metadaten
• Einschränkungen für Arbeitsnachverfolgung, Prozesse und Projekte
• Datasetdesign für Analytics-Ansichten