Udostępnij za pośrednictwem


Model danych dla analizy

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

Model danych analizy dla usługi Azure DevOps składa się z zestawów jednostek, których elementy członkowskie (jednostki) zawierają właściwości, które można filtrować, agregować i podsumowywać. Ponadto zawierają właściwości nawigacji, które odnoszą jednostki do siebie, zapewniając dostęp do innych właściwości do wybierania, filtrowania i grupowania.

Uwaga

Usługa Analytics jest automatycznie włączona i obsługiwana w środowisku produkcyjnym dla wszystkich usług Azure DevOps Services. Integracja usługi Power BI i dostęp do źródła danych OData usługi Analytics są ogólnie dostępne. Zachęcamy do korzystania z niego i przekazywania opinii. Dostępne dane są zależne od wersji. Najnowsza obsługiwana wersja to v2.0, a najnowsza wersja zapoznawcza to v4.0-preview. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji interfejsu API OData.

Uwaga

Usługa Analytics jest automatycznie instalowana i obsługiwana w środowisku produkcyjnym dla wszystkich nowych kolekcji projektów dla usługi Azure DevOps Server 2020 i nowszych wersji. Integracja usługi Power BI i dostęp do źródła danych OData usługi Analytics są ogólnie dostępne. Zachęcamy do korzystania z niego i przekazywania opinii. W przypadku uaktualnienia z usługi Azure DevOps Server 2019 możesz zainstalować usługę Analytics podczas uaktualniania.

Dostępne dane są zależne od wersji. Najnowsza obsługiwana wersja to v2.0, a najnowsza wersja zapoznawcza to v4.0-preview. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji interfejsu API OData.

Uwaga

Usługa Analytics jest dostępna w wersji zapoznawczej dla usługi Azure DevOps Server 2019. Możesz włączyć lub zainstalować dla kolekcji projektów. Integracja usługi Power BI i dostęp do źródła danych OData usługi Analytics są dostępne w wersji zapoznawczej. Zachęcamy do korzystania z niego i przekazywania opinii.

Dostępne dane są zależne od wersji. Najnowsza obsługiwana wersja to v2.0, a najnowsza wersja zapoznawcza to v4.0-preview. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji interfejsu API OData.

Przestrzenie nazw schematu

Model danych analizy jest oparty na dwóch przestrzeniach nazw schematu:

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

Zestawy jednostek i typy jednostek

Typy jednostek są nazywane typami ustrukturyzowanymi z kluczem. Definiują one nazwane właściwości i relacje każdej jednostki. Klucz elementu EntityType jest tworzony na podstawie podzestawu właściwości pierwotnych, na przykład WorkItemId, PipelineId, ReleasePipelineId i innych typów jednostki.

Zestawy jednostek są nazwane kolekcjami jednostek. Na przykład WorkItems to zestaw jednostek zawierający WorkItem jednostki. Klucz jednostki jednoznacznie identyfikuje jednostkę w zestawie jednostek. Jeśli wiele zestawów jednostek używa tego samego typu jednostki, ta sama kombinacja wartości kluczy może pojawić się w więcej niż jednym zestawie jednostek i zidentyfikować różne jednostki, jeden na zestaw jednostek, w którym pojawia się ta kombinacja. Każda z tych jednostek ma inny identyfikator jednostki. Zestawy jednostek zapewniają punkty wejścia do modelu danych.

Zestawy jednostek są opisane w metadanych OData i różnią się w zależności od projektu. Pełną listę zestawów jednostek, typów jednostek i właściwości można eksplorować, żądając metadanych OData dla projektu. Aby dowiedzieć się, jak to zrobić, zobacz Konstruowanie zapytań OData na potrzeby analizy.

Jednostki złożone

Jednostki złożone obsługują określone scenariusze. Składają się one z prostszych jednostek, często wymagają większej ilości zasobów obliczeniowych do wygenerowania i mogą zwracać większe zestawy wyników. Aby uzyskać najlepszą wydajność i uniknąć niepotrzebnego ograniczania przepustowości, upewnij się, że wykonasz zapytanie o poprawną jednostkę dla danego scenariusza.

Na przykład łączy WorkItemRevisions i Dates takie, WorkItemSnapshot że każda data ma jedną poprawkę dla każdego elementu roboczego. Ta reprezentacja obsługuje zapytania OData, które koncentrują się na danych trendu dla filtrowanego zestawu elementów roboczych. Nie należy jednak używać tej jednostki złożonej do wykonywania zapytań dotyczących bieżącego stanu elementów roboczych. Zamiast tego należy użyć WorkItems zestawu jednostek, aby wygenerować bardziej szybkie zapytanie.

Podobnie niektóre jednostki mogą zawierać wszystkie wartości historyczne, a inne mogą zawierać tylko bieżące wartości. WorkItemRevisions zawiera całą historię elementów roboczych, których nie należy używać w scenariuszach, w których bieżące wartości są interesujące.

Relacje

