Azure Pipelines Analytics에 대한 메타데이터 참조

  • 아티클

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

Analytics 서비스는 Azure Pipelines를 통해 생성된 파이프라인 및 테스트 작업을 수집합니다. 이 문서에서는 파이프라인에 대한 분석 보고서를 생성하는 데 사용할 수 있는 속성에 대해 설명합니다. 속성 조합을 사용하여 쿼리를 필터링하거나, 데이터를 집계하거나, 보고서를 작성할 수 있습니다.

참고

Analytics 데이터 모델에서 지원하는 엔터티, 속성 및 열거형 형식에 대한 설명이 제공됩니다. 이것은 초기 초안입니다. 자세한 정보를 원하는 영역에 대한 피드백을 제공하세요. 데이터 모델을 쿼리하려면 Analytics에 대한 OData 쿼리 생성을 참조하세요.

엔터티 집합 및 엔터티 형식

다음 표에는 Azure Pipelines를 지원하는 엔터티 형식 및 엔터티 집합이 요약되어 있습니다. 모든 엔터티 형식/엔터티 집합은 Analytics v4.0 미리 보기 버전에서 사용할 수 있습니다. 분석 버전 v3.0-preview 는 스냅샷을 지원하지 않습니다.

EntitySet EntityType 설명
분기 분기 테스트 또는 파이프라인에 사용되는 분기에 대한 기본 정보입니다. 샘플 보고서는 진행률 상태 샘플 보고서를 참조하세요.
ParallelPipelineJobsSnapshot ParallelPipelineJobsSnapshot (복합) 병렬 파이프라인 사용량에 대한 이해를 지원합니다. 병렬 파이프라인 테스트에 대한 자세한 내용은 Visual Studio 테스트 작업을 사용하여 병렬로 테스트 실행을 참조하세요.
Pipelines 파이프라인 파이프라인의 속성입니다.
PipelineJobs PipelineJob TestRun과 연결된 특정 테스트에 대한 개별 실행 결과
PipelineRuns PipelineRun 파이프라인에 대한 실행 정보입니다. 샘플 보고서는 파이프라인 통과 속도 추세 샘플 보고서를 참조하세요.
PipelineRunActivityResults PipelineRunActivityResult 특정 파이프라인 실행 내의 모든 단계, 단계, 작업 및 태스크의 병합된 로그입니다. 샘플 보고서는 파이프라인 작업 기간 샘플 보고서를 참조하세요.
PipelineTasks PipelineTask 파이프라인 내에서 사용되는 작업의 속성입니다.
TaskAgentPoolSizeSnapshots TaskAgentPoolSizeSnapshot (복합) 풀 크기, 파이프라인 작업 및 동시성에 대한 이해를 지원합니다. 에이전트 풀의 기록 그래프는 이 엔터티 집합을 사용하는 방법을 보여 줍니다.
TaskAgentRequestSnapshots TaskAgentRequestSnapshot (복합) 작업 에이전트 요청에 대한 보고를 지원합니다.

분기

다음 속성은 분기 엔터티 집합에 유효합니다. 분기와 연결된 서로게이트 키에는 및 ProjectSK가 포함됩니다BranchSK.

표시 이름 이름 데이터 형식 설명
AnalyticsUpdatedDate DateTime 분석 데이터가 마지막으로 업데이트된 시간을 나타내는 워터마크입니다.
분기 이름 BranchName 문자열 분기를 만들 때 할당된 이름입니다.
리포지토리 ID RepositoryId 문자열 리포지토리를 만들 때 할당된 번호입니다.
리포지토리 Vsts ID RepositoryVstsId 문자열 TFVC 리포지토리를 만들 때 할당된 번호입니다.
RepositoryUrl RepositoryUrl 문자열 리포지토리를 만들 때 정의된 URL입니다.

탐색 속성에는 및 참조 제약 조건이 ProjectSK포함됩니다Project.

ParallelPipelineJobsSnapshot

다음 속성은 ParallelPipelineJobsSnapshot 엔터티 집합에 유효합니다. 참조 키는 다음과 같습니다.

  • IsHosted
  • ParallelismTag
  • SamplingDate
