Sdílet prostřednictvím

Referenční informace k metadatům pro Azure Pipelines Analytics

  • Článek

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

Služba Analytics shromažďuje kanál a testovací aktivitu vygenerovanou prostřednictvím Azure Pipelines. Tento článek popisuje vlastnosti, které můžete použít k vygenerování sestavy Analýzy pro kanály. Pomocí kombinace vlastností můžete filtrovat dotaz, agregovat data nebo vytvořit sestavu.

Poznámka:

Jsou k dispozici popisy entit, vlastností a výčtů podporovaných datovým modelem Analýza. Jedná se o dřívější koncept. Pošlete nám prosím zpětnou vazbu k oblastem, které chcete získat další informace. Dotazování datového modelu najdete v tématu Vytváření dotazů OData pro analýzu.

Sady entit a typy entit

Následující tabulka shrnuje typy entit a sady entit, které podporují Azure Pipelines. Všechny typy entit nebo sady entit jsou k dispozici ve verzi Preview analytics verze 4.0. Verze Analytics verze 3.0-Preview nepodporuje snímky.

Sada entit EntityType Popis
Větve Větev Základní informace o větvích používaných v testech nebo kanálech Ukázkovou sestavu najdete v ukázkové sestavě stavu průběhu.
ParallelPipelineJobsSnapshot ParallelPipelineJobsSnapshot (složené) Podporuje pochopení spotřeby paralelních kanálů. Další informace o paralelních testech kanálu naleznete v tématu Paralelní spouštění testů pomocí úlohy Visual Studio Test.
Pipelines Potrubí Vlastnosti kanálu
PipelineJobs PipelineJob Výsledky jednotlivých spuštění pro konkrétní test přidružený k testovacímu spuštění
PipelineRuns PipelineRun Informace o spuštění pro kanály Ukázkovou sestavu najdete v části Ukázková sestava trendu rychlosti kanálu.
PipelineRunActivityResults PipelineRunActivityResult Sloučený protokol všech fází, kroků, úloh a úkolů v rámci konkrétního spuštění kanálu. Ukázkovou sestavu najdete v ukázkové sestavě doby trvání úlohy kanálu.
PipelineTasks PipelineTask Vlastnosti pro úlohy, které se používají v rámci kanálu
TaskAgentPoolSizeSnapshots TaskAgentPoolSizeSnapshot (složené) Podporuje pochopení velikosti fondu, úloh kanálu a souběžnosti. Historický graf fondů agentů znázorňuje způsob použití této sady entit.
TaskAgentRequestSnapshots TaskAgentRequestSnapshot (složené) Podporuje vytváření sestav požadavků agenta úloh.

Větve

Následující vlastnosti jsou platné pro sadu entit Větve . Náhradní klíče přidružené k větvi include BranchSK a ProjectSK.

Zobrazované jméno Název Datový typ Popis
AnalyticsUpdatedDate DateTime Vodoznak, který označuje čas poslední aktualizace analytických dat.
Název větve BranchName String Název přiřazený k větvi při jeho vytvoření.
ID úložiště RepositoryId String Číslo přiřazené k úložišti při jeho vytvoření.
ID úložiště Vsts RepositoryVstsId String Číslo přiřazené k úložišti TFVC při jeho vytvoření.
RepositoryUrl RepositoryUrl String Adresa URL definovaná pro úložiště při jeho vytvoření.

Navigační vlastnosti zahrnují Project a jeho referenční omezení ProjectSK.

ParallelPipelineJobsSnapshot

Následující vlastnosti jsou platné pro sadu entit ParallelPipelineJobsSnapshot . Mezi referenční klíče patří:

  • IsHosted
  • ParallelismTag
  • SamplingDate
