파이프라인 통과 속도 추세 샘플 보고서

아티클
01/10/2024

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

이 문서에서는 파이프라인의 일일 통과율 추세를 보여 주는 보고서를 만드는 방법을 보여 있습니다. 파이프라인의 통과 속도는 총 파이프라인 실행에 성공한 파이프라인 실행의 백분율로 정의됩니다. 파이프라인 통과율 보고서의 '통과 속도 추세' 차트와 유사합니다. 다음 이미지는 이러한 추세의 예를 보여줍니다.

Power BI 파이프라인 실행 통과률 추세 보고서의 스크린샷.

Important

Analytics Service의 OData 피드 에 대한 Power BI 통합 및 액세스는 일반적으로 Azure DevOps Services 및 Azure DevOps Server 2020 이상 버전에서 사용할 수 있습니다. 이 문서에서 제공하는 샘플 쿼리는 Azure DevOps Server 2020 이상 버전에 대해서만 유효하며 v3.0 미리 보기 이상 버전에 따라 달라집니다. 이러한 쿼리를 사용하고 피드백을 제공하는 것이 좋습니다.

필수 조건

분석 데이터를 보고 서비스를 쿼리하려면 기본 액세스 이상의 프로젝트 멤버여야 합니다. 기본적으로 모든 프로젝트 멤버에는 분석을 쿼리하고 분석 뷰를 정의할 수 있는 권한이 부여됩니다.
서비스 및 기능 사용 및 일반 데이터 추적 활동과 관련된 다른 필수 구성 요소에 대해 알아보려면 분석에 액세스하기 위한 사용 권한 및 필수 구성 요소를 참조 하세요.

참고 항목

이 문서에서는 OData 쿼리를 사용하여 샘플 보고서 개요를 읽었 으며 Power BI에 대한 기본적인 이해를 가지고 있다고 가정합니다 .

샘플 쿼리

엔터티 집합의 PipelineRuns 다음 쿼리를 사용하여 다르지만 유사한 통과 속도 추세 보고서를 만들 수 있습니다.

참고 항목

필터 또는 보고서 용도로 사용 가능한 속성을 확인하려면 Azure Pipelines에 대한 메타데이터 참조를 참조 하세요. 에서 사용할 수 있는 값 또는 아래 값을 Property 사용하여 쿼리를 EntityType 필터링하거나 NavigationPropertyBinding Path 속성을 반환할 수 있습니다 EntitySet. 각각 EntitySet 은 .에 EntityType해당합니다. 각 값의 데이터 형식에 대해 자세히 알아보려면 해당 EntityType값에 대해 제공된 메타데이터를 검토합니다.

명명된 파이프라인에 대한 통과 속도 추세

다음 쿼리는 지정된 시작 날짜부터 특정 파이프라인에 대한 파이프라인 실행을 반환합니다.

Power BI 쿼리
OData 쿼리

아래에 나열된 Power BI 쿼리를 데이터> 비어 있는 쿼리 가져오기 창에 직접 붙여넣을 수 있습니다. 자세한 내용은 OData 쿼리를 사용하는 샘플 보고서의 개요를 검토 하세요.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
        &"$apply=filter( "
                &"Pipeline/PipelineName eq '{pipelineName}' "
                &"and CompletedDate ge {startdate} "
                &"and CanceledCount ne 1 "
        &") "
        &"/groupby( "
            &"(CompletedOn/Date), "
                &"aggregate "
                &"($count as TotalCount, "
            &"SucceededCount with sum as SucceededCount , "
                &"FailedCount with sum as FailedCount, "
            &"PartiallySucceededCount with sum as PartiallySucceededCount)) "
        &"/compute( "
    &"SucceededCount mul 100.0 div TotalCount as PassRate, "
    &"FailedCount mul 100.0 div TotalCount as FailRate, "
    &"PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate) "
    &"&$orderby=CompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

다음 OData 쿼리 코드를 사용하여 Power BI에서 쿼리를 사용하기 전에 쿼리를 수정하거나 테스트할 수 있습니다. 자세한 내용은 Power BI 및 OData 쿼리를 사용하는 커넥트 참조하세요.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?
$apply=filter(
	Pipeline/PipelineName eq '{pipelineName}'
	and CompletedDate ge {startdate}
	and CanceledCount ne 1
	)
/groupby(
	(CompletedOn/Date),
	aggregate
	($count as TotalCount,
	SucceededCount with sum as SucceededCount ,
	FailedCount with sum as FailedCount,
	PartiallySucceededCount with sum as PartiallySucceededCount))