표시 이름 이름 데이터 형식 설명
호스트 또는 자체 호스팅 IsHosted 부울 병렬 파이프라인이 Microsoft 호스팅 에이전트(True)에서 실행되거나 자체 호스팅(False)인지를 나타냅니다. 자세한 내용은 Azure Pipelines 에이전트를 참조하세요.
모든 공급자에 도달하지 못했습니다. FailedToReachAllProviders 부울 작업 실행이 모든 공급자(True)에 도달했는지 여부(False)에 도달했는지 여부를 나타냅니다.
병렬 파이프라인 작업 수 TotalCount Int32 스냅샷 일부로 실행되는 작업 수입니다.
병렬 파이프라인 시간(분) TotalMinutes Int32 스냅샷 실행하는 데 걸린 시간(분)입니다.
병렬 처리 유형 ParallelismTag 문자열 작업 스냅샷 연결된 병렬 처리 유형을 나타내는 태그입니다.
프리미엄 형식 IsPremium 부울 병렬 파이프라인이 프리미엄인지(True) 아닌지 여부를 나타냅니다(False).
샘플 날짜 SamplingDate DateTime 스냅샷 연결된 날짜입니다.

Pipelines

파이프라인 및 해당 서로게이트 키 PipelineSK에 대해 다음 속성이 유효합니다.

표시 이름 이름 데이터 형식 설명
파이프라인 ID PipelineId Int32 파이프라인에 할당된 ID입니다.
파이프라인 이름 PipelineName 문자열 파이프라인에 할당된 이름입니다.
파이프라인 버전 PipelineVersion Int32 파이프라인과 연결된 버전입니다.
파이프라인 프로세스 유형 PipelineProcessType Enumerated 파이프라인 정의의 형식입니다. PipelineProcessType에 유효한 값이 아래에 나열되어 있습니다.

탐색 속성에는 및 해당 참조 제약 조건이 ProjectSK포함됩니다Project.

PipelineProcessType 열거형 형식 멤버

다음 멤버는 파이프라인을 PipelineProcessType 정의하는 데 사용되는 메서드를 나타내는 열거형 형식에 대해 정의됩니다.

멤버 이름 값 정의
Designer 1 클래식 파이프라인 정의.
Yaml 2 YAML 파이프라인 정의.
Docker 3 Docker 파이프라인 정의.

PipelineJobs

파이프라인 작업은 단위로 순차적으로 실행되는 일련의 단계입니다. 작업은 실행하도록 예약할 수 있는 가장 작은 작업 단위입니다. 파이프라인은 작업을 중심으로 구성되며 각 파이프라인에는 하나 이상의 작업이 있습니다. 자세한 내용은 파이프라인에서 작업 지정을 참조하세요.

다음 속성은 PipelineJobs 및 해당 PipelineJobSK 서로게이트 키에 유효합니다.

표시 이름 이름 데이터 형식 설명
파이프라인 전체 작업 이름 FullJobName 문자열 파이프라인 작업의 전체 이름입니다.
파이프라인 ID PipelineId Int32 작업이 정의된 파이프라인에 할당된 ID입니다.
파이프라인 작업 식별자 JobId 문자열 파이프라인 작업을 만들 때 할당된 작업 식별자입니다.
파이프라인 작업 이름 JobName 문자열 파이프라인 작업에 할당된 이름입니다.
파이프라인 단계 이름 StageName 문자열 파이프라인 작업과 연결된 스테이지 이름입니다.
파이프라인 작업 전략 특성 StrategyAttributes 문자열 파이프라인 작업에 대해 정의된 특성입니다.
단계 식별자 StageId 문자열 파이프라인 작업과 연결된 단계 식별자입니다.

탐색 속성에는 및 해당 참조 제약 조건이 ProjectSK포함됩니다Project.

PipelineJob 엔터티 형식을 쿼리하는 샘플 보고서는 파이프라인 단계별 오류 샘플 보고서를 참조하세요.

PipelineRuns

파이프라인 실행은 파이프라인의 단일 실행을 나타냅니다. 실행하는 동안 파이프라인이 처리되고 에이전트가 하나 이상의 작업을 처리합니다. 파이프라인 실행에는 작업, 단계 및 태스크가 포함됩니다. 자세한 내용은 파이프라인 실행 시퀀스를 참조하세요.