Zobrazované jméno Název Datový typ Popis
Hostované nebo v místním prostředí IsHosted Logická hodnota Označuje, jestli je paralelní kanál spuštěný v agentu hostovaného Microsoftem (True) nebo je hostovaný jako místní (nepravda). Další informace najdete v tématu Agenti Azure Pipelines.
Nepodařilo se spojit se se všemi poskytovateli FailedToReachAllProviders Logická hodnota Označuje, jestli spuštění úlohy dosáhlo všech zprostředkovatelů (True) nebo ne (Nepravda).
Počet paralelních úloh kanálů TotalCount Int32 Počet spuštěných úloh jako součást snímku.
Počet minut paralelních kanálů TotalMinutes Int32 Počet minut potřebných ke spuštění snímku.
Typ paralelismu ParallelismTag String Značka, která označuje typ paralelismu přidruženého k snímku úlohy.
Typ Premium IsPremium Logická hodnota Označuje, jestli je paralelní kanál premium (True) nebo ne (Nepravda).
Ukázkové datum SamplingDate DateTime Datum přidružené k snímku.

Pipelines

Následující vlastnosti jsou platné pro Pipelines a jeho náhradní klíč PipelineSK.

Zobrazované jméno Název Datový typ Popis
ID kanálu PipelineId Int32 ID přiřazené kanálu.
Název kanálu PipelineName String Název přiřazený kanálu.
Verze kanálu PipelineVersion Int32 Verze přidružená ke kanálu.
Typ procesu kanálu PipelineProcessType Enumerated Typ definice kanálu. Platné hodnoty jsou uvedeny níže pro PipelineProcessType.

Navigační vlastnosti zahrnují Project a jeho referenční omezení ProjectSK.

Výčet členů typu PipelineProcessType

Následující členy jsou definovány pro PipelineProcessType výčtový typ, který označuje metodu použitou k definování kanálu.

Název členu Hodnota Definice
Designer 0 Klasická definice kanálu.
Yaml 2 Definice kanálu YAML
Docker 3 Definice kanálu Dockeru

PipelineJobs

Úloha kanálu je řada kroků, které se spouštějí postupně jako jednotka. Úloha je nejmenší jednotka práce, kterou můžete naplánovat ke spuštění. Kanály jsou uspořádány kolem úloh a každý kanál má aspoň jednu úlohu. Další informace viz Zadání úloh v kanálu.

Následující vlastnosti jsou platné pro PipelineJobs a jeho PipelineJobSK náhradní klíč.

Zobrazované jméno Název Datový typ Popis
Úplný název úlohy kanálu FullJobName String Úplný název úlohy kanálu.
ID kanálu PipelineId Int32 ID přiřazené kanálu, ve kterém je úloha definována.
Identifikátor úlohy kanálu JobId String Identifikátor úlohy přiřazený k úloze kanálu při jeho vytvoření.
Název úlohy kanálu JobName String Název přiřazený úloze kanálu.
Název fáze kanálu StageName String Název fáze přidružený k úloze kanálu.
Atributy strategie úlohy kanálu StrategyAttributes String Atributy definované pro úlohu kanálu.
Identifikátor fáze StageId String Identifikátor fáze přidružený k úloze kanálu.

Navigační vlastnosti zahrnují Project a jeho referenční omezení ProjectSK.

Ukázkovou sestavu, která se dotazuje na typ entity PipelineJob , najdete v ukázkové sestavě selhání fáze kanálu.

Spuštění kanálu

Spuštění kanálu představuje jedno spuštění kanálu. Během spuštění se kanál zpracuje a agenti zpracovávají jednu nebo více úloh. Spuštění kanálu zahrnuje úlohy, kroky a úlohy. Další informace najdete v tématu Posloupnost spuštění kanálu.

Následující vlastnosti jsou platné pro typ entity PipelineRun a jeho PipelineRunSK náhradní klíč.

