所有管線範例報告的管線結果摘要

  • 發行項

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

您可以使用本文中提供的資訊來查詢管線計量，例如傳遞率、失敗次數、持續時間等等，供所有管線使用，並建立單一報告。 系統會提供其他查詢以取得其他計量，例如管線持續時間和所有專案管線的失敗次數。

下圖說明自 2022 年 9 月以來針對項目定義之所有管線的結果摘要。

所有管線結果摘要報告的螢幕快照。

如下圖所示，您可以從 [管線名稱] 下拉功能表中選取任何管線，並將報表變更為將焦點放在所選管線的結果摘要上。

僅顯示所選管線結果摘要的報表螢幕快照。

重要

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 查詢的範例報表概觀。

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

替代字串和查詢明細

以您的值取代下列字串。 請勿在替代中包含括號 {} 。 例如，如果您的組織名稱為 「Fabrikam」 ，請將 取代 {organization} 為 Fabrikam，而非 {Fabrikam}。

  • {organization} - 您的組織名稱
  • {project} - 您的小組項目名稱
  • {startdate} - 開始報表的日期。 格式：YYYY-MM-DDZ。 範例： 2022-09-01Z 代表 2022 年 9 月 1 日。 請勿以引號或括弧括住，並針對月份和日期使用兩位數。

查詢明細

下表描述查詢的每個部分。

查詢元件

說明

$apply=filter(

Start filter() 子句。

CompletedDate ge {startdate}

傳回大於指定日期之日期的管線執行。

)

Close filter() 子句。

/groupby(

Start groupby() 子句/

(Pipeline/PipelineName),

依管線名稱將數據結果分組。

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。

))

關閉 aggregate() 和 groupby() 子句。

（選擇性）重新命名查詢

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

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

展開 Power Query 編輯器 中的 [管線] 資料行

建立報表之前，請展開 Pipeline 會傳回可能包含一或多個字段之記錄的數據行。

  1. 關閉 進階編輯器。

  2. 從 Power Query 編輯器，選擇數據Pipeline行展開按鈕，確定PipelineName已選取，然後選擇 [確定]。

    [管線] 資料行展開功能表的螢幕快照。

    資料表現在包含展開的實體 Pipeline.PipelineName。

    Pipeline.PipelineName 資料行的螢幕快照。

變更數據行數據類型

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

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

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

關閉查詢並套用您的變更

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

Power Query 編輯器 [關閉並套用] 選項的螢幕快照。

建立堆棧柱形圖報表

  1. 在 Power BI 的 [視覺效果] 下，選擇 [堆棧柱形圖] 報表。

    所有管線執行報表的視覺效果字段選取項目螢幕快照。

  2. 將或重新命名的數據行Pipeline Name新增Pipeline.PipelineName至 Axis。

  3. 依指示的順序將下列欄位新增至 [值 ]，然後以滑鼠右鍵按下每個欄位，並確定 已選取 [總和 ]。

    • SucceededCount
    • FailedCount
    • CanceledCount
    • PartiallySucceededCount.

  4. 若要將交叉分析篩選器新增至報表，請取消選取報表，然後從 [視覺效果] 窗格中選取交叉分析篩選器。

    • 將 Pipeline.PipelineName 或重新命名的數據行 Pipeline Name 新增至 Field。
      已新增 [視覺效果] 窗格、交叉分析篩選器、管線名稱的螢幕快照。

    • 若要將交叉分析篩選器從清單變更為下拉功能表選項，請從 [視覺效果] 窗格中選取 [格式化您的視覺油漆筆刷] 圖示，然後選取 [下拉式清單] 選項，而不是 [清單]。

      [視覺效果] 窗格、交叉分析篩選器、設定選項、已選取 [下拉式清單] 的螢幕快照。

報表如下所示。

範例 [所有管線結果摘要報告] 的螢幕快照。