Aby wygenerować bardziej złożone wyniki zapytania, można połączyć jednostki przy użyciu relacji. Relacje można stosować do rozszerzania, filtrowania lub podsumowywania danych.

Niektóre właściwości nawigacji powodują utworzenie pojedynczej jednostki, a inne powodują zbieranie jednostek. Na poniższym diagramie przedstawiono wybieranie jednostek i ich właściwości nawigacji. W celu zapewnienia przejrzystości pominięto niektóre złożone jednostki i relacje.

Diagram relacji dla modelu danych analizy.

Klucze relacji

Relacje między jednostkami są również reprezentowane jako klucze obce, dzięki czemu narzędzia zewnętrzne mogą łączyć jednostki. Te właściwości mają sufiks "SK" i są typami danych typu liczba całkowita lub identyfikator GUID. Właściwości daty mają odpowiednie właściwości klucza daty całkowitej o następującym formacie: RRRRMMDD.

Typy jednostek i zestawy jednostek śledzenia pracy

Następujące typy jednostek i zestawy jednostek są obsługiwane w przypadku wskazanych wersji interfejsu API. Aby uzyskać pełną dokumentację, zobacz Dokumentacja metadanych śledzenia pracy dla usługi Azure Boards Analytics.

EntityType/EntitySet opis Wersja 1.0 Wersja 2.0 Wersja 3.0 (wersja zapoznawcza) Wersja 4.0 —wersja zapoznawcza
Obszar/
Obszary
Ścieżki obszaru elementu roboczego z właściwościami grupowania i filtrowania według hierarchii obszarów. ✔️ ✔️ ✔️ ✔️
Iteracja/
Iteracji
Ścieżki iteracji elementu roboczego z właściwościami grupowania i filtrowania według hierarchii iteracji. ✔️ ✔️ ✔️ ✔️
Lokalizacja tablicy/
Tablicelokalizacyjne
Lokalizacje komórek tablicy, zidentyfikowane przez kolumnę tablicy, pływak i podział, obejmują ustawienia tablicy historycznej. Aby uzyskać opis każdego pola tablicy, zobacz Pola przepływu pracy i tablicy. ✔️ ✔️ ✔️ ✔️
Daty kalendarza/
Daty
Daty używane do filtrowania i grupowania innych jednostek przy użyciu relacji. ✔️ ✔️ ✔️ ✔️
Projekt/
Projekty
Wszystkie projekty zdefiniowane dla organizacji (chmury) lub kolekcji projektów (lokalnie). ✔️ ✔️ ✔️ ✔️
Proces/
Procesy
Informacje dotyczące listy prac używane do rozwijania lub filtrowania elementów roboczych i typów elementów roboczych. Przykład, który używa procesów do filtrowania raportu, zobacz Przykładowy raport dotyczący śledzenia wymagań. ✔️ ✔️ ✔️
Tag/
Tagi
Wszystkie tagi elementów roboczych dla każdego projektu. Przykład użycia tagów do filtrowania raportu można znaleźć w artykule Release burndown sample report (Przykładowy raport dotyczący wydań). ✔️ ✔️ ✔️ ✔️
Zespół/
Teams
Wszystkie zespoły zdefiniowane dla projektu. Przykład, który używa usługi Teams do filtrowania raportu, zobacz Dodawanie fragmentatora zespołu do raportu usługi Power BI. ✔️ ✔️ ✔️ ✔️
Użytkownik/
Użytkownicy
Informacje o użytkowniku używane do rozwijania lub filtrowania różnych właściwości elementu roboczego, na przykład Przypisane do, Utworzone przez. ✔️ ✔️ ✔️ ✔️
WorkItemBoardSnapshot/
WorkItemBoardSnapshot
(Złożony) Stan każdego elementu roboczego w każdej dacie kalendarza, w tym lokalizacji tablicy, używany do generowania raportów trendów. Aby zapoznać się z przykładowym raportem, zobacz przykładowy raport diagramu przepływu skumulowanego (CFD). ✔️ ✔️ ✔️ ✔️
WorkItemLink/
WorkItemLinks
Łącza między elementami roboczymi, na przykład Podrzędne, Nadrzędne i Powiązane. Zawiera tylko najnowszą wersję linków, bez historii. Hiperłącza nie są uwzględniane. ✔️ ✔️ ✔️ ✔️
WorkItemRevision/
WorkItemRevisions
Wszystkie historyczne poprawki elementów roboczych, w tym bieżąca poprawka. Nie obejmuje usuniętych elementów roboczych. ✔️ ✔️ ✔️ ✔️
WorkItemSnapshot/
WorkItemSnapshot
(Złożony) Stan każdego elementu roboczego w każdej dacie kalendarza używany do obsługi raportowania trendów. Aby zapoznać się z przykładowym raportem, zobacz Przykładowy raport dotyczący trendów błędów. ✔️ ✔️ ✔️ ✔️
Element roboczy/
Elementy robocze
Bieżący stan elementów roboczych. Służy do obsługi raportów o stanie. Aby zapoznać się z przykładowym raportem, zobacz Zbiorcze wartości podrzędnych elementów roboczych do nadrzędnego przykładowego raportu. ✔️ ✔️ ✔️ ✔️
WorkItemTypeField/
WorkItemTypeFields
Właściwości elementu roboczego dla każdego typu i procesu elementu roboczego. Służy do obsługi tworzenia raportów. ✔️ ✔️ ✔️ ✔️