Zobrazované jméno Název Datový typ Popis
Počet zrušených CanceledCount Int32 Počet zrušených spuštění kanálu.
Datum dokončení CompletedDate DateTime Datum a čas dokončení spuštění kanálu.
Počet neúspěšných chyb FailedCount Int32 Počet spuštění kanálu, která byla úspěšná.
Revize čísla RunNumberRevision Int32 Číslo přiřazené ke spuštění kanálu se sekvenčními spuštěními.
Částečně úspěšný počet PartiallySucceededCount Int32 Počet spuštění kanálu, která částečně proběhla úspěšně.
ID spuštění kanálu PipelineRunId Int32 Číslo přiřazené ke spuštění kanálu.
Datum ve frontě QueuedDate DateTime Datum a čas, kdy byl kanál zařazen do fronty ke spuštění.
Doba trvání fronty v sekundách QueueDurationSeconds Desetinné číslo Počet sekund, po které kanál zůstal ve frontě
Číslo spuštění RunNumber String Číslo přiřazené ke spuštění kanálu při jeho spuštění.
Výsledek spuštění RunOutcome Enumerated Výsledek přiřazený kanálu po dokončení jeho provádění. Platné hodnoty jsou uvedené níže pro PipelineRunOutcome.
Důvod spuštění RunReason Enumerated Podmínka, která způsobila spuštění kanálu. Platné hodnoty jsou uvedené níže pro PipelineRunReason.
Doba trvání spuštění v sekundách RunDurationSeconds Desetinné číslo Počet sekund, po které trvalo dokončení spuštění kanálu.
Datum zahájení StartedDate DateTime Datum a čas zahájení spuštění kanálu.
Počet úspěšných SucceededCount Int32 Počet spuštění kanálu, která byla úspěšná.
Total Duration Seconds TotalDurationSeconds Desetinné číslo Celkový počet sekund, po které byl kanál ve frontě a spuštěný.

Podporují se následující navigační vlastnosti.

Zobrazované jméno Jméno -Referenční omezení Odkazovaná vlastnost
Větev Branch BranchSK BranchSK
Dokončeno dne CompletedOn CompletedDateSK DateSK
Zapnuto ve frontě QueuedOn QueuedDateSK DateSK
Spuštěno dne StartedOn QueuedDateSK DateSK
Potrubí Pipeline PipelineSK PipelineSK
Projekt Project ProjectSK ProjectSK

PipelineRunReason – výčet členů typu

Následující členy jsou definovány pro PipelineRunReason výčtový typ, který označuje podmínky, za kterých se jednotlivé fáze kanálu, úloha nebo krok spouští, jak je popsáno v části Zadání podmínek.

Název členu Hodnota Zobrazované jméno
None 0 Nic
Manual 0 Ruční
IndividualCI 2 Individuální CI
BatchedCI 4 Dávkové CI
Schedule 8 Plán
UserCreated 32 Uživatel vytvořen
ValidateShelveset 64 Ověření sady odložených odložených
CheckInShelveset 128 Vrátit se změnami sadu odložených odložených
PullRequest 256 Žádost o přijetí změn
PipelineRunCompletion 512 Dokončení sestavení

Členové výčtu typu PipelineRunOutcome

Následující členy jsou definovány pro PipelineRunOutcome výčtový typ, který označuje výsledek spuštění kanálu.

Název členu Hodnota Zobrazované jméno
None 0 Nic
Succeed 2 Úspěch
PartiallySucceeded 4 Částečně úspěšné
Failed 6 Neúspěšný
Canceled 32 Zrušeno

PipelineRunActivityResults

Následující vlastnosti jsou platné pro sadu entity PipelineRunActivityResults a jeho PipelineRunActivityResultSK náhradní klíč.

Mnoho vlastností je založených na datech nebo uživatelích. Tyto vlastnosti jsou přidružené k sadám entit CalendarDate a User , které jsou popsány v odkazu na metadata kalendáře, projektu a uživatele.

