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 ją 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.
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. | ✔️ | ✔️ |