管線持續時間趨勢範例報告
Azure DevOps Services |Azure DevOps Server 2022 |Azure DevOps Server 2020
本文說明如何建立報告,顯示管線通常需要多久才能順利完成。 管線持續時間報告的每日趨勢類似於管線通過率報告的管線速率趨勢圖。
下圖顯示持續時間趨勢報表的範例。
重要
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
提供的元數據。
取得指定管線的第80個百分位數持續時間趨勢
將下列 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 (SucceededCount eq 1 or PartiallySucceededCount eq 1) "
&") "
&"/compute( "
&"percentile_cont(TotalDurationSeconds, 0.8,CompletedDateSK) as Duration80thPercentileInSeconds) "
&"/groupby( "
&"(Duration80thPercentileInSeconds, CompletedOn/Date)) "
&"&$orderby=CompletedOn/Date asc "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
替代字串和查詢明細
以您的值取代下列字串。 請勿在替代中包含括號 {} 。 例如,如果您的組織名稱為 「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 (SucceededCount eq 1 or PartiallySucceededCount eq 1)
只傳回成功或部分成功的執行。
)
Close filter()
子句。
/compute(
Start compute()
子句。
percentile_cont(TotalDurationSeconds, 0.8,CompletedDateSK) as Duration80thPercentileInSeconds)
計算符合篩選準則之所有管線執行之管線持續時間的第80個百分位數。
/groupby(
開始 groupby()
(Duration80thPercentileInSeconds, CompletedOn/Date))
依管線執行完成日期分組,並計算出第80個百分位數管線持續時間。
&$orderby=CompletedOn/Date asc
依完成日期排序回應。
依管線標識碼篩選,而不是管線名稱
管線可以重新命名。 若要確保Power BI報表不會在管線名稱變更時中斷,請使用管線標識碼,而不是管線名稱。 您可以從管線執行頁面的 URL 取得管線識別碼。
https://dev.azure.com/{organization}/{project}/_build?definitionId= `{pipelineid}`
將下列 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 (SucceededCount eq 1 or PartiallySucceededCount eq 1) "
&") "
&"/compute( "
&"percentile_cont(TotalDurationSeconds, 0.8,CompletedDateSK) as Duration80thPercentileInSeconds) "
&"/groupby( "
&"(Duration80thPercentileInSeconds, CompletedOn/Date)) "
&"&$orderby=CompletedOn/Date asc "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
取得第50個和第90個百分位數,以及第80個百分位數持續時間趨勢
您可能想要檢視使用其他百分位數值計算的持續時間趨勢。 下列查詢提供第 50 個和第 90 個百分位數管線持續時間,以及第 80 個百分位數。
將下列 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 (SucceededCount eq 1 or PartiallySucceededCount eq 1) "
&") "
&"/compute( "
&"percentile_cont(TotalDurationSeconds, 0.5,CompletedDateSK) as Duration50thPercentileInSeconds, "
&"percentile_cont(TotalDurationSeconds, 0.8,CompletedDateSK) as Duration80thPercentileInSeconds, "
&"percentile_cont(TotalDurationSeconds, 0.90,CompletedDateSK) as Duration90thPercentileInSeconds) "
&"/groupby( "
&"(Duration50thPercentileInSeconds, Duration80thPercentileInSeconds, Duration90thPercentileInSeconds, CompletedOn/Date)) "
&"&$orderby=CompletedOn/Date asc "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
依分支篩選
若要只檢視特定 分支 管線的持續時間趨勢,請使用下列查詢。 若要建立報表,請執行下列額外步驟,以及變更數據行數據類型和建立折線圖報表區段中所述的內容。
- 展開
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 (SucceededCount eq 1 or PartiallySucceededCount eq 1) "
&") "
&"/compute( "
&"percentile_cont(TotalDurationSeconds, 0.8,BranchSK, CompletedDateSK) as Duration80thPercentileInSeconds) "
&"/groupby( "
&"(Duration80thPercentileInSeconds, Branch/BranchName, CompletedOn/Date)) "
&"&$orderby=CompletedOn/Date asc "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
所有專案管線的持續時間趨勢
您可能想要在單一報表中檢視專案所有管線的持續時間趨勢。 若要建立報表,請執行下列額外步驟,以及變更數據行數據類型和建立折線圖報表區段中所述的內容。
- 展開
Pipeline
至Pipeline.PipelineName
。 - 從 [視覺效果] 窗格中選取 [交叉分析篩選器],然後將 新增
Pipeline.PipelineNam
至交叉分析篩選器的 [字段]。 - 從交叉分析篩選器中選取管線,您需要查看管線通過率的趨勢。
將下列 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 (SucceededCount eq 1 or PartiallySucceededCount eq 1) "
&") "
&"/compute( "
&"percentile_cont(TotalDurationSeconds, 0.8,PipelineId, CompletedDateSK) as Duration80thPercentileInSeconds) "
&"/groupby( "
&"(Duration80thPercentileInSeconds, Pipeline/PipelineName, CompletedOn/Date)) "
&"&$orderby=CompletedOn/Date asc "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
展開 Power Query 編輯器 中的數據行
建立報表之前,您必須展開傳回包含數個字段之記錄的數據行。 在這裡實體中,您要展開資料 CompletedOn
行,將其扁平化為 CompletedOn.Date
。
若要瞭解如何展開工作專案,請參閱 轉換分析數據以產生Power BI報表。
變更數據行數據類型
從 [轉換] 功能表,將 的數據類型變更為 Duration80thPercentileInSeconds
[十進制數]。 若要瞭解如何,請參閱 轉換數據行數據類型。
(選擇性)重新命名數據行欄位
您可以重新命名資料列欄位。 例如,您可以將資料列 Pipeline.PipelineName
重新命名為 Pipeline Name
,或 TotalCount
重新命名為 Total Count
。 若要瞭解如何,請參閱 重新命名數據行欄位。
關閉查詢並套用您的變更
完成所有數據轉換之後,請從 [常用] 功能表選擇 [關閉及套用],以儲存查詢並返回 Power BI 中的 [報表] 索引卷標。
建立折線圖報表
在 Power BI 的 [視覺效果] 下,選擇折線圖報表。
新增
CompletedOn.Date
至 X 軸,以滑鼠右鍵按兩下它,然後選取 [CompletedOn.Date],而不是 [日期階層]。將 新增
Duration80thPercentileInSeconds
至 Y 軸,以滑鼠右鍵按兩下它,並確定已選取 [總和]。
顯示的報表看起來應該類似下圖。