다음 속성은 PipelineRun 엔터티 형식 및 서로게이트 키에 유효합니다 PipelineRunSK .

표시 이름 이름 데이터 형식 설명
취소된 개수 CanceledCount Int32 취소된 파이프라인 실행 수입니다.
완료 날짜 CompletedDate DateTime 파이프라인 실행이 완료된 날짜 및 시간입니다.
실패한 수 FailedCount Int32 성공한 파이프라인 실행 수입니다.
숫자 수정 버전 RunNumberRevision Int32 순차 실행을 사용하여 파이프라인 실행에 할당된 번호입니다.
부분적으로 성공한 수 PartiallySucceededCount Int32 부분적으로 성공한 파이프라인 실행 수입니다.
파이프라인 실행 ID PipelineRunId Int32 파이프라인 실행에 할당된 번호입니다.
대기 날짜 QueuedDate DateTime 파이프라인이 실행 대기된 날짜 및 시간입니다.
큐 기간 초 QueueDurationSeconds Decimal 파이프라인이 큐에 남아 있는 시간(초)입니다.
실행 번호 RunNumber 문자열 파이프라인이 실행될 때 실행되는 파이프라인에 할당된 번호입니다.
실행 결과 RunOutcome Enumerated 실행이 완료될 때 파이프라인에 할당된 결과입니다. PipelineRunOutcome에 대해 유효한 값이 아래에 나열되어 있습니다.
실행 이유 RunReason Enumerated 파이프라인이 실행되도록 한 조건입니다. PipelineRunReason에 대해 유효한 값이 아래에 나열되어 있습니다.
실행 기간 초 RunDurationSeconds Decimal 파이프라인 실행이 완료되는 데 걸린 시간(초)입니다.
시작 날짜 StartedDate DateTime 파이프라인 실행이 시작된 날짜 및 시간입니다.
성공한 개수 SucceededCount Int32 성공한 파이프라인 실행 수입니다.
총 기간(초) TotalDurationSeconds Decimal 파이프라인이 큐에 있고 실행된 총 시간(초)입니다.

지원되는 탐색 속성은 다음과 같습니다.

표시 이름 이름 -참조 제약 조건 참조된 속성
분기 Branch BranchSK BranchSK
완료됨 CompletedOn CompletedDateSK DateSK
대기 중 QueuedOn QueuedDateSK DateSK
시작 날짜 StartedOn QueuedDateSK DateSK
파이프라인 Pipeline PipelineSK PipelineSK
Project Project ProjectSK ProjectSK

PipelineRunReason 열거형 형식 멤버

다음 멤버는 조건 지정에 PipelineRunReason 설명된 대로 각 파이프라인 단계, 작업 또는 단계가 실행되는 조건을 나타내는 열거형 형식에 대해 정의됩니다.

멤버 이름 값 표시 이름
None 0 없음
Manual 1 수동
IndividualCI 2 개별 CI
BatchedCI 4 일괄 처리된 CI
Schedule 8 예약
UserCreated 32 사용자가 생성됨
ValidateShelveset 64 Shelveset 유효성 검사
CheckInShelveset 128 체크 인 진열대
PullRequest 256 끌어오기 요청
PipelineRunCompletion 512 빌드 완료

PipelineRunOutcome 열거형 형식 멤버

다음 멤버는 파이프라인 실행의 결과를 나타내는 열거형 형식에 대해 PipelineRunOutcome 정의됩니다.

멤버 이름 값 표시 이름
None 0 없음
Succeed 2 합격
PartiallySucceeded 4 부분 성공
Failed 6 실패
Canceled 32 취소됨

PipelineRunActivityResults

다음 속성은 PipelineRunActivityResults 엔터티 집합 및 해당 서로게이트 키에 PipelineRunActivityResultSK 유효합니다.

많은 속성은 날짜 기반 또는 사용자 기반입니다. 이러한 속성은 일정 날짜, 프로젝트 및 사용자 메타데이터 참조에 설명된 CalendarDate 및 사용자 엔터티 집합과 연결됩니다.

