管道任务工期示例报告

项目
10/16/2024

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

完成不同的任务需要多长时间？本文提供查询，可从中为特定管道及其任务生成报表。例如，下图列出了 2022 年 9 月 1 日至 12 月 15 日为特定管道完成的所有任务的第 50、80 和 95 百分位（以秒为单位）。

Power BI Pipelines 任务工期表趋势报表的屏幕截图。

重要

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

先决条件

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

注意

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

示例查询

PipelineRunActivityResults?查询实体集以返回任务工期信息。

注意

若要确定用于筛选器或报表目的的可用属性，请参阅 Azure Pipelines 的元数据参考。可以使用提供的 EntitySet或 NavigationPropertyBinding Path 值下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/PipelineRunActivityResults?"
        &"$apply=filter( "
                &"Pipeline/PipelineName eq '{pipelinename}' "
                &"and PipelineRunCompletedOn/Date ge {startdate} "
                &"and (PipelineRunOutcome eq 'Succeed' or PipelineRunOutcome eq 'PartiallySucceeded') "
        &"and (CanceledCount ne 1 and SkippedCount ne 1 and AbandonedCount ne 1) "
        &") "
            &"/compute( "
                &"percentile_cont(ActivityDurationSeconds, 0.5, TaskDisplayName) as TaskDuration50thPercentileInSeconds, "
                &"percentile_cont(ActivityDurationSeconds, 0.8, TaskDisplayName) as TaskDuration80thPercentileInSeconds, "
            &"percentile_cont(ActivityDurationSeconds, 0.95, TaskDisplayName) as TaskDuration95thPercentileInSeconds) "
                &"/groupby( "
            &"(TaskDuration50thPercentileInSeconds, TaskDuration80thPercentileInSeconds,TaskDuration95thPercentileInSeconds, TaskDisplayName)) "
        &"&$orderby=TaskDuration50thPercentileInSeconds desc "
    ,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/PipelineRunActivityResults?
$apply=filter(
    Pipeline/PipelineName eq '{pipelinename}'
    and PipelineRunCompletedOn/Date ge {startdate}
    and (PipelineRunOutcome eq 'Succeed' or PipelineRunOutcome eq 'PartiallySucceeded')
    and (CanceledCount ne 1 and SkippedCount ne 1 and AbandonedCount ne 1)
    )
/compute(
    percentile_cont(ActivityDurationSeconds, 0.5, TaskDisplayName) as TaskDuration50thPercentileInSeconds,
    percentile_cont(ActivityDurationSeconds, 0.8, TaskDisplayName) as TaskDuration80thPercentileInSeconds,
    percentile_cont(ActivityDurationSeconds, 0.95, TaskDisplayName) as TaskDuration95thPercentileInSeconds)
/groupby(
    (TaskDuration50thPercentileInSeconds, TaskDuration80thPercentileInSeconds,TaskDuration95thPercentileInSeconds, TaskDisplayName))
&$orderby=TaskDuration50thPercentileInSeconds desc

替换字符串和查询明细

将以下字符串替换为值。不要在替换中包含括号 {} 。例如，如果组织名称为“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 PipelineRunCompletedOn/Date ge {startdate}

返回指定日期或之后管道运行的任务结果。

and (PipelineRunOutcome eq 'Succeed' or PipelineRunOutcome eq 'PartiallySucceeded')

仅返回成功或部分成功的管道运行的任务结果。

and (CanceledCount ne 1 and SkippedCount ne 1 and AbandonedCount ne 1)

省略已取消、跳过或放弃的管道运行。

)

关闭子 filter() 句。

/compute(

Start compute() 子句。

percentile_cont(ActivityDurationSeconds, 0.5, TaskDisplayName) as TaskDuration50thPercentileInSeconds,

对于每个任务，计算与筛选条件匹配的所有任务的任务工期的第 50 百分位。

percentile_cont(ActivityDurationSeconds, 0.8, TaskDisplayName) as TaskDuration80thPercentileInSeconds,

对于每个任务，计算与筛选条件匹配的所有任务的任务工期的第 80 百分位。

percentile_cont(ActivityDurationSeconds, 0.95, TaskDisplayName) as TaskDuration95thPercentileInSeconds)

对于每个任务，计算所有与筛选条件匹配的任务工期的第 95 百分位。

/groupby(

groupby()启动子句。

(TaskDuration50thPercentileInSeconds, TaskDuration80thPercentileInSeconds,TaskDuration95thPercentileInSeconds, TaskDisplayName))

按管道运行的任务分组，并计算出第 50 百分位任务工期、第 80 百分位任务工期和第 95 百分位任务工期。

&$orderby=TaskDuration50thPercentileInSeconds desc

按任务对响应进行排序，其持续时间为第 50 个百分点。

(可选) 重命名查询

可以将默认查询标签 Query1 重命名为更有意义的标签。只需在 “查询设置” 窗格中输入新名称。

Power BI 查询菜单选项的屏幕截图，重命名查询。

更改列数据类型

从“ 转换 ”菜单中，将以下列的数据类型更改为 Decimal Number**. 了解如何操作，请参阅 “转换列数据类型”。
- TaskDuration80thPercentileInSeconds - TaskDuration80thPercentileInSeconds - TaskDuration95thPercentileInSeconds。

（可选）重命名列字段

可以重命名列字段。例如，可以重命名以下列，使其更易于显示。若要了解如何操作，请参阅 “重命名列字段”。

原始字段名称	重命名的字段
`TaskDisplayName`	任务名称
`TaskDuration50thPercentileInSeconds`	第 50 百分位
`TaskDuration80thPercentileInSeconds`	第 80 百分位
`TaskDuration95thPercentileInSeconds`	第 95 百分位

关闭查询并应用更改

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

创建表报表

在 Power BI 的“可视化效果”下，选择“表”报表。字段已重命名，如“ 重命名列字段 ”部分所示。
按指定的顺序将以下字段添加到“列”。
- 任务名称
- 第 50 百分位
- 第 80 百分位
- 第 95 百分位
若要更改报表标题，请从“可视化效果”窗格中选择“设置视觉画笔”图标的格式，选择“常规”，展开“标题”并替换现有文本。

下图显示了生成的报表的一部分。

Power BI Pipelines 示例任务持续时间表趋势报表的屏幕截图。

通过

管道任务工期示例报告

先决条件

示例查询

替换字符串和查询明细

查询明细

(可选) 重命名查询

更改列数据类型

（可选）重命名列字段

关闭查询并应用更改

创建表报表

反馈

其他资源

通过

管道任务工期示例报告

先决条件

示例查询

替换字符串和查询明细

查询明细

(可选) 重命名查询

更改列数据类型

（可选）重命名列字段

关闭查询并应用更改

创建表报表

相关文章

反馈

其他资源