Bug 趋势示例报告

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Bug 趋势报告有助于了解团队关闭活动 bug 的成绩。 本文介绍如何显示一段时间内处于给定状态的 bug 数。 下图显示了 bug 趋势报告的示例。

Bug 趋势折线图报表的屏幕截图。

备注

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

先决条件

  • 若要查看 Analytics 数据并查询服务,你需要是具有 基本 访问权限或更高访问权限的项目的成员。 默认情况下,向所有项目成员授予查询 Analytics 和定义 Analytics 视图的权限。
  • 若要了解有关服务和功能启用以及常规数据跟踪活动的其他先决条件,请参阅 访问 Analytics 的权限和先决条件

示例查询

以下查询返回 WorkItemSnapshot 实体集中的数据,以支持生成趋势报告。

备注

若要确定用于筛选或报告目的的可用属性,请参阅Azure Boards的元数据参考。 可以使用 随 一起提供的 EntitySetNavigationPropertyBinding Path 值下EntityType的任何Property值筛选查询或返回属性。 每个 对应 EntitySet 一个 EntityType。 若要详细了解每个值的数据类型,请查看为相应的 EntityType提供的元数据。

按区域路径筛选的 Bug 趋势

以下查询按区域路径和开始日期筛选 bug。

可以将下面列出的 Power BI 查询直接粘贴到 “获取数据空白>查询 ”窗口中。 有关详细信息,请参阅 使用 OData 查询的示例报表概述

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot? "
        &"$apply=filter( "
            &"WorkItemType eq 'Bug' "
            &"and State ne 'Closed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and DateValue ge {startdate}  "
            &") "
        &"/groupby( "
            &"(DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK), "
            &"aggregate($count as Count) "
            &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

替换字符串和查询明细

将以下字符串替换为你的值。 不要在替换中包含括号 {} 。 例如,如果组织名称为“Fabrikam”,请将 替换为 {organization}Fabrikam,而不是 {Fabrikam}

  • {organization} - 组织名称
  • {project} - 对于跨项目查询,团队项目名称或完全省略“/{project}”
  • {areapath} - 区域路径。 示例格式: Project\Level1\Level2
  • {startdate} - 为在给定日期或之后完成的项启动报表,格式为: YYYY-MM-DDZ。 例如: 2022-04-01Z 表示 2022 年 4 月 1 日。 不要用引号括起来。

查询明细

下表描述了查询的每个部分。

查询部件

说明

$apply=filter(

filter 语句子句的开头。

WorkItemType eq 'Bug'

返回 Bug。

and State ne 'Closed'

忽略处于“已关闭”状态的 bug。

and startswith(Area/AreaPath,'{areapath}')

返回指定'{areapath}'的特定区域路径下的工作项。 若要按团队名称进行筛选,请使用筛选器语句 Teams/any(x:x/TeamName eq '{teamname})'

and DateValue ge {startdate}

在指定日期或之后开始趋势。 示例: 2021-04-01Z 表示 2021-April-01。

)

Close filter() 子句。

/groupby(

Start groupby() 子句。

(DateValue, State, WorkItemType, Priority, Severity, Area/AreaPath, Iteration/IterationPath),

DateValue分组,用于趋势以及要报告的任何其他字段。

aggregate($count as Count)

通过计算与每个日期的条件匹配的 bug 进行聚合。

)

Close groupby() 子句。

按 Teams 筛选的 Bug 趋势

可以按团队名称而不是区域路径查询 bug 趋势。

可以将下面列出的 Power BI 查询直接粘贴到 “获取数据空白>查询 ”窗口中。 有关详细信息,请参阅 使用 OData 查询的示例报表概述

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot? "
        &"$apply=filter( "
            &"WorkItemType eq 'Bug' "
            &"and State ne 'Closed' "
            &"and (Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}')"
            &"and DateValue ge {startdate}  "
            &") "
        &"/groupby( "
            &"(DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK), "
            &"aggregate($count as Count) "
            &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

每周五快照的 Bug 趋势

使用每周快照可以减少拉取到 Power BI 中的数据量,并提高查询性能。

可以将下面列出的 Power BI 查询直接粘贴到 “获取数据空白>查询 ”窗口中。 有关详细信息,请参阅 使用 OData 查询的示例报表概述

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot? "
        &"$apply=filter( "
            &"WorkItemType eq 'Bug' "
            &"and State ne 'Closed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and DateValue ge {startdate} "
            &"and Date/DayName eq 'Friday'  "
        &") "
        &"/groupby( "
            &"(DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK), "
            &"aggregate($count as Count) "
        &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

每月第一天快照的 Bug 趋势

使用每月快照可以减少拉取到 Power BI 中的数据量,并提高查询性能。

可以将下面列出的 Power BI 查询直接粘贴到 “获取数据空白>查询 ”窗口中。 有关详细信息,请参阅 使用 OData 查询的示例报表概述

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot? "
        &"$apply=filter( "
            &"WorkItemType eq 'Bug' "
            &"and State ne 'Closed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and DateValue ge {startdate} "
            &"and Date/DayOfMonth eq 1  "
        &") "
        &"/groupby( "
            &"(DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK), "
            &"aggregate($count as Count) "
        &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

(可选) 重命名查询

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

Power BI 查询菜单选项的屏幕截图,其中重命名了查询。

在 Power BI 中展开列

Area/AreaPath展开 和 Iteration/IterationPath 列。 展开列会将记录平展为特定字段。 若要了解如何操作,请参阅 转换分析数据以生成 Power BI 报表

(可选) 重命名字段

展开列后,可能需要重命名一个或多个字段。 例如,可以将列 AreaPath 重命名为 Area Path。 若要了解如何操作,请参阅 重命名列字段

关闭查询并应用更改

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

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

创建折线图报表

  1. 在 Power BI 中,选择“可视化效果”下的“折线图”报表。

    “Bug 趋势”报表的 Power BI 可视化效果和字段选择的屏幕截图。

  2. 将“ 添加到 DateValueX 轴,然后DateValue右键单击并选择 DateValue 而不是 Date Hierarchy

  3. 将 添加到 CountY 轴,然后 Count 右键单击并确保选中“ 总和 ”。

  4. 添加到State图例

显示示例报表。

示例 Bug 趋势折线图报表的屏幕截图。

修改报表格式视觉对象

  • 若要修改报表的格式元素,请选择“ 设置视觉对象 (画笔) ”图标,然后修改一个或多个可用设置。 例如,可以修改趋势图中使用的线条颜色。

    Bug 趋势报表的 Power BI 格式视觉对象选择的屏幕截图。

若要了解详细信息,请参阅 格式设置窗格入门