표시 이름 이름 데이터 형식 설명
중단된 개수 AbandonedCount Int32 중단된 것으로 표시된 파이프라인 실행의 수입니다.
작업 완료 날짜 ActivityCompletedDate DateTime 파이프라인 실행이 완료된 날짜 및 시간입니다.
활동 기간(초) ActivityDurationSeconds Decimal 파이프라인이 큐에 있고 실행된 총 시간(초)입니다.
활동 시작 날짜 ActivityStartedDate DateTime 파이프라인 실행이 시작된 날짜 시간입니다.
취소된 개수 CanceledCount Int32 취소된 파이프라인 실행 수입니다.
실패한 수 FailedCount Int32 실패한 파이프라인 실행 수입니다.
파이프라인 작업 유형 ActivityType Enumerated 파이프라인 작업의 유형입니다. PipelineActivityType에 대해 유효한 값이 아래에 나열되어 있습니다.
파이프라인 실행 ID PipelineRunId Int32 파이프라인이 실행될 때 실행되는 파이프라인에 할당된 번호입니다.
파이프라인 실행 결과 PipelineRunOutcome Enumerated 실행이 완료될 때 파이프라인에 할당된 결과입니다. 유효한 값은 PipelineRunOutcome 아래에 나열됩니다.
작업 시간(초)의 상대 시작 시간 RelativeStartTimeFromJobSeconds Int32 작업 시작부터 경과된 시간(초)입니다.
스테이지 초의 상대 시작 시간 RelativeStartTimeFromStageSeconds Int32 스테이지 시작부터 경과된 시간(초)입니다.
실행 초부터의 상대 시작 시간 RelativeStartTimeFromRunSeconds Int32 실행이 실행된 시점부터 경과된 시간(초)입니다.
건너뛴 개수 SkippedCount Int32 건너뛴 파이프라인 실행 수입니다.
성공한 개수 SucceededCount Int32 성공한 파이프라인 실행 수입니다.
문제 수에 성공 SucceededWithIssuesCount Int32 부분적으로 성공한 파이프라인 실행 수입니다.
작업 표시 이름 TaskDisplayName 문자열 파이프라인 실행에서 실행된 작업의 이름입니다.
작업 로그 경로 TaskLogPath 문자열 태스크에서 생성된 로그 파일의 경로입니다.
작업 결과 TaskOutcome 사용자 지정 실행된 작업의 결과입니다.

PipelineRunActivityResult 엔터티 형식을 쿼리하는 샘플 보고서는 파이프라인 작업 기간 추세 샘플 보고서를 참조하세요.

탐색 속성에는 다음 표에 나열된 속성이 포함됩니다.

표시 이름 이름 참조 제약 조건 참조된 속성
작업이 시작됨 ActivityStartedOn ActivityStartedDateSK DateSK
분기 Branch BranchSK BranchSK
파이프라인 Pipeline PipelineSK PipelineSK
파이프라인 작업 PipelineTask PipelineTaskSK PipelineTaskSK
파이프라인 작업 PipelineJob PipelineJobSK PipelineJobSK
큐에 대기 중인 파이프라인 실행 PipelineRunQueuedOn PipelineRunQueuedDateSK DateSK
파이프라인 실행이 시작됨 PipelineRunStartedOn PipelineRunStartedDateSK DateSK
파이프라인 실행 완료됨 PipelineRunCompletedOn PipelineRunCompletedDateSK DateSK
파이프라인 실행이 시작됨 PipelineRunStartedOn PipelineRunStartedDateSK DateSK
Project Project ProjectSK ProjectSK

PipelineActivityType 열거형 형식 멤버

다음 멤버는 열거형 형식에 PipelineActivityType 대해 정의됩니다.

멤버 이름 값 표시 이름
Task 0 Task
Approval 1 승인
AgentWait 2 에이전트 대기

PipelineTasks

다음 속성은 PipelineTasks 엔터티 집합 및 해당 서로게이트 키 PipelineTaskSK에 유효합니다.

표시 이름 이름 데이터 형식 설명
작업 정의 ID TaskDefinitionId GUID 파이프라인 작업에 할당된 GUID입니다.
작업 정의 버전 TaskDefinitionVersion 문자열 파이프라인 작업에 할당된 버전입니다.