Typy jednostek potoków i zestawy jednostek

Następujące typy jednostek i zestawy jednostek są obsługiwane w wersji 3.0-preview lub 4.0-preview Analytics. Aby uzyskać pełną dokumentację, zobacz Dokumentacja metadanych potoku.

EntityType/EntitySet opis Wersja 3.0 (wersja zapoznawcza) Wersja 4.0 —wersja zapoznawcza
Gałąź/
Oddziałów
Podstawowe informacje o gałęziach używanych w testach lub potokach. Aby zapoznać się z przykładowym raportem, zobacz Przykładowy raport o stanie postępu. ✔️ ✔️
ParallelPipelineJobsSnapshot/
ParallelPipelineJobsSnapshot
(Złożony) Obsługuje zrozumienie użycia potoku równoległego. Aby uzyskać więcej informacji na temat równoległych testów potoku, zobacz Run tests in parallel using the Visual Studio Test task (Uruchamianie testów równoległych przy użyciu zadania testowego programu Visual Studio). ✔️
Rurociąg/
Pipelines
Właściwości potoku. ✔️ ✔️
PotokJob/
Zadania Potoku
Pojedyncze wyniki wykonywania dla określonego testu skojarzonego z testem ✔️ ✔️
PotokUruchom/
PotokiRuns
Informacje o wykonywaniu potoków. Aby zapoznać się z przykładowym raportem, zobacz Przykładowy raport trendu liczby przebiegów potoku. ✔️ ✔️
PipelineRunActivityResult/
PipelineRunActivityResults
Scalony dziennik wszystkich etapów, kroków, zadań i zadań w ramach określonego wykonania potoku. Aby zapoznać się z przykładowym raportem, zobacz Przykładowy raport czasu trwania zadania potoku. ✔️ ✔️
PipelineTask/
Zadania potoku
Właściwości zadań używanych w potoku. ✔️ ✔️
TaskAgentPoolSizeSnapshot/
TaskAgentPoolSizeSnapshots
(Złożony) Obsługuje zrozumienie rozmiaru puli, zadań potoku i współbieżności. Wykres historyczny dla pul agentów ilustruje sposób użycia tego zestawu jednostek. ✔️
TaskAgentRequestSnapshot/
TaskAgentRequestSnapshots
(Złożony) ✔️

Testowanie typów jednostek i zestawów jednostek

Następujące typy jednostek i zestawy jednostek są obsługiwane w wersji 3.0-preview lub 4.0-preview Analytics. Aby uzyskać pełną dokumentację, zobacz Dokumentacja metadanych testów.

EntityType/EntitySet opis Wersja 3.0 (wersja zapoznawcza) Wersja 4.0 —wersja zapoznawcza
Konfiguracja testowa/
Konfiguracje testowe
Informacje o konfiguracji planu testów. Aby uzyskać szczegółowe informacje na temat konfigurowania testów, zobacz Testowanie różnych konfiguracji ✔️ ✔️
TestResult/
TestResults
Pojedyncze wyniki wykonania dla określonego testu skojarzonego z testemRun. ✔️ ✔️
TestResultsDaily/
TestResultsDaily
Codzienna agregacja migawek wykonań TestResult pogrupowana według wartości Test (a nie TestRun). Aby zapoznać się z przykładowym raportem, zobacz Przykładowy raport trendu podsumowania testów. ✔️ ✔️
TestRun/
TestRuns
Informacje o wykonaniu testów uruchamianych w potoku z agregowanym testemResult. ✔️ ✔️
  Test/
Testy
Właściwości przypadku testowego, takie jak nazwa testu i właściciel testu. Aby uzyskać szczegółowe informacje na temat definiowania przypadków testowych, zobacz Tworzenie ręcznych przypadków testowych. ✔️ ✔️
TestPoint/
Punkty testowe
Informacje o wykonaniu punktów testowych. Punkt testu to unikatowa kombinacja przypadku testowego, zestawu testów, konfiguracji i testera. Aby zapoznać się z przykładowym raportem, zobacz Przykładowy raport o stanie postępu. ✔️ ✔️
TestPointHistorySnapshot/
TestPointHistorySnapshots
(Złożony) Pojedyncze wyniki wykonania dla określonego testu skojarzonego z testemRun. Aby zapoznać się z przykładowym raportem, zobacz Przykładowy raport trendu ręcznego wykonywania testów ✔️ ✔️
TestSuite/
TestSuites
Informacje o zestawach testów. Aby uzyskać szczegółowe informacje na temat definiowania zestawów testów, zobacz Tworzenie planów testów i zestawów testów. ✔️ ✔️