/compute(
SucceededCount mul 100.0 div TotalCount as PassRate,
FailedCount mul 100.0 div TotalCount as FailRate,
PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate)
&$orderby=CompletedOn/Date asc

대체 문자열 및 쿼리 분석

다음 문자열을 값으로 바꿉니다. 대괄호를 대체에 {} 포함하지 마세요. 예를 들어 조직 이름이 "Fabrikam"{organization}Fabrikam{Fabrikam}인 경우 .

{organization} - 조직 이름
{project} - 팀 프로젝트 이름
{pipelinename} - 파이프라인 이름입니다. 예: Fabrikam hourly build pipeline
{startdate} - 보고서를 시작할 날짜입니다. 형식: YYYY-MM-DDZ. 예: 2021-09-01Z 2021년 9월 1일을 나타냅니다. 따옴표나 대괄호로 묶지 말고 월과 날짜 둘 다에 두 숫자를 사용합니다.

쿼리 분석

다음 표에서는 쿼리의 각 부분을 설명합니다.

쿼리 파트

설명

$apply=filter(

Start filter() 절입니다.

Pipeline/PipelineName eq '{pipelinename}'

지정된 파이프라인에 대한 파이프라인 실행을 반환합니다.

and CompletedDate ge {startdate}

반환 파이프라인은 지정된 날짜 또는 그 이후에 실행됩니다.

and CanceledCount ne 1

취소된 파이프라인 실행을 생략합니다.

)

Close filter() 절입니다.

/groupby(

Start groupby() 절입니다.

(CompletedOn/Date),

파이프라인 실행 완료 날짜별로 그룹화합니다.

aggregate

필터 조건과 일치하는 모든 파이프라인 실행에 대한 시작 aggregate 절입니다.

($count as TotalCount,

총 실행 수를 .로 TotalCount계산합니다.

SucceededCount with sum as SucceededCount ,

성공한 실행 수를 .로 SucceededCount계산합니다.

FailedCount with sum as FailedCount,

실패한 실행 수를 .로 FailedCount계산합니다.

PartiallySucceededCount with sum as PartiallySucceededCount))

부분적으로 성공한 실행 수를 .로 PartiallySucceededCount계산합니다. 닫 aggregate() 기 및 groupby() 절입니다.

/compute(

절의 compute() 시작입니다.

SucceededCount mul 100.0 div TotalCount as PassRate,

성공한 실행 수를 총 실행 수로 나누어 매일 계산 PassRate 합니다.

FailedCount mul 100.0 div TotalCount as FailRate,

실패한 실행 수를 총 실행 수로 나누어 매일 계산 FailRate 합니다.

PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate)

부분적으로 성공한 실행 수를 총 실행 수로 나누어 매일 계산 PartiallySuccessfulRate 합니다.

&$orderby=CompletedOn/Date asc

파이프라인 실행 날짜를 기준으로 결과를 오름차순으로 정렬합니다.

파이프라인 ID에 대한 통과 속도 추세

파이프라인의 이름을 바꿀 수 있습니다. 파이프라인 이름이 변경될 때 Power BI 보고서가 중단되지 않도록 하려면 파이프라인 이름 대신 파이프라인 ID를 사용합니다. 파이프라인 실행 페이지의 URL에서 파이프라인 ID를 가져올 수 있습니다.

https://dev.azure.com/{organization}/{project}/_build?definitionId={pipelineid}

다음 쿼리는 지정된 시작 날짜의 특정 파이프라인 ID에 대한 파이프라인 실행을 반환합니다.

Power BI 쿼리
OData 쿼리

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
        &"$apply=filter( "
                &"PipelineId eq {pipelineId} "
                &"and CompletedDate ge {startdate} "
                &"and CanceledCount ne 1 "
        &") "
        &"/groupby( "
            &"(CompletedOn/Date), "
                &"aggregate "
                &"($count as TotalCount, "
            &"SucceededCount with sum as SucceededCount , "
                &"FailedCount with sum as FailedCount, "
            &"PartiallySucceededCount with sum as PartiallySucceededCount)) "
        &"/compute( "
    &"SucceededCount mul 100.0 div TotalCount as PassRate, "
    &"FailedCount mul 100.0 div TotalCount as FailRate, "
    &"PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate) "
    &"&$orderby=CompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?
$apply=filter(
	PipelineId eq {pipelineId}
	and CompletedDate ge {startdate}
	and CanceledCount ne 1
	)