Zobrazované jméno Název Datový typ Popis
Počet opuštěných AbandonedCount Int32 Počet spuštění kanálu, která byla označena jako opuštěná.
Datum dokončení aktivity ActivityCompletedDate DateTime Datum a čas dokončení spuštění kanálu.
Doba trvání aktivity v sekundách ActivityDurationSeconds Desetinné číslo Celkový počet sekund, po které byl kanál ve frontě a spuštěný.
Datum zahájení aktivity ActivityStartedDate DateTime Datum a čas spuštění kanálu.
Počet zrušených CanceledCount Int32 Počet zrušených spuštění kanálu.
Počet neúspěšných chyb FailedCount Int32 Počet spuštění kanálu, která selhala.
Typ aktivity kanálu ActivityType Enumerated Typ aktivity kanálu. Platné hodnoty jsou uvedeny níže pro PipelineActivityType.
ID spuštění kanálu PipelineRunId Int32 Číslo přiřazené ke spuštění kanálu při jeho spuštění.
Výsledek spuštění kanálu PipelineRunOutcome Enumerated Výsledek přiřazený kanálu po dokončení jeho provádění. Platné hodnoty jsou uvedeny v části PipelineRunOutcome.
Relativní čas zahájení z sekund úlohy RelativeStartTimeFromJobSeconds Int32 Počet sekund, které uplynuly od začátku úlohy.
Relativní počáteční čas z sekund fáze RelativeStartTimeFromStageSeconds Int32 Počet sekund, které uplynuly od začátku fáze.
Relativní počáteční čas od spuštění sekund RelativeStartTimeFromRunSeconds Int32 Počet sekund, které uplynuly od spuštění.
Vynechaný počet SkippedCount Int32 Počet přeskočených spuštění kanálu.
Počet úspěšných SucceededCount Int32 Počet spuštění kanálu, která byla úspěšná.
Úspěch s počtem problémů SucceededWithIssuesCount Int32 Počet spuštění kanálu, která částečně proběhla úspěšně.
Zobrazovaný název úkolu TaskDisplayName String Název úlohy spuštěné v spuštění kanálu
Cesta k protokolu úloh TaskLogPath String Cesta k souboru protokolu vygenerovaném úlohou.
Výsledek úkolu TaskOutcome Vlastní Výsledek úkolu, který byl proveden.

Ukázkové sestavy, které se dotazuje na typ entity PipelineRunActivityResult , naleznete v ukázkové sestavě trendu trvání úlohy kanálu.

Mezi vlastnosti navigace patří ty, které jsou uvedené v následující tabulce.

Zobrazovaný název Název Referenční omezení Odkazovaná vlastnost
Aktivita byla spuštěna dne ActivityStartedOn ActivityStartedDateSK DateSK
Větev Branch BranchSK BranchSK
Potrubí Pipeline PipelineSK PipelineSK
Úloha kanálu PipelineTask PipelineTaskSK PipelineTaskSK
Úloha kanálu PipelineJob PipelineJobSK PipelineJobSK
Spuštění kanálu zařazené do fronty PipelineRunQueuedOn PipelineRunQueuedDateSK DateSK
Spuštěné spuštění kanálu PipelineRunStartedOn PipelineRunStartedDateSK DateSK
Spuštění kanálu bylo dokončeno dne PipelineRunCompletedOn PipelineRunCompletedDateSK DateSK
Spuštěné spuštění kanálu PipelineRunStartedOn PipelineRunStartedDateSK DateSK
Projekt Project ProjectSK ProjectSK

Výčet členů typu PipelineActivityType

Následující členy jsou definovány pro výčtový PipelineActivityType typ.

Název členu Hodnota Zobrazované jméno
Task 0 Úloha
Approval 0 Schválení
AgentWait 2 Čekání agenta

PipelineTasks

Následující vlastnosti jsou platné pro sadu entity PipelineTasks a jeho náhradní klíč PipelineTaskSK.

Zobrazované jméno Název Datový typ Popis
ID definice úlohy TaskDefinitionId Identifikátor GUID Identifikátor GUID přiřazený k úloze kanálu.
Verze definice úlohy TaskDefinitionVersion String Verze přiřazená k úloze kanálu.

