管線結果摘要範例報告

發行項
01/10/2024

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

管線執行代表管線的單一執行。在執行期間，會處理管線，而代理程式會處理一或多個作業。結果包括成功、失敗、已取消和部分成功。若要建立顯示管線執行結果的報表，您可以查詢 ''PipelineRuns entity set。

本文提供數個查詢和指示，說明如何建立報表，以取得不同管線結果的執行次數。

下圖顯示結果摘要報表的範例。

Power BI 管線結果摘要報告的螢幕快照。

重要

Azure DevOps Services 和 Azure DevOps Server 2020 和更新版本的 Power BI 整合和存取 Analytics Service 的 OData 摘要已正式推出。本文中提供的範例查詢僅適用於 Azure DevOps Server 2020 和更新版本，且相依於 v3.0-preview 或更新版本。我們鼓勵您使用這些查詢並提供意見反應。

必要條件

若要檢視分析數據和查詢服務，您必須是具有基本存取權或更高許可權的項目成員。根據預設，所有專案成員都會獲得查詢分析的許可權，並定義分析檢視。
若要瞭解有關服務與功能啟用和一般數據追蹤活動的其他必要條件，請參閱存取分析的許可權和必要條件。

注意

本文假設您已閱讀使用 OData 查詢的範例報表概觀，並具備 Power BI 的基本瞭解。

範例查詢

您可以使用實體集的 PipelineRuns 下列查詢來建立不同但類似的管線結果摘要報告。

注意

若要判斷篩選或報表用途的可用屬性，請參閱 Azure Pipelines 的元數據參考。您可以使用的或 NavigationPropertyBinding Path 值EntitySet底下EntityType的任何Property值來篩選查詢或傳回屬性。每個 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} "
                &") "
        &"/aggregate( "
        &"$count as TotalCount, "
            &"SucceededCount with sum as SucceededCount , "
                &"FailedCount with sum as FailedCount, "
                &"PartiallySucceededCount with sum as PartiallySucceededCount , "
            &"CanceledCount with sum as CanceledCount "
                &") "
    ,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}
	)
/aggregate(
	$count as TotalCount,
	SucceededCount with sum as SucceededCount ,
	FailedCount with sum as FailedCount,
	PartiallySucceededCount with sum as PartiallySucceededCount ,
	CanceledCount with sum as CanceledCount
	)

替代字串和查詢明細

以您的值取代下列字串。請勿在替代中包含括號 {} 。例如，如果您的組織名稱為「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}

傳回管線會在指定的日期或之後執行。

)

Close filter() 子句

/aggregate(

符合篩選準則的所有管線執行的 Start aggregate 子句。

$count as TotalCount,

將執行總數計算為 TotalCount。

SucceededCount with sum as SucceededCount ,

將成功執行的數目計算為 SucceededCount。

FailedCount with sum as FailedCount,

將失敗的執行數目計算為 FailedCount。

PartiallySucceededCount with sum as PartiallySucceededCount ,

將部分成功執行的數目計算為 PartiallySucceededCount。

CanceledCount with sum as CanceledCount

將取消的執行數目計算為 CanceledCount。

)

Close aggregate() 子句。

特定管線標識碼的管線執行結果摘要

管線可以重新命名。若要確保Power BI報表不會在變更管線名稱時中斷，請使用管線標識碼，而不是其名稱。您可以從管線執行頁面的 URL 取得管線識別碼。

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

下列查詢會傳回特定管線標識碼的管線執行，以及從指定的開始日期執行。

Power BI 查詢
OData 查詢

您可以將下面所列的 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} "
                &") "
        &"/aggregate( "
        &"$count as TotalCount, "
            &"SucceededCount with sum as SucceededCount , "
                &"FailedCount with sum as FailedCount, "
                &"PartiallySucceededCount with sum as PartiallySucceededCount , "
            &"CanceledCount with sum as CanceledCount "
                &") "
    ,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(
    PipelineId eq {pipelineId}
    and CompletedDate ge {startdate}
    )
/aggregate(
    $count as TotalCount,
    SucceededCount with sum as SucceededCount ,
    FailedCount with sum as FailedCount,
    PartiallySucceededCount with sum as PartiallySucceededCount ,
    CanceledCount with sum as CanceledCount
)

依分支篩選的管線執行結果摘要

若要檢視特定分支管線的結果摘要，請使用下列查詢。若要建立報表，請執行下列步驟：

展開 Branch 至 Branch.BranchName
變更數據行數據類型
建立環圈圖報表
從 [視覺效果] 窗格中選取交叉分析篩選器，並將新增Branch.BranchName至交叉分析篩選器的欄位
從交叉分析篩選器中選取需要查看結果摘要的分支。

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} "
                &") "
        &"/groupby( "
        &"(Branch/BranchName), "
            &"aggregate( "
                &"$count as TotalCount, "
                &"SucceededCount with sum as SucceededCount , "
            &"FailedCount with sum as FailedCount, "
                &"PartiallySucceededCount with sum as PartiallySucceededCount , "
            &"CanceledCount with sum as CanceledCount "
        &")) "
    ,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}
    )
