在 Azure DevOps 中访问 Analytics 的权限和先决条件

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

若要使用 Analytics 并创建报表，必须满足本文中概述的几个先决条件。

默认情况下，所有项目成员都有权访问其所属项目的 Analytics 数据，包括添加到项目 “读取者 ”组的成员。 具有 利益干系人 访问权限的用户无权查看或编辑 Analytics 视图。

服务和功能启用

通常，Analytics 始终处于打开状态，可供组织或集合的成员查看数据和创建报表。

分析服务

对于Azure DevOps Services，Analytics 始终处于打开状态。 不能禁用或暂停它。

Azure DevOps 服务

若要执行任何 Azure DevOps 服务，必须启用该服务。 对于已禁用的服务，无法捕获任何数据。 可以逐个项目启用或禁用服务。

若要验证是否已启用所有服务，请参阅 打开或关闭服务。

Analytics 视图

分析视图（Web 门户中的中心）提供了一种简化的方法，用于根据分析数据为 Power BI 报表指定筛选条件。 若要了解详细信息，请参阅什么是 Analytics Service？

若要访问 Analytics 视图，必须启用它。 项目集合管理员组的组织所有者或成员可以为组织中的每个人启用它。 或者，每个项目成员都可以自行启用它。

若要了解如何操作，请参阅 管理或启用功能。

权限

在项目级别为服务设置权限，在对象级别为共享分析视图设置权限。

下表汇总了可设置的权限，以及对项目安全组进行的默认分配。

权限	Readers	作者	项目管理员
查看分析	✔️	✔️	✔️
查看共享分析视图		✔️	✔️
添加专用或共享分析视图		✔️	✔️
编辑和删除共享分析视图			✔️

数据跟踪先决条件

若要捕获有意义的数据，软件团队必须执行有意义的操作。 以下部分根据要报告的数据类型提供一般建议。

注意

Analytics v3.0-preview 及更高版本支持分支、管道和测试实体集。 使用 Analytics v4.0 预览 版添加了支持管道作业、任务代理请求和任务代理池大小的快照实体集。 请确保指定支持相关实体集的分析版本。

若要了解可以筛选或分组数据的属性和枚举列表值，请浏览相应实体类型的 Analytics 元数据 。

Azure Boards和工作跟踪

有关可查询的可用实体集的查看，请参阅 Azure Boards Analytics 的元数据参考。

若要报告工作跟踪，团队需要执行多个任务，以确保有意义的数据可用。 在定义 Analytics 查询和报表之前，请查看以下任务。

• 若要报告活动 bug 或 bug 趋势，请定义 bug 并在修复、验证和关闭时更新 bug 状态 。
• 若要报告积压工作或其他工作项类型，请确保定义这些工作项，并在工作项从新工作项移动到关闭状态时更新其 状态 。 考虑将用于筛选或分组报表中的数据的任何字段或标记，并确保其定义正确且一致。
• 若要支持汇总报表，请确保产品积压工作项和任务/bug 之间存在父子链接，或者确保功能或项目组合积压工作项与其子项之间存在父子链接。 若要了解详细信息，请参阅组织积压工作 (backlog) 并将子工作项映射到父项。
• 若要创建进度或烧毁报表（如 Sprint 燃尽 或 发布进度），请确保已考虑如何筛选和分组报表中的数据。 燃尽/烧毁报告引用 WorkItemsSnapshot 实体集。 快照实体集建模为每日快照。 数据根据分配日期的分配进行聚合。 这意味着，若要根据字段或标记分配筛选燃尽/烧毁报告，必须在要报告的时间段之前分配字段或标记。 否则，在应用字段/标记的日期之前，报表不会注册这些字段/标记。
• 若要支持 需求跟踪，请定义测试用例，并创建从每个测试用例到用户情景、产品积压工作项或要求的“ 测试依据 ”链接。 定义测试用例并使用“测试方”链接将测试用例链接到其父 PBI。 请参阅创建测试。
• (建议) 若要支持报表中的筛选和分组，请将 “区域路径 ”和“ 迭代路径 ”分配给所有工作项。 有关如何定义迭代和区域路径的信息，请参阅 定义区域路径并分配给团队 或 定义迭代路径 (冲刺) 和配置团队迭代。

注意

添加到工作项类型的所有自定义字段都可用于报表。 自定义字段标有 Custom_DisplayNameOfField，其中所有空格都已从显示名称中删除。

测试计划

若要查看测试计划进度和测试用例就绪情况，团队需要执行以下活动。

• 定义测试用例、测试计划和测试套件，并指定其当前状态。 若要了解详细信息，请参阅 创建测试计划和测试套件 和 创建测试用例。
• 更新测试对象从“设计”到“就绪”到“已关闭”的状态。
• 对于手动测试，将测试用例中每个验证步骤的结果标记为通过或未通过。

  提示

  如果某个测试步骤是验证测试步骤，则测试人员必须使用某个状态对该步骤进行标记。 测试的总体结果反映已标记的所有测试步骤的状态。 因此，如果有任何测试步骤标记为未通过或未标记，则测试的状态为未通过。

• 对于自动测试，每个测试都会自动标记为通过或未通过。
• (建议) 若要支持在报表中进行筛选和分组，请为测试用例、测试套件和测试计划分配 区域路径 和 迭代路径 。

管道

若要报告管道，团队需要使用 YAML 定义管道并定期运行管道。 若要了解详细信息，请参阅 新 Azure Pipelines 用户的关键概念。

此外，请考虑以下操作：

• 考虑要报告哪些数据，并选择正确的实体集。 有关要查询的可用实体集的查看，请参阅 Azure Pipelines Analytics 的元数据参考。
• 考虑要报告哪些管道以及报表的日期范围。 你需要筛选数据，以便满足 查询最佳做法 并最大程度地减少任何性能问题。

管道和测试

若要报告管道和测试结果，请确保将测试任务添加到管道定义。 若要了解详细信息，请参阅 生成和发布 tasks-Test。

如果刚刚开始，请考虑查看此 Learn 模块， 即使用 Azure Pipelines 在生成管道中运行质量测试。

相关文章

• 什么是 Analytics 服务？
• Azure DevOps 的默认权限快速参考
• 查询 Analytics 服务时要使用的最佳做法