/groupby(
	(CompletedOn/Date),
	aggregate
	($count as TotalCount,
	SucceededCount with sum as SucceededCount ,
	FailedCount with sum as FailedCount,
	PartiallySucceededCount with sum as PartiallySucceededCount))
/compute(
SucceededCount mul 100.0 div TotalCount as PassRate,
FailedCount mul 100.0 div TotalCount as FailRate,
PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate)
&$orderby=CompletedOn/Date asc

통과 속도 추세, 분기별로 필터링

특정 분기에 대해서만 파이프라인의 통과률 추세를 볼 수 있습니다. 보고서를 만들려면 열 데이터 형식 변경 및 꺾은선형 차트 보고서 만들기 섹션에 설명된 내용과 함께 다음 추가 단계를 수행합니다.

로 확장 Branch 합니다 Branch.BranchName.
Power BI 시각화 슬라이서를 선택하고 슬라이서의 필드에 추가 Branch.BranchName 합니다.
통과 속도 추세를 확인해야 하는 슬라이서에서 분기를 선택합니다.

Power BI 쿼리
OData 쿼리

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
        &"$apply=filter( "
                &"Pipeline/PipelineName eq '{pipelineName}' "
                &"and CompletedDate ge {startdate} "
                &"and CanceledCount ne 1 "
        &") "
        &"/groupby( "
            &"(Branch/BranchName, CompletedOn/Date), "
                &"aggregate "
                &"($count as TotalCount, "
            &"SucceededCount with sum as SucceededCount , "
                &"FailedCount with sum as FailedCount, "
            &"PartiallySucceededCount with sum as PartiallySucceededCount)) "
        &"/compute( "
    &"SucceededCount mul 100.0 div TotalCount as PassRate, "
    &"FailedCount mul 100.0 div TotalCount as FailRate, "
    &"PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate) "
    &"&$orderby=CompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?
$apply=filter(
    Pipeline/PipelineName eq '{pipelineName}'
    and CompletedDate ge {startdate}
    and CanceledCount ne 1
    )
/groupby(
    (Branch/BranchName, CompletedOn/Date),
    aggregate
    ($count as TotalCount,
    SucceededCount with sum as SucceededCount ,
    FailedCount with sum as FailedCount,
    PartiallySucceededCount with sum as PartiallySucceededCount))
/compute(
SucceededCount mul 100.0 div TotalCount as PassRate,
FailedCount mul 100.0 div TotalCount as FailRate,
PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate)
&$orderby=CompletedOn/Date asc

통과 속도 추세, 빌드 이유별로 필터링

특정 빌드 이유 (수동/BatchedCI, 끌어오기 요청 등)에 대해서만 파이프라인의 통과률 추세를 볼 수 있습니다. 보고서를 만들려면 열 데이터 형식 변경 및 꺾은선형 차트 보고서 만들기 섹션에 설명된 내용과 함께 다음 추가 단계를 수행합니다.

시각화 창에서 슬라이서를 선택하고 슬라이 RunReason 서의 필드에 추가합니다.
통과 속도 추세를 확인해야 하는 슬라이서에서 파이프라인을 선택합니다.

Power BI 쿼리
OData 쿼리

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
        &"$apply=filter( "
                &"Pipeline/PipelineName eq '{pipelineName}' "
                &"and CompletedDate ge {startdate} "
                &"and CanceledCount ne 1 "
        &") "
        &"/groupby( "
            &"(RunReason, CompletedOn/Date), "
                &"aggregate "
                &"($count as TotalCount, "
            &"SucceededCount with sum as SucceededCount , "
                &"FailedCount with sum as FailedCount, "
            &"PartiallySucceededCount with sum as PartiallySucceededCount)) "
        &"/compute( "
    &"SucceededCount mul 100.0 div TotalCount as PassRate, "
    &"FailedCount mul 100.0 div TotalCount as FailRate, "
    &"PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate) "
    &"&$orderby=CompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?
$apply=filter(
    Pipeline/PipelineName eq '{pipelineName}'
    and CompletedDate ge {startdate}
    and CanceledCount ne 1
    )
/groupby(
    (RunReason, CompletedOn/Date),
    aggregate
    ($count as TotalCount,
    SucceededCount with sum as SucceededCount ,
    FailedCount with sum as FailedCount,
    PartiallySucceededCount with sum as PartiallySucceededCount))
/compute(
SucceededCount mul 100.0 div TotalCount as PassRate,
FailedCount mul 100.0 div TotalCount as FailRate,
PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate)
&$orderby=CompletedOn/Date asc

모든 프로젝트 파이프라인에 대한 통과 속도 추세

