所有管道示例报告的管道结果摘要

  • 项目

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

可以使用本文中提供的信息来查询管道指标，例如传递率、失败次数、持续时间等，用于所有管道并创建单个报表。 提供了其他查询来获取其他指标，例如管道持续时间和所有项目管道的失败次数。

下图说明了自 2022 年 9 月以来为项目定义的所有管道的结果摘要。

所有管道结果摘要报告的屏幕截图。

如下图所示，可以从“管道名称”下拉菜单中选择任何管道，报表会更改，以专注于所选管道的结果摘要。

显示仅所选管道的结果摘要的报表的屏幕截图。

重要

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

先决条件

  • 若要查看 Analytics 数据并查询服务，你需要是具有 基本 访问权限或更高访问权限的项目的成员。 默认情况下，向所有项目成员授予查询 Analytics 和定义 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( "
	       &"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。

))

Close aggregate() 和 groupby() clauses。

(可选) 重命名查询

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

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

在 Power Query 编辑器 中展开管道列

在创建报表之前，展开 Pipeline 返回可能包含一个或多个字段的记录的列。

  1. 关闭高级编辑器。

  2. 从Power Query 编辑器中，选择Pipeline列展开按钮，确保PipelineName已选中，然后选择“确定”。

    “管道”列展开菜单的屏幕截图。

    该表现在包含展开的实体 Pipeline.PipelineName。

    Pipeline.PipelineName 列的屏幕截图。

更改列数据类型

在Power Query 编辑器中，选择TotalCount列，然后从“转换”菜单中选择“数据类型”，然后选择“整数”。 若要详细了解如何更改数据类型，请参阅 转换分析数据以生成 Power BI 报表，转换列数据类型。

（可选）重命名列字段

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

关闭查询并应用更改

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

Power Query 编辑器“关闭并应用”选项的屏幕截图。

创建堆积柱形图报表

  1. 在 Power BI 的“可视化效果”下，选择“堆积柱形图”报表。

    所有管道运行报表的可视化字段选择的屏幕截图。

  2. 向轴添加Pipeline.PipelineName或重命名的列Pipeline Name。

  3. 按指示的顺序将以下字段添加到 “值 ”，然后右键单击每个字段并确保 选中了 Sum 。

    • SucceededCount
    • FailedCount
    • CanceledCount
    • PartiallySucceededCount。

  4. 若要向报表添加切片器，请取消选择报表，然后从“可视化效果”窗格中选择切片器。

    • 向字段添加Pipeline.PipelineName或重命名的列Pipeline Name。
      添加了“可视化效果”窗格、切片器、管道名称的屏幕截图。

    • 若要将切片器从列表更改为下拉菜单选项，请从“可视化效果”窗格中选择“设置视觉画笔”图标的格式，然后选择“下拉列表”选项，而不是“列表”。

      “可视化效果”窗格、切片器、设置选项和“下拉列表”的屏幕截图。

报表如下所示。

示例“所有管道结果摘要”报表的屏幕截图。