/groupby(
(Branch/BranchName),
aggregate(
    $count as TotalCount,
    SucceededCount with sum as SucceededCount ,
    FailedCount with sum as FailedCount,
    PartiallySucceededCount with sum as PartiallySucceededCount ,
    CanceledCount with sum as CanceledCount
    ))

依建置原因篩選的管線執行結果摘要

您可能只想要檢視管線的結果摘要，原因只有特定的 建置原因 （手動/BatchedCI、提取要求等等）。若要建立報表，請執行下列步驟：

變更數據行數據類型
建立環圈圖報表
從 [視覺效果] 窗格中選取交叉分析篩選器，並將新增Pipeline.PipelineName至交叉分析篩選器的欄位
從交叉分析篩選器中選取管線，您需要查看結果摘要。

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} "
                &") "
        &"/groupby( "
        &"(RunReason), "
            &"aggregate( "
                &"$count as TotalCount, "
                &"SucceededCount with sum as SucceededCount , "
            &"FailedCount with sum as FailedCount, "
                &"PartiallySucceededCount with sum as PartiallySucceededCount , "
            &"CanceledCount with sum as CanceledCount "
        &")) "
    ,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}
    )
/groupby(
(RunReason),
aggregate(
    $count as TotalCount,
    SucceededCount with sum as SucceededCount ,
    FailedCount with sum as FailedCount,
    PartiallySucceededCount with sum as PartiallySucceededCount ,
    CanceledCount with sum as CanceledCount
))

所有專案管線的結果摘要

您可能想要檢視單一報表中所有專案管線的管線結果摘要。若要建立報表，請執行下列步驟：

展開 Pipeline 至 Pipeline.PipelineName
變更數據行數據類型
建立環圈圖報表
從 [視覺效果] 窗格中選取交叉分析篩選器，並將新增Pipeline.PipelineName至交叉分析篩選器的欄位
從交叉分析篩選器中選取管線，您需要查看結果摘要。

如需詳細步驟，另請參閱所有管線範例報表的結果摘要。

Power BI 查詢
OData 查詢

您可以將下面所列的 Power BI 查詢直接貼到 [取得資料空白>查詢 ] 視窗中。如需詳細資訊，請檢閱使用 OData 查詢的範例報表概觀。

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
        &"$apply=filter( "
                &"CompletedDate ge {startdate} "
                &") "
                &"/groupby( "
        &"(Pipeline/PipelineName), "
        &"aggregate( "
            &"$count as TotalCount, "
                &"SucceededCount with sum as SucceededCount , "
                &"FailedCount with sum as FailedCount, "
            &"PartiallySucceededCount with sum as PartiallySucceededCount , "
                &"CanceledCount with sum as CanceledCount "
            &")) "
    ,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(
    CompletedDate ge {startdate}
    )
/groupby(
(Pipeline/PipelineName),
aggregate(
    $count as TotalCount,
    SucceededCount with sum as SucceededCount ,
    FailedCount with sum as FailedCount,
    PartiallySucceededCount with sum as PartiallySucceededCount ,
    CanceledCount with sum as CanceledCount
    ))

（選擇性）重新命名查詢

您可以將預設查詢標籤 Query1 重新命名為更有意義的專案。只要從 [查詢設定] 窗格中輸入新名稱即可。

Power BI 查詢功能表選項、重新命名查詢的螢幕快照。

變更數據行數據類型

從 Power Query 編輯器選取數據TotalCount行，然後從 [轉換] 功能選取 [資料類型]，然後選擇 [神秘 le Number]。若要深入瞭解如何變更數據類型，請參閱轉換分析數據以產生Power BI報表、轉換資料行數據類型。

（選擇性）重新命名數據行欄位

您可以重新命名資料列欄位。例如，您可以將資料列 Pipeline.PipelineName 重新命名為 Pipeline Name，或 TotalCount 重新命名為 Total Count。若要瞭解如何，請參閱重新命名數據行欄位。

關閉查詢並套用您的變更

完成所有數據轉換之後，請從 [常用] 功能表選擇 [關閉及套用]，以儲存查詢並返回 Power BI 中的 [報表] 索引卷標。

建立環圈圖報表

在 Power BI 的 [視覺效果] 下，選擇環圈報表。
依指示的順序，將下列字段新增至 [值]。以滑鼠右鍵按下每個字段，並確定 已選取 [總和 ]。
- CanceledCount
- PartiallySucceededCount.
- SucceededCount
- FailedCount
若要變更報表標題，請從 [視覺效果] 窗格中選取 [格式化您的視覺油漆筆刷] 圖示，選取 [一般]，展開 [標題]，然後取代現有的文字。

下圖顯示產生的報表。

管線結果摘要範例報告

必要條件

範例查詢

具名管線的管線持續時間

替代字串和查詢明細

查詢明細

特定管線標識碼的管線執行結果摘要

依分支篩選的管線執行結果摘要

依建置原因篩選的管線執行結果摘要

所有專案管線的結果摘要

（選擇性）重新命名查詢

變更數據行數據類型

（選擇性）重新命名數據行欄位

關閉查詢並套用您的變更

建立環圈圖報表

相關文章

意見反應

意見反應

其他資源