管道持续时间趋势示例报告

项目
10/16/2024

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

本文介绍如何创建一个报表，该报表显示管道通常需要多长时间才能成功完成。管道持续时间报表的每日趋势类似于管道通过率报告的管道速率趋势图表。

下图显示了持续时间趋势报表的示例。

Power BI 管道持续时间趋势报表的屏幕截图。

重要

Power BI 集成和对分析服务的 OData 源的访问权限通常用于 Azure DevOps Services 和 Azure DevOps Server 2020 及更高版本。本文中提供的示例查询仅适用于 Azure DevOps Server 2020 及更高版本，具体取决于 v3.0-preview 或更高版本。我们鼓励你使用这些查询并提供反馈。

先决条件

Access：至少是具有基本访问权限的项目的成员。
权限： 默认情况下，项目成员有权查询 Analytics 和创建视图。
有关服务和功能启用和常规数据跟踪活动的其他先决条件的详细信息，请参阅访问 Analytics 的权限和先决条件。

注意

本文假设你阅读了使用 OData 查询的示例报表概述，并基本了解 Power BI。

示例查询

可以使用实体集的以下查询 PipelineRuns 来创建不同的但类似的管道持续时间趋势报告。

注意

若要确定用于筛选器或报表目的的可用属性，请参阅 Azure Pipelines 的元数据参考。可以使用提供的 EntitySet或 NavigationPropertyBinding Path 值下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( "
                &"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

在 Power BI 中使用查询之前，可以使用以下 OData 查询代码对其进行修改或测试。有关详细信息，请参阅使用 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 (SucceededCount eq 1 or PartiallySucceededCount eq 1)
    )
/compute(
    percentile_cont(TotalDurationSeconds, 0.8,CompletedDateSK) as Duration80thPercentileInSeconds)
/groupby(
    (Duration80thPercentileInSeconds, CompletedOn/Date))
&$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 (SucceededCount eq 1 or PartiallySucceededCount eq 1)

仅返回成功或部分成功的运行。

)

Close filter() 子句。

/compute(

Start compute() 子句。

percentile_cont(TotalDurationSeconds, 0.8,CompletedDateSK) as Duration80thPercentileInSeconds)

计算与筛选器条件匹配的所有管道运行的第 80 百分位管道持续时间。

/groupby(

Start groupby ()

(Duration80thPercentileInSeconds, CompletedOn/Date))

按管道运行完成日期分组，并计算第 80 百分位管道工期。

&$orderby=CompletedOn/Date asc

按完成日期对响应进行排序。

按管道 ID 而不是管道名称进行筛选

可以重命名管道。若要确保在更改管道名称时 Power BI 报表不会中断，请使用管道 ID 而不是管道名称。可以从管道运行页的 URL 获取管道 ID。

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} "
                &"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

在 Power BI 中使用查询之前，可以使用以下 OData 查询代码对其进行修改或测试。有关详细信息，请参阅使用 Power BI 和 OData 查询进行连接。

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

获取第 50 位和第 90 百分位，以及第 80 百分位持续时间趋势

可能需要查看使用其他百分位值计算的持续时间趋势。以下查询提供第 50 和第 90 百分位管道持续时间以及第 80 百分位。

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 (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

在 Power BI 中使用查询之前，可以使用以下 OData 查询代码对其进行修改或测试。有关详细信息，请参阅使用 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 (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

按分支筛选

若要仅查看特定分支管道的持续时间趋势，请使用以下查询。若要创建报表，请执行以下额外步骤以及“更改列”数据类型和“创建折线图报表”部分中所述的内容。

展开 Branch 到 Branch.BranchName。
选择 Power BI 可视化切片器并添加到 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} "
                &"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

在 Power BI 中使用查询之前，可以使用以下 OData 查询代码对其进行修改或测试。有关详细信息，请参阅使用 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 (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

所有项目管道的持续时间趋势

你可能希望在单个报表中查看项目的所有管道的持续时间趋势。若要创建报表，请执行以下额外步骤以及“更改列”数据类型和“创建折线图报表”部分中所述的内容。

展开 Pipeline 到 Pipeline.PipelineName。
从“可视化效果”窗格中选择切片器，然后将切片器字段添加到Pipeline.PipelineNam切片器字段。
从切片器中选择管道，需要查看管道传递率的趋势。

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} "
                &"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 BI 中使用查询之前，可以使用以下 OData 查询代码对其进行修改或测试。有关详细信息，请参阅使用 Power BI 和 OData 查询进行连接。

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

展开 Power Query 编辑器中的列

在创建报表之前，需要展开返回包含多个字段的记录的列。在此实例中，需要展开 CompletedOn 列以将其平展到 CompletedOn.Date。
若要了解如何展开工作项，请参阅转换分析数据以生成 Power BI 报表。

更改列数据类型

在“ 转换 ”菜单中，将小数的 Duration80thPercentileInSeconds 数据类型更改为 十进制数字。若要了解如何操作，请参阅转换列数据类型。

（可选）重命名列字段

可以重命名列字段。例如，可以将列 Pipeline.PipelineName 重命名为 Pipeline Name或 TotalCount 重命名为 Total Count。若要了解如何操作，请参阅 “重命名列字段”。

关闭查询并应用更改

完成所有数据转换后，从“开始”菜单中选择“关闭和应用”以保存查询并返回到 Power BI 中的“报表”选项卡。

创建折线图报表

在 Power BI 的“可视化效果”下，选择折线图报表。
添加到 X 轴，右键单击它，然后选择 CompletedOn.Date，而不是日期层次结构。CompletedOn.Date
添加到 Duration80thPercentileInSeconds Y 轴 右键单击它，并确保 已选择 Sum 。

显示的报表应如下图所示。

Power BI 示例管道持续时间趋势报表的屏幕截图。

通过

管道持续时间趋势示例报告

先决条件

示例查询

获取指定管道的第 80 百分位持续时间趋势

替换字符串和查询明细

查询明细

按管道 ID 而不是管道名称进行筛选

获取第 50 位和第 90 百分位，以及第 80 百分位持续时间趋势

按分支筛选

所有项目管道的持续时间趋势

展开 Power Query 编辑器 中的列

更改列数据类型

（可选）重命名列字段

关闭查询并应用更改

创建折线图报表

相关文章

反馈

其他资源

展开 Power Query 编辑器中的列