Analytics용 데이터 모델

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

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

참고 항목

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

스키마 네임스페이스

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

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

엔터티 집합 및 엔터티 형식

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

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

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

복합 엔터티

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

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

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

관계

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

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

관계 키

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

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

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

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

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

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

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

관련된 문서

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