탐색 속성에는 및 해당 참조 제약 조건이 ProjectSK포함됩니다Project.

TaskAgentPoolSizeSnapshots

다음 속성은 TaskAgentPoolSizeSnapshots 엔터티 집합 및 해당 서로게이트 키 SamplingDate에 유효합니다.

표시 이름 속성 이름 데이터 형식 설명
온라인 수 OnlineCount Int32 작업이 실행되었을 때 에이전트 풀의 온라인 에이전트 수입니다.
오프라인 개수 OfflineCount Int32 작업이 실행되었을 때 에이전트 풀의 오프라인 에이전트 수입니다.
풀 ID PoolId Int32 에이전트 풀에 할당된 번호입니다.
샘플 날짜 SamplingDate DateTime 풀 크기가 스냅된 날짜 및 시간입니다.

TaskAgentPoolSizeSnapshot 엔터티에서 빌드된 샘플 보고서는 에이전트 풀에 대한 기록 그래프(미리 보기)를 참조하세요.

TaskAgentRequestSnapshots

에이전트 풀은 작업이 실행될 때 할당됩니다. TaskAgentRequestSnapshots 엔터티 집합은 작업 에이전트 요청과 관련된 데이터를 캡처합니다.

TaskAgentRequestSnapshot 엔터티 형식 및 해당 서로게이트 키 SamplingTime 및 SamplingDateSK에 대해 다음 속성이 유효합니다.

표시 이름 이름 데이터 형식 설명
빌드 대기 중 IsQueued 부울 빌드가 큐에 대기 중인지(True) 큐에 대기 중이 아닌지(False)를 나타냅니다.
빌드 실행 중 IsRunning 부울 빌드가 실행 중인지(True) 실행 중인지(False)를 나타냅니다.
호스트 또는 자체 호스팅 IsHosted 부울 작업에 할당된 에이전트가 호스트되는지(True) 또는 자체 호스팅(False)인지를 나타냅니다.
작업 종료 날짜 FinishedDate DateTime 작업 에이전트 요청이 실행을 완료한 날짜 시간입니다.
FinishedDateSK Int32 작업 에이전트 요청이 실행을 완료한 날짜로, organization 대해 정의된 표준 시간대에서와 같이 YYYYMMDD 표시됩니다.
대기 날짜 QueuedDate DateTime 작업 에이전트 요청이 큐에 대기된 날짜 시간입니다.
QueuedDateSK Int32 작업 에이전트 요청이 큐에 대기된 날짜이며 organization 대해 정의된 표준 시간대에서와 같이 YYYYMMDD 표시됩니다.
큐 기간 초 QueueDurationSeconds Decimal 에이전트가 할당되기 전에 작업 에이전트 요청이 큐에 남아 있는 시간(초)입니다.
풀 ID PoolId Int32 작업 에이전트 요청에 할당된 에이전트 풀에 할당된 번호입니다.
파이프라인 유형 PipelineType 문자열 작업 에이전트 요청을 포함하는 파이프라인 유형입니다.
요청 ID RequestId Int64 작업 에이전트 요청에 할당된 번호입니다.
샘플 시간 SamplingHour Int32 요청을 받은 시간에 할당된 번호입니다.
샘플 시간 SamplingTime DateTime 작업 에이전트 요청을 받은 날짜 시간입니다.
시작 날짜 StartedDate DateTime 작업 에이전트 요청이 실행된 날짜 시간입니다.
StartedDateSK Int32 작업 에이전트 요청이 실행을 시작한 날짜로, organization 대해 정의된 표준 시간대에서와 같이 YYYYMMDD 표시됩니다.

탐색 속성에는 다음 표에 나열된 속성이 포함됩니다.

표시 이름 이름 참조 제약 조건 -Referenced 속성
분기 Branch BranchSK BranchSK
완료됨 CompletedOn CompletedDateSK DateSK
작업 종료 시간 FinishedOn FinishedDateSK DateSK
대기 중 QueuedOn QueuedDateSK DateSK
파이프라인 Pipeline PipelineSK PipelineSK
Project Project ProjectSK ProjectSK
시작 날짜 StartedOn QueuedDateSK DateSK