Analytics용 데이터 모델

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

Azure DevOps에 대한 분석 데이터 모델은 멤버(엔터티)에 필터링, 집계 및 요약할 수 있는 속성이 포함된 엔터티 집합으로 구성됩니다. 또한 엔터티를 서로 연결하는 탐색 속성 이 포함되어 선택, 필터링 및 그룹화에 대한 다른 속성에 대한 액세스를 제공합니다.

참고

Analytics 서비스는 모든 Azure DevOps Services 대해 프로덕션에서 자동으로 사용하도록 설정되고 지원됩니다. Power BI 통합 및 Analytics Service의 OData 피드 에 대한 액세스는 일반적으로 사용할 수 있습니다. 이를 사용하고 피드백을 제공하는 것이 좋습니다. 사용 가능한 데이터는 버전에 따라 다릅니다. 지원되는 최신 버전은 이며 v2.0최신 미리 보기 버전은 입니다 v4.0-preview. 자세한 내용은 OData API 버전 관리를 참조하세요.

스키마 네임스페이스

Analytics 데이터 모델은 다음 두 스키마 네임스페이스를 기반으로 합니다.

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

엔터티 집합 및 엔터티 형식

엔터티 형식은 키가 있는 구조화된 형식으로 명명됩니다. 각 엔터티의 명명된 속성과 관계를 정의합니다. 의 EntityType 키는 기본 속성의 하위 집합(예: WorkItemId, PipelineId, ReleasePipelineId 등)과 엔터티 형식의 하위 집합에서 형성됩니다.

엔터티 집합은 엔터티의 명명된 컬렉션입니다. 예를 들어 는 WorkItems 엔터티를 포함하는 WorkItem 엔터티 집합입니다. 엔터티의 키는 엔터티 집합 내의 엔터티를 고유하게 식별합니다. 여러 엔터티 집합이 동일한 엔터티 형식을 사용하는 경우 키 값의 동일한 조합이 둘 이상의 엔터티 집합에 표시되고 이 키 조합이 표시되는 엔터티 집합당 하나씩 다른 엔터티를 식별할 수 있습니다. 이러한 각 엔터티에는 서로 다른 엔터티 ID가 있습니다. 엔터티 집합은 데이터 모델에 진입점을 제공합니다.

엔터티 집합은 OData 메타데이터에 설명되어 있으며 프로젝트에 따라 다릅니다. 프로젝트에 대한 OData 메타데이터를 요청하여 엔터티 집합, 엔터티 형식 및 속성의 전체 목록을 탐색할 수 있습니다. 방법을 알아보려면 Analytics에 대한 OData 쿼리 생성을 참조하세요.

복합 엔터티

복합 엔터티는 특정 시나리오를 지원합니다. 더 간단한 엔터티로 구성되고, 생성하기 위해 더 많은 컴퓨팅 리소스가 필요한 경우가 많으며, 더 큰 결과 집합을 반환할 수 있습니다. 최상의 성능을 달성하고 불필요한 제한을 방지하려면 시나리오에 맞는 올바른 엔터티를 쿼리해야 합니다.

예를 들어 는 WorkItemSnapshot 각 날짜에 WorkItemRevisions 각 작업 항목에 대해 하나의 수정 버전이 있도록 및 Dates 을 결합합니다. 이 표현은 필터링된 작업 항목 집합에 대한 추세 데이터에 초점을 맞추는 OData 쿼리를 지원합니다. 그러나 이 복합 엔터티를 사용하여 작업 항목의 현재 상태를 쿼리해서는 안 됩니다. 대신 엔터티 집합을 WorkItems 사용하여 더 빠른 실행 쿼리를 생성해야 합니다.

마찬가지로 일부 엔터티는 모든 기록 값을 포함할 수 있지만 다른 엔터티는 현재 값만 포함할 수 있습니다. WorkItemRevisions 에는 현재 값이 관심 있는 시나리오에서 사용하면 안 되는 모든 작업 항목 기록이 포함됩니다.

