在 Azure DevOps 中访问 Analytics 的权限和先决条件
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
若要使用 Analytics 并创建报表，必须满足以下几个先决条件，如本文所述。
默认情况下，所有项目成员都有权访问他们属于的项目的分析数据，包括添加到项目 “读取者 ”组的成员。 具有 利益干系人 访问权限的用户无权查看或编辑 Analytics 视图。
服务和功能启用
一般情况下，Analytics 始终处于打开状态，可供组织或集合的成员查看数据和创建报表。
分析服务
对于 Azure DevOps Services，分析始终处于开启。 无法禁用或暂停它。
对于 Azure DevOps Server 2020 及更高版本的本地版本，Analytics 会自动随你创建的每个项目集合一起安装。
对于 Azure DevOps Server 2019，必须先在创建的每个项目集合上安装 Analytics。
可以暂停并重启服务。 暂停时，不会向 Analytics 添加新数据。
有关详细信息，请参阅 安装或启用 Analytics 服务。
Azure DevOps 服务
若要练习任何 Azure DevOps 服务，必须启用该服务。 对于已禁用的服务，无法捕获任何数据。 可按项目启用或禁用服务。
若要验证是否启用了所有服务，请参阅 “打开或关闭服务”。
Analytics 视图
分析视图（Web 门户中的中心）提供了一种简化的方法，用于根据 Analytics 数据指定 Power BI 报表的筛选条件。 有关详细信息，请参阅什么是 Analytics 服务？
若要访问 Analytics 视图，必须启用它。 项目集合管理员组组织所有者或成员可以为组织中的每个人启用它。 或者，每个项目成员都可以自行启用它。
若要了解如何操作，请参阅 管理或启用功能。
权限
在项目级别为服务设置权限，并在对象级别为共享分析视图设置权限。
下表汇总了可设置的权限，以及对项目安全组进行的默认分配。
| 权限 | Readers | 作者 | 项目管理员 |
|---|---|---|---|
| 查看分析 | ✔ | ✔ | ✔ |
| 查看共享分析视图 | ✔ | ✔ | |
| 添加专用或共享分析视图 | ✔ | ✔ | |
| 编辑和删除共享分析视图 | ✔ |
数据跟踪先决条件
若要捕获有意义的数据，软件团队必须执行有意义的操作。 以下部分根据要报告的数据类型提供一般建议。
注意
Analytics v3.0 预览 版和更高版本支持分支、管道和测试实体集。 使用 Analytics v4.0-preview 版本添加了支持管道作业、任务代理请求和任务代理池大小的快照实体集。 请确保指定支持相关实体集的分析版本。
若要了解可以筛选或分组依据的属性和枚举列表值， 请浏览相应实体类型的 Analytics 元数据 。
Azure Boards 和工作跟踪
有关可查询的可用实体集的评审，请参阅 Azure Boards Analytics 的元数据参考。
若要报告工作跟踪，团队需要执行多个任务，以确保有意义的数据可用。 在定义 Analytics 查询和报表之前，请查看以下任务。
- 若要报告活动 bug 或 bug 趋势，请定义 bug 并更新 bug 状态 ，因为它已修复、验证，然后关闭。
- 若要报告积压工作或其他工作项类型，请确保定义这些工作项，并在其从新移动到关闭状态时更新其 状态 。 请考虑用于筛选或对报表中的数据进行分组的任何字段或标记，并确保数据定义明确且一致。
- 若要支持汇总报表，请确保产品积压工作项与任务/bug 之间存在父子链接，或者功能或项目组合积压工作项与其子项之间存在父子链接。 有关详细信息，请参阅 组织积压工作并将子工作项映射到父级。
- 若要创建烧毁或烧毁报表（如 Sprint 烧毁 或 发布进度），请确保已了解如何筛选和对报表中的数据进行分组。 烧毁/烧毁报告引用
WorkItemsSnapshot实体集。 快照实体集建模为每日快照。 数据是根据分配的日期进行的分配聚合的。 这意味着，若要根据字段或标记分配筛选烧毁/烧毁报告，必须在要报告的时间段之前分配字段或标记。 否则，在应用字段/标记的日期之前，报表不会注册这些字段/标记。 - 若要支持 要求跟踪，请定义测试用例，并创建 从每个测试用例到用户情景、产品积压工作项或要求的测试依据 链接。 使用“测试依据”链接定义测试用例并将测试用例链接到其父 PBIs。 请参阅“创建测试”。
- （推荐）若要支持在报表中进行筛选和分组，请将区域路径和迭代路径分配给所有工作项。 有关如何定义迭代和区域路径的信息，请参阅 定义区域路径并分配给团队 或 定义迭代路径（冲刺），并配置团队迭代。
注意
添加到工作项类型的所有自定义字段都可用于报表。 自定义字段标有 Custom_DisplayNameOfField，其中所有空格都已从显示名称中删除。
测试计划
若要查看测试计划进度和测试用例准备情况，团队需要执行以下活动。
- 定义测试用例、测试计划和测试套件，并指定其当前状态。 有关详细信息，请参阅 创建测试计划和测试套件 以及 创建测试用例。
- 将测试对象的状态从“设计”更新为“就绪”到“已关闭”。
- 对于手动测试，请将测试用例中每个验证步骤的结果标记为已通过或失败。
提示
测试人员必须标记状态为验证测试步骤的测试步骤。 测试的总体结果反映已标记的所有测试步骤的状态。 因此，如果任何测试步骤标记为失败或未标记，则测试将状态为失败。
- 对于自动测试，每个测试都自动标记为已通过或失败。
- （推荐）若要支持在报表中进行筛选和分组，请将区域路径和迭代路径分配给测试用例、测试套件和测试计划。
管道
若要报告管道，团队需要使用 YAML 定义管道并定期运行管道。 有关详细信息，请参阅 新 Azure Pipelines 用户的关键概念。
此外，请考虑以下操作：
- 考虑要报告哪些数据并选择正确的实体集。 有关要查询的可用实体集的评审，请参阅 Azure Pipelines Analytics 的元数据参考。
- 考虑要报告哪些管道以及报表的日期范围。 你需要筛选数据，以便满足 查询最佳做法 并最大程度地减少任何性能问题。
管道和测试
若要报告管道和测试结果，请确保向管道定义添加测试任务。 有关详细信息，请参阅 生成和发布任务测试。
如果刚开始，请考虑查看此 Learn 模块， 使用 Azure Pipelines 在生成管道中运行质量测试。