다음 쿼리를 사용하여 단일 보고서에서 프로젝트의 모든 파이프라인에 대한 통과률 추세를 볼 수 있습니다. 보고서를 만들려면 열 데이터 형식 변경 및 꺾은선형 차트 보고서 만들기 섹션에 설명된 내용과 함께 다음 추가 단계를 수행합니다.

로 확장 Pipeline 합니다 Pipeline.PipelineName.
시각화 창에서 슬라이서를 선택하고 필드를 슬라이서의 필드에 추가 Pipeline.PipelineName 합니다.
통과 속도 추세를 확인해야 하는 슬라이서에서 빌드 파이프라인을 선택합니다.

여기에 필요한 대로 유사한 단계를 자세히 설명한 모든 파이프라인 샘플 보고서에 대한 결과 요약을 참조하세요.

Power BI 쿼리
OData 쿼리

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
        &"$apply=filter( "
                &"CompletedDate ge {startdate} "
                &"and CanceledCount ne 1 "
                &") "
        &"/groupby( "
        &"(Pipeline/PipelineName, CompletedOn/Date), "
            &"aggregate "
                &"($count as TotalCount, "
                &"SucceededCount with sum as SucceededCount , "
            &"FailedCount with sum as FailedCount, "
                &"PartiallySucceededCount with sum as PartiallySucceededCount)) "
            &"/compute( "
        &"SucceededCount mul 100.0 div TotalCount as PassRate, "
    &"FailedCount mul 100.0 div TotalCount as FailRate, "
    &"PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate) "
    &"&$orderby=CompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?
$apply=filter(
    CompletedDate ge {startdate}
    and CanceledCount ne 1
    )
/groupby(
    (Pipeline/PipelineName, CompletedOn/Date),
    aggregate
    ($count as TotalCount,
    SucceededCount with sum as SucceededCount ,
    FailedCount with sum as FailedCount,
    PartiallySucceededCount with sum as PartiallySucceededCount))
/compute(
SucceededCount mul 100.0 div TotalCount as PassRate,
FailedCount mul 100.0 div TotalCount as FailRate,
PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate)
&$orderby=CompletedOn/Date asc

(선택 사항) 쿼리 이름 바꾸기

기본 쿼리 레이블인 Query1의 이름을 좀 더 의미 있는 것으로 바꿀 수 있습니다. 쿼리 설정 창에서 새 이름을 입력하기만 하면됩니다.

Power BI 쿼리 메뉴 옵션, 쿼리 이름 바꾸기 스크린샷

Power Query 편집기 열 확장

보고서를 만들기 전에 여러 필드가 포함된 레코드를 반환하는 열을 확장해야 합니다. 이 경우 열을 확장 CompletedOn 하여 평면화할 수 있습니다 CompletedOn.Date.
작업 항목을 확장하는 방법을 알아보려면 분석 데이터 변환을 참조 하여 Power BI 보고서를 생성합니다.

열 데이터 형식 변경

변환 메뉴에서 다음 열의 데이터 형식을 변경합니다. 방법을 알아보려면 열 데이터 형식 변환을 참조 하세요.

PassRate열 FailRatePartiallySuccessfulRate 에서 10진수로 지정합니다.'
TotalCount정수로

(선택 사항) 열 필드 이름 바꾸기

열 필드의 이름을 바꿀 수 있습니다. 예를 들어 열 Pipeline.PipelineNamePipeline Name이름을 로 바꾸거나 TotalCountTotal Count열로 바꿀 수 있습니다. 방법을 알아보려면 열 필드 이름을 바꿉니다.

쿼리를 닫고 변경 내용 적용

모든 데이터 변환을 완료한 후 홈 메뉴에서 닫기 및 적용 을 선택하여 쿼리를 저장하고 Power BI의 보고서 탭으로 돌아갑니다.

꺾은선형 차트 보고서 만들기

Power BI의 시각화에서 꺾은선형 차트 보고서를 선택합니다.
X축에 추가 CompletedOn.Date 합니다. 필드를 마우스 오른쪽 단추로 클릭하고 CompletedOn.Date를 선택합니다.
Y축에 추가하고 PassRate 마우스 오른쪽 단추를 클릭하여 합계가 선택되었는지 확인합니다.
보고서 제목을 변경하려면 시각화 창에서 시각적 그림판 브러시 서식 아이콘을 선택하고, 일반을 선택하고, 제목을 확장하고, 기존 텍스트를 바꿉니다.

다음 이미지는 결과 보고서를 보여줍니다.