관계

더 복잡한 쿼리 결과를 생성하려면 관계를 사용하여 엔터티를 결합할 수 있습니다. 관계를 사용하여 데이터를 확장, 필터링 또는 요약할 수 있습니다.

일부 탐색 속성은 단일 엔터티를 생성하고 다른 항목은 엔터티 컬렉션을 생성합니다. 다음 다이어그램에서는 선택 엔터티 및 해당 탐색 속성을 보여 있습니다. 명확성을 위해 일부 복합 엔터티 및 관계는 생략되었습니다.

관계 키

엔터티 관계는 외부 도구가 엔터티를 조인할 수 있도록 외문 키로도 표시됩니다. 이러한 속성에는 접미사 "SK"가 있으며 정수 또는 GUID 데이터 형식입니다. 날짜 속성에는 YYYYMMDD 형식의 해당 정수 날짜 키 속성이 있습니다.

작업 추적 엔터티 형식 및 엔터티 집합

다음 엔터티 형식 및 엔터티 집합은 표시된 API 버전에서 지원됩니다. 전체 참조는 Azure Boards Analytics에 대한 작업 추적 메타데이터 참조를 참조하세요.

EntityType/EntitySet	Description	v1.0	v2.0	v3.0-미리 보기	v4.0-preview
영역/ Areas	영역 계층 구조별로 그룹화 및 필터링하기 위한 속성이 있는 작업 항목 영역 경로입니다.	✔️	✔️	✔️	✔️
반복/ 반복 횟수	반복 계층 구조별로 그룹화 및 필터링하기 위한 속성이 있는 작업 항목 반복 경로입니다.	✔️	✔️	✔️	✔️
BoardLocation/ BoardLocations	보드 열, 스윔 레인 및 분할로 식별되는 Kanban 보드 셀 위치에는 기록 보드 설정이 포함됩니다. 각 Kanban 보드 필드에 대한 설명은 워크플로 및 Kanban 보드 필드를 참조하세요.	✔️	✔️	✔️	✔️
CalendarDate/ 날짜	관계를 사용하여 다른 엔터티를 필터링하고 그룹화하는 데 사용되는 날짜입니다.	✔️	✔️	✔️	✔️
Project/ 프로젝트	organization(클라우드) 또는 프로젝트 컬렉션(온-프레미스)에 대해 정의된 모든 프로젝트입니다.	✔️	✔️	✔️	✔️
프로세스/ 프로세스	작업 항목 및 작업 항목 유형을 확장하거나 필터링하는 데 사용되는 백로그 정보입니다. 프로세스를 사용하여 보고서를 필터링하는 예제는 요구 사항 추적 샘플 보고서를 참조하세요.		✔️	✔️	✔️
태그/ 태그	각 프로젝트에 대한 모든 작업 항목 태그입니다. 태그를 사용하여 보고서를 필터링하는 예제 는릴리스 번다운 샘플 보고서를 참조하세요.	✔️	✔️	✔️	✔️
팀/ Teams	프로젝트에 대해 정의된 모든 팀입니다. Teams를 사용하여 보고서를 필터링하는 예제는 Power BI 보고서에 팀 슬라이서 추가를 참조하세요.	✔️	✔️	✔️	✔️
사용자/ 사용자	다양한 작업 항목 속성을 확장하거나 필터링하는 데 사용되는 사용자 정보(예: 할당 대상, 만든 사용자).	✔️	✔️	✔️	✔️
WorkItemBoardSnapshot/ WorkItemBoardSnapshot	(복합) 추세 보고서를 생성하는 데 사용되는 Kanban 보드 위치를 포함하여 각 달력 날짜의 각 작업 항목 상태입니다. 샘플 보고서는 CFD(누적 흐름 다이어그램) 샘플 보고서를 참조하세요.	✔️	✔️	✔️	✔️
WorkItemLink/ WorkItemLinks	작업 항목(예: 자식, 부모 및 관련 항목) 간의 링크입니다. 링크의 최신 수정 버전만 포함하며 기록은 없습니다. 하이퍼링크는 포함되지 않습니다.	✔️	✔️	✔️	✔️
WorkItemRevision/ WorkItemRevisions	현재 수정 버전을 포함한 모든 기록 작업 항목 수정 버전입니다. 삭제된 작업 항목은 포함하지 않습니다.	✔️	✔️	✔️	✔️
WorkItemSnapshot/ WorkItemSnapshot	(복합) 추세 보고를 지원하는 데 사용되는 각 달력 날짜의 각 작업 항목 상태입니다. 샘플 보고서는 버그 추세 샘플 보고서를 참조하세요.	✔️	✔️	✔️	✔️
Workitem/ WorkItems	작업 항목의 현재 상태입니다. 상태 보고서를 지원하는 데 사용됩니다. 샘플 보고서는 자식 작업 항목 값을 부모 샘플 보고서에 롤업을 참조하세요.	✔️	✔️	✔️	✔️
WorkItemTypeField/ WorkItemTypeFields	각 작업 항목 유형 및 프로세스에 대한 작업 항목 속성입니다. 보고서 작성을 지원하는 데 사용됩니다.	✔️	✔️	✔️	✔️

