Udostępnij za pośrednictwem

Dokumentacja metadanych dla usługi Azure Pipelines Analytics

  • Artykuł

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

Usługa Analytics zbiera potok i działanie testowe generowane za pośrednictwem usługi Azure Pipelines. W tym artykule opisano właściwości, których można użyć do wygenerowania raportu analizy dla potoków. Używasz kombinacji właściwości do filtrowania zapytania, agregowania danych lub tworzenia raportu.

Uwaga

Podano opisy jednostek, właściwości i wyliczonych typów obsługiwanych przez model danych analizy. Jest to wczesna wersja robocza. Prześlij opinię na temat obszarów, w których chcesz uzyskać więcej informacji. Aby wykonywać zapytania dotyczące modelu danych, zobacz Konstruowanie zapytań OData dla analizy.

Zestawy jednostek i typy jednostek

Poniższa tabela zawiera podsumowanie typów jednostek i zestawów jednostek obsługujących usługę Azure Pipelines. Wszystkie typy jednostek/zestawy jednostek są dostępne w wersji zapoznawczej Usługi Analytics w wersji 4.0. Wersja zapoznawcza usługi Analytics w wersji 3.0 nie obsługuje migawek.

EntitySet Typ jednostki opis
Oddziałów Gałąź 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).
Pipelines Rurociąg Właściwości potoku.
Zadania Potoku PotokJob Pojedyncze wyniki wykonywania dla określonego testu skojarzonego z testem
PotokiRuns PotokUruchom Informacje o wykonywaniu potoków. Aby zapoznać się z przykładowym raportem, zobacz Przykładowy raport trendu liczby przebiegów potoku.
PipelineRunActivityResults PipelineRunActivityResult 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.
Zadania potoku PipelineTask Właściwości zadań używanych w potoku.
TaskAgentPoolSizeSnapshots TaskAgentPoolSizeSnapshot (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.
TaskAgentRequestSnapshots TaskAgentRequestSnapshot (Złożony) Obsługuje raportowanie żądań agenta zadań.

Odgałęzienia

Następujące właściwości są prawidłowe dla zestawu jednostek Gałęzie . Klucze zastępcze skojarzone z gałęzią include BranchSK i ProjectSK.

Nazwa wyświetlana Nazwa/nazwisko Typ danych Opis
AnalyticsUpdatedDate DateTime Znak wodny wskazujący czas ostatniej aktualizacji danych analizy.
Nazwa gałęzi BranchName String Nazwa przypisana do gałęzi po jej utworzeniu.
Identyfikator repozytorium RepositoryId String Numer przypisany do repozytorium po jego utworzeniu.
Identyfikator vsts repozytorium RepositoryVstsId String Numer przypisany do repozytorium TFVC podczas jego tworzenia.
RepositoryUrl RepositoryUrl String Adres URL zdefiniowany dla repozytorium podczas jego tworzenia.

Właściwości nawigacji obejmują Project i jego ograniczenie ProjectSKodwołań.

ParallelPipelineJobsSnapshot

Następujące właściwości są prawidłowe dla zestawu jednostek ParallelPipelineJobsSnapshot . Klucze referencyjne obejmują:

  • IsHosted
  • ParallelismTag
  • SamplingDate
Nazwa wyświetlana Nazwa/nazwisko Typ danych Opis
Hostowane lub samodzielnie hostowane IsHosted Wartość logiczna Wskazuje, czy potok równoległy jest uruchamiany w agencie hostowanym przez firmę Microsoft (True) lub jest hostowany samodzielnie (Fałsz). Aby uzyskać więcej informacji, zobacz Agenty usługi Azure Pipelines.
Nie można nawiązać połączenia ze wszystkimi dostawcami FailedToReachAllProviders Wartość logiczna Wskazuje, czy przebieg zadania osiągnął wszystkich dostawców (Prawda) lub nie (Fałsz).
Liczba zadań potoków równoległych TotalCount Int32 Liczba zadań uruchamianych w ramach migawki.
Liczba równoległych potoków w minutach TotalMinutes Int32 Liczba minut potrzebnych do uruchomienia migawki.
Typ równoległości ParallelismTag String Tag wskazujący typ równoległości skojarzony z migawką zadania.
Typ premium IsPremium Wartość logiczna Wskazuje, czy potok równoległy ma wartość Premium (Prawda) lub nie (Fałsz).
Data próbki SamplingDate DateTime Data skojarzona z migawką.

Pipelines

Następujące właściwości są prawidłowe dla potoków i jego klucza PipelineSKzastępczego .

Nazwa wyświetlana Nazwa/nazwisko Typ danych Opis
Identyfikator potoku PipelineId Int32 Identyfikator przypisany do potoku.
Nazwa potoku PipelineName String Nazwa przypisana do potoku.
Wersja potoku PipelineVersion Int32 Wersja skojarzona z potokiem.
Typ procesu potoku PipelineProcessType Enumerated Typ definicji potoku. Prawidłowe wartości są wymienione poniżej dla parametru PipelineProcessType.

Właściwości nawigacji obejmują Project i jego ograniczenie ProjectSKodwołań.

PipelineProcessType, wyliczone składowe typu

Następujące elementy członkowskie są zdefiniowane dla wyliczonego PipelineProcessType typu, który wskazuje metodę używaną do definiowania potoku.

Nazwa elementu członkowskiego Wartość Definicja
Designer 1 Definicja potoku klasycznego.
Yaml 2 Definicja potoku YAML.
Docker 3 Definicja potoku platformy Docker.

Zadania Potoku

Zadanie potoku to seria kroków, które są uruchamiane sekwencyjnie jako jednostka. Zadanie to najmniejsza jednostka pracy, którą można zaplanować do uruchomienia. Potoki są zorganizowane wokół zadań, a każdy potok ma co najmniej jedno zadanie. Aby uzyskać więcej informacji, zobacz Określanie zadań w potoku.

Następujące właściwości są prawidłowe dla zadań PipelineJobs i jego PipelineJobSK klucza zastępczego.

Nazwa wyświetlana Nazwa/nazwisko Typ danych Opis
Pełna nazwa zadania potoku FullJobName String Pełna nazwa zadania potoku.
Identyfikator potoku PipelineId Int32 Identyfikator przypisany do potoku, w którym zdefiniowano zadanie.
Identyfikator zadania potoku JobId String Identyfikator zadania przypisany do zadania potoku po jego utworzeniu.
Nazwa zadania potoku JobName String Nazwa przypisana do zadania potoku.
Nazwa etapu potoku StageName String Nazwa etapu skojarzona z zadaniem potoku.
Atrybuty strategii zadania potoku StrategyAttributes String Atrybuty zdefiniowane dla zadania potoku.
Identyfikator etapu StageId String Identyfikator etapu skojarzony z zadaniem potoku.

Właściwości nawigacji obejmują Project i jego ograniczenie ProjectSKodwołań.

Przykładowy raport, który wykonuje zapytania dotyczące typu jednostki PipelineJob , zobacz Przykładowy raport dotyczący niepowodzeń etapu potoku.

PipelineRuns

Uruchomienie potoku reprezentuje pojedyncze wykonanie potoku. Podczas uruchamiania potok jest przetwarzany, a agenci przetwarzają co najmniej jedno zadania. Uruchomienie potoku obejmuje zadania, kroki i zadania. Aby uzyskać więcej informacji, zobacz Sekwencja uruchamiania potoku.

Następujące właściwości są prawidłowe dla typu jednostki PipelineRun i jego PipelineRunSK klucza zastępczego.

Nazwa wyświetlana Nazwa/nazwisko Typ danych Opis
Liczba anulowanych CanceledCount Int32 Liczba anulowanych przebiegów potoków.
Data zakończenia CompletedDate DateTime Data i godzina zakończenia wykonywania potoku.
Liczba nieudanych prób FailedCount Int32 Liczba przebiegów potoku, które zakończyły się pomyślnie.
Poprawka liczbowa RunNumberRevision Int32 Liczba przypisana do przebiegu potoku z sekwencyjnymi wykonaniami.
Liczba częściowo zakończonych powodzeniem PartiallySucceededCount Int32 Liczba przebiegów potoków, które częściowo zakończyły się pomyślnie.
Identyfikator przebiegu potoku PipelineRunId Int32 Liczba przypisana do przebiegu potoku.
Data w kolejce QueuedDate DateTime Data i godzina uruchomienia potoku.
Czas trwania kolejki w sekundach QueueDurationSeconds Dziesiętne Liczba sekund, przez które potok pozostał w kolejce.
Numer przebiegu RunNumber String Liczba przypisana do przebiegu potoku po jego wykonaniu.
Wynik przebiegu RunOutcome Enumerated Wynik przypisany do potoku po zakończeniu jego wykonywania. Prawidłowe wartości są wymienione poniżej dla elementu PipelineRunOutcome.
Przyczyna uruchomienia RunReason Enumerated Warunek, który spowodował uruchomienie potoku. Prawidłowe wartości są wymienione poniżej dla parametru PipelineRunReason.
Czas trwania przebiegu w sekundach RunDurationSeconds Dziesiętne Liczba sekund potrzebnych do ukończenia przebiegu potoku.
Data rozpoczęcia StartedDate DateTime Data i godzina rozpoczęcia uruchomienia potoku.
Liczba powodzenia SucceededCount Int32 Liczba przebiegów potoku, które zakończyły się pomyślnie.
Łączny czas trwania sekund TotalDurationSeconds Dziesiętne Całkowita liczba sekund potoku znajdowała się w kolejce i uruchomieniu.

Obsługiwane są następujące właściwości nawigacji.

Display name Nazwisko -Ograniczenie odwołań Przywoływna właściwość
Gałąź Branch BranchSK BranchSK
Ukończono CompletedOn CompletedDateSK DateSK
W kolejce QueuedOn QueuedDateSK DateSK
Rozpoczęto StartedOn QueuedDateSK DateSK
Rurociąg Pipeline PipelineSK PipelineSK
Projekt Project ProjectSK ProjectSK

PipelineRunReason, wyliczone elementy członkowskie typu

Następujące elementy członkowskie są zdefiniowane dla PipelineRunReason typu wyliczanego, który wskazuje warunki, w których każdy etap potoku, zadanie lub krok jest uruchamiany zgodnie z opisem w temacie Określanie warunków.

Nazwa elementu członkowskiego Wartość Display name
None 0 Brak
Manual 1 Ręcznie
IndividualCI 2 Pojedyncza ciągła integracja
BatchedCI 100 Wsadowa ciągła integracja
Schedule 8 Zaplanuj
UserCreated 32 Utworzony użytkownik
ValidateShelveset 64 Weryfikowanie zestawu półek
CheckInShelveset 128 zestaw półek Synchronizacja
PullRequest 256 Żądanie ściągnięcia
PipelineRunCompletion 512 Uzupełnianie kompilacji

PipelineRunOutcome, wyliczone elementy członkowskie typu

Następujące elementy członkowskie są zdefiniowane dla wyliczonego PipelineRunOutcome typu, który wskazuje wynik uruchomienia potoku.

Nazwa elementu członkowskiego Wartość Display name
None 0 Brak
Succeed 2 Powodzenie
PartiallySucceeded 100 Częściowo powiodło się
Failed 6 Niepowodzenie
Canceled 32 Anulowany

PipelineRunActivityResults

Następujące właściwości są prawidłowe dla zestawu jednostek PipelineRunActivityResults i jego PipelineRunActivityResultSK klucza zastępczego.

Wiele właściwości jest opartych na datach lub użytkownikach. Te właściwości są skojarzone z zestawami jednostek CalendarDate i User opisanymi w temacie Data kalendarza, Projekt i Dokumentacja metadanych użytkownika.

Nazwa wyświetlana Nazwa/nazwisko Typ danych Opis
Porzucona liczba AbandonedCount Int32 Liczba przebiegów potoków oznaczonych jako porzucone.
Data ukończenia działania ActivityCompletedDate DateTime Data i godzina zakończenia wykonywania potoku.
Czas trwania działania w sekundach ActivityDurationSeconds Dziesiętne Całkowita liczba sekund potoku znajdowała się w kolejce i uruchomieniu.
Data rozpoczęcia działania ActivityStartedDate DateTime Data/godzina rozpoczęcia uruchomienia potoku.
Liczba anulowanych CanceledCount Int32 Liczba anulowanych przebiegów potoków.
Liczba nieudanych prób FailedCount Int32 Liczba przebiegów potoku, które zakończyły się niepowodzeniem.
Typ działania potoku ActivityType Enumerated Typ działania potoku. Prawidłowe wartości są wymienione poniżej dla parametru PipelineActivityType.
Identyfikator przebiegu potoku PipelineRunId Int32 Liczba przypisana do przebiegu potoku po jego wykonaniu.
Wynik przebiegu potoku PipelineRunOutcome Enumerated Wynik przypisany do potoku po zakończeniu jego wykonywania. Prawidłowe wartości są wyświetlane w obszarze PipelineRunOutcome.
Względny czas rozpoczęcia od sekund zadania RelativeStartTimeFromJobSeconds Int32 Liczba sekund, które upłynęły od początku zadania.
Względny czas rozpoczęcia od etapu sekund RelativeStartTimeFromStageSeconds Int32 Liczba sekund, które upłynęły od początku etapu.
Względny czas rozpoczęcia od sekund wykonywania RelativeStartTimeFromRunSeconds Int32 Liczba sekund, które upłynęły od momentu wykonania przebiegu.
Pominięto liczbę SkippedCount Int32 Liczba pominiętych przebiegów potoków.
Liczba powodzenia SucceededCount Int32 Liczba przebiegów potoku, które zakończyły się pomyślnie.
Liczba problemów zakończonych powodzeniem SucceededWithIssuesCount Int32 Liczba przebiegów potoków, które częściowo zakończyły się pomyślnie.
Nazwa wyświetlana zadania TaskDisplayName String Nazwa zadania wykonanego w przebiegu potoku.
Ścieżka dziennika zadań TaskLogPath String Ścieżka pliku dziennika wygenerowanego przez zadanie.
Wynik zadania TaskOutcome Niestandardowy Wynik wykonanego zadania.

Przykładowe raporty, które wysyłają zapytania dotyczące typu jednostki PipelineRunActivityResult , zobacz Przykładowy raport trendu czasu trwania zadania potoku.

Właściwości nawigacji obejmują te wymienione w poniższej tabeli.

Wyświetlana nazwa Nazwa/nazwisko Ograniczenie odwołań Przywoływna właściwość
Rozpoczęto działanie ActivityStartedOn ActivityStartedDateSK DateSK
Gałąź Branch BranchSK BranchSK
Rurociąg Pipeline PipelineSK PipelineSK
Zadanie potoku PipelineTask PipelineTaskSK PipelineTaskSK
Zadanie potoku PipelineJob PipelineJobSK PipelineJobSK
Uruchamianie potoku w kolejce PipelineRunQueuedOn PipelineRunQueuedDateSK DateSK
Rozpoczęto uruchamianie potoku PipelineRunStartedOn PipelineRunStartedDateSK DateSK
Ukończono uruchamianie potoku PipelineRunCompletedOn PipelineRunCompletedDateSK DateSK
Rozpoczęto uruchamianie potoku PipelineRunStartedOn PipelineRunStartedDateSK DateSK
Projekt Project ProjectSK ProjectSK

Wyliczone składowe typu PipelineActivityType

Następujące elementy członkowskie są zdefiniowane dla wyliczonego PipelineActivityType typu.

Nazwa elementu członkowskiego Wartość Display name
Task 0 Zadanie
Approval 1 Approval
AgentWait 2 Oczekiwanie agenta

Zadania potoku

Następujące właściwości są prawidłowe dla zestawu jednostek PipelineTasks i jego klucza PipelineTaskSKzastępczego .

Nazwa wyświetlana Nazwa/nazwisko Typ danych Opis
Identyfikator definicji zadania TaskDefinitionId Identyfikator GUID Identyfikator GUID przypisany do zadania potoku.
Wersja definicji zadania TaskDefinitionVersion String Wersja przypisana do zadania potoku.

Właściwości nawigacji obejmują Project i jego ograniczenie ProjectSKodwołań.

TaskAgentPoolSizeSnapshots

Następujące właściwości są prawidłowe dla zestawu jednostek TaskAgentPoolSizeSnapshots i jego klucza SamplingDatezastępczego .

Nazwa wyświetlana Nazwa właściwości Typ danych Opis
Liczba online OnlineCount Int32 Liczba agentów w trybie online w puli agentów podczas uruchamiania zadania.
Liczba offline OfflineCount Int32 Liczba agentów w trybie offline w puli agentów podczas uruchamiania zadania.
Identyfikator puli PoolId Int32 Numer przypisany do puli agentów.
Data próbki SamplingDate DateTime Data i godzina przy przyciąganiu rozmiaru puli.

Aby zapoznać się z przykładowym raportem utworzonym w jednostce TaskAgentPoolSizeSnapshot, zobacz Historyczny graf dla pul agentów (wersja zapoznawcza).

TaskAgentRequestSnapshots

Pule agentów są przydzielane podczas wykonywania zadania. Zestaw jednostek TaskAgentRequestSnapshots przechwytuje dane związane z żądaniami agenta zadań.

Następujące właściwości są prawidłowe dla typu jednostki TaskAgentRequestSnapshot i jego kluczy zastępczych SamplingTime i SamplingDateSK.

Nazwa wyświetlana Nazwa/nazwisko Typ danych Opis
Kompilacja w kolejce IsQueued Wartość logiczna Wskazuje, czy kompilacja jest w kolejce (prawda) lub nie jest w kolejce (Fałsz).
Kompilacja uruchomiona IsRunning Wartość logiczna Wskazuje, czy kompilacja jest uruchomiona (Prawda) lub nie jest uruchomiona (Fałsz).
Hostowane lub samodzielnie hostowane IsHosted Wartość logiczna Wskazuje, czy agent przypisany do zadania jest hostowany (Prawda) lub self-hosted (Fałsz).
Data zakończenia zadania FinishedDate DateTime Data/godzina zakończenia żądania agenta zadania.
FinishedDateSK Int32 Data zakończenia działania żądania agenta zadania, wyrażona w YYYYMMDD strefie czasowej zdefiniowanej dla organizacji.
Data w kolejce QueuedDate DateTime Data i godzina kolejki żądania agenta zadania.
QueuedDateSK Int32 Data kolejkowania żądania agenta zadań wyrażona w YYYYMMDD strefie czasowej zdefiniowanej dla organizacji.
Czas trwania kolejki w sekundach QueueDurationSeconds Dziesiętne Liczba sekund, przez które żądanie agenta zadań pozostawało w kolejce przed przypisaniem agenta.
Identyfikator puli PoolId Int32 Numer przypisany do puli agentów przypisany do żądania agenta zadania.
Typ potoku PipelineType String Typ potoku zawierający żądanie agenta zadania.
Identyfikator żądania RequestId Int64 Numer przypisany do żądania agenta zadania.
Przykładowa godzina SamplingHour Int32 Liczba przypisana do godziny odebrania żądania.
Czas próbki SamplingTime DateTime Data i godzina odebrania żądania agenta zadania.
Data rozpoczęcia StartedDate DateTime Data i godzina wykonania żądania agenta zadania.
StartedDateSK Int32 Data rozpoczęcia wykonywania żądania agenta zadań wyrażona w YYYYMMDD strefie czasowej zdefiniowanej dla organizacji.

Właściwości nawigacji obejmują te wymienione w poniższej tabeli.

Display name Nazwisko Ograniczenie odwołań -Referenced, właściwość
Gałąź Branch BranchSK BranchSK
Ukończono CompletedOn CompletedDateSK DateSK
Godzina zakończenia zadania FinishedOn FinishedDateSK DateSK
W kolejce QueuedOn QueuedDateSK DateSK
Rurociąg Pipeline PipelineSK PipelineSK
Projekt Project ProjectSK ProjectSK
Rozpoczęto StartedOn QueuedDateSK DateSK