Navigační vlastnosti zahrnují Project a jeho referenční omezení ProjectSK.

TaskAgentPoolSizeSnapshots

Následující vlastnosti jsou platné pro TaskAgentPoolSizeSnapshots sada entit a jeho náhradní klíč SamplingDate.

Zobrazované jméno Název vlastnosti Datový typ Popis
Online Count OnlineCount Int32 Počet agentů online ve fondu agentů při spuštění úlohy.
Počet offline OfflineCount Int32 Počet agentů offline ve fondu agentů při spuštění úlohy.
ID fondu PoolId Int32 Číslo přiřazené k fondu agentů.
Ukázkové datum SamplingDate DateTime Datum a čas, kdy byla velikost fondu přichycená.

Ukázkovou sestavu sestavenou z entity TaskAgentPoolSizeSnapshot najdete v historickém grafu fondů agentů (Preview).

TaskAgentRequestSnapshots

Fondy agentů se při provádění úlohy přidělují. Sada entit TaskAgentRequestSnapshots zaznamenává data související s požadavky agenta úloh.

Následující vlastnosti jsou platné pro TaskAgentRequestSnapshot typu entity a jeho náhradní klíče SamplingTime a SamplingDateSK.

Zobrazované jméno Název Datový typ Popis
Sestavení zařazené do fronty IsQueued Logická hodnota Označuje, jestli je sestavení zařazeno do fronty (True) nebo není ve frontě (Nepravda).
Sestavení spuštěné IsRunning Logická hodnota Označuje, jestli je sestavení spuštěné (True) nebo nespouštět (False).
Hostované nebo v místním prostředí IsHosted Logická hodnota Označuje, jestli je agent přiřazený k úloze hostovaný (True) nebo v místním prostředí (False).
Datum ukončení úlohy FinishedDate DateTime Datum a čas dokončení požadavku agenta úlohy.
FinishedDateSK Int32 Datum, kdy se žádost agenta úkolu dokončila, je vyjádřená v YYYYMMDD časovém pásmu definovaném pro organizaci.
Datum ve frontě QueuedDate DateTime Datum a čas, kdy byl požadavek agenta úkolu zařazen do fronty.
QueuedDateSK Int32 Datum, kdy byl požadavek agenta úkolu zařazen do fronty, vyjádřený v YYYYMMDD časovém pásmu definovaném pro organizaci.
Doba trvání fronty v sekundách QueueDurationSeconds Desetinné číslo Počet sekund, po které požadavek agenta úkolu zůstal ve frontě před přiřazením agenta.
ID fondu PoolId Int32 Číslo přiřazené fondu agentů přiřazené k požadavku agenta úkolu.
Typ kanálu PipelineType String Typ kanálu obsahující požadavek agenta úloh.
ID požadavku RequestId Int64 Číslo přiřazené k požadavku agenta úlohy.
Ukázková hodina SamplingHour Int32 Číslo přiřazené hodině, kdy byla žádost přijata.
Ukázkový čas SamplingTime DateTime Datum a čas přijetí požadavku agenta úlohy.
Datum zahájení StartedDate DateTime Datum a čas spuštění požadavku agenta úlohy.
StartedDateSK Int32 Datum spuštění žádosti agenta úkolu vyjádřené YYYYMMDD v časovém pásmu definovaném pro organizaci.

Mezi vlastnosti navigace patří ty, které jsou uvedené v následující tabulce.

Zobrazované jméno Jméno Referenční omezení -Odkazovaná vlastnost
Větev Branch BranchSK BranchSK
Dokončeno dne CompletedOn CompletedDateSK DateSK
Čas ukončení úlohy FinishedOn FinishedDateSK DateSK
Zapnuto ve frontě QueuedOn QueuedDateSK DateSK
Potrubí Pipeline PipelineSK PipelineSK
Projekt Project ProjectSK ProjectSK
Spuštěno dne StartedOn QueuedDateSK DateSK