파이프라인 엔터티 형식 및 엔터티 집합

다음 엔터티 형식 및 엔터티 집합은 v3.0-preview 또는 v4.0-preview Analytics 버전에서 지원됩니다. 전체 참조는 파이프라인 메타데이터 참조 를 참조 하세요.

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

엔터티 형식 및 엔터티 집합 테스트

다음 엔터티 형식 및 엔터티 집합은 v3.0-preview 또는 v4.0-preview Analytics 버전에서 지원됩니다. 전체 참조는 테스트 메타데이터 참조를 참조하세요.

EntityType/EntitySet	Description	v3.0-미리 보기	v4.0-preview
TestConfiguration/ TestConfigurations	계획 구성 정보를 테스트합니다. 테스트 구성에 대한 자세한 내용은 다른 구성 테스트를 참조하세요.	✔️	✔️
TestResult/ TestResults	TestRun과 연결된 특정 테스트에 대한 개별 실행 결과입니다.	✔️	✔️
TestResultsDaily/ TestResultsDaily	TestRun이 아닌 Test별로 그룹화된 TestResult 실행의 일일 스냅샷 집계입니다. 샘플 보고서는 테스트 요약 추세 샘플 보고서를 참조하세요.	✔️	✔️
TestRun/ TestRuns	테스트에 대한 실행 정보는 집계 TestResult가 있는 파이프라인에서 실행됩니다.	✔️	✔️
테스트/ 테스트	테스트 이름 및 테스트 소유자와 같은 테스트 사례에 대한 속성입니다. 테스트 사례 정의에 대한 자세한 내용은 수동 테스트 사례 만들기를 참조하세요.	✔️	✔️
TestPoint/ TestPoints	테스트 지점에 대한 실행 정보입니다. 테스트 지점은 테스트 사례, 테스트 도구 모음, 구성 및 테스터의 고유한 조합입니다. 샘플 보고서는 진행률 상태 샘플 보고서를 참조하세요.	✔️	✔️
TestPointHistorySnapshot/ TestPointHistorySnapshots	(복합) TestRun과 연결된 특정 테스트에 대한 개별 실행 결과입니다. 샘플 보고서는 수동 테스트 실행 추세 샘플 보고서를 참조하세요.	✔️	✔️
TestSuite/ TestSuites	테스트 도구 모음 정보입니다. 테스트 도구 모음 정의에 대한 자세한 내용은 테스트 계획 및 테스트 도구 모음 만들기를 참조하세요.	✔️	✔️

관련 문서

• OData Analytics 쿼리 지침
• WIT 분석
• 데이터 집계
• Analytics OData 메타데이터 탐색
• 작업 추적, 프로세스 및 프로젝트 제한
• Analytics 보기 데이터 세트 디자인