连接到 Jira 数据源 - Amazon Managed Grafana
已知限制条件添加数据源查询 Jira 数据源时间序列查询模板和变量使用 Grafana 中的转换来回答常见问题充分利用数据源

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

连接到 Jira 数据源

将来自 Jira 的事务数据与其他来源的应用程序性能数据相结合，全面了解您的开发流程。

注意

此数据源仅适用于 Grafana 企业版。有关更多信息，请参阅 管理对企业插件的访问权限。

此外，在支持版本 9 或更高版本的工作空间中，此数据源可能需要您安装相应的插件。有关更多信息，请参阅 使用插件扩展您的工作空间。

  • 根据问题创建或解决情况创建注释，以查看问题和指标之间的关系。

  • 跟踪详细的 Jira 统计数据，例如平均解决时间和问题吞吐量。

要使用 Jira 数据源，您需要一个有权访问 Jira 项目的 Atlassian 帐户。

已知限制条件

可能不支持 Jira 插件中的自定义字段类型。

添加数据源

  1. 在亚马逊托管 Grafana 工作区中打开 Grafana 控制台，并确保您已登录。

  2. 在 “配置”（齿轮图标）下的侧面菜单中，选择 “数据源”。

  3. 选择添加数据来源。

    注意

    如果您在侧面菜单中看不到数据源链接，则表示您当前的用户没有该Admin角色。

  4. 从数据源列表中选择 Jira。

  5. 输入以下信息：

    • 在名称中，输入此 Jira 数据源的名称。

    • 对于网址，请输入您的 Atlassian 实例的根网址，例如。https://bletchleypark.atlassian.net

    • 对于 “用户”，输入用户/服务帐户的电子邮件地址。

    • 对于 API 令牌，请输入为用户生成的 API 令牌。

查询 Jira 数据源

在 Jira 查询编辑器中，您可以选择字段并查询问题。

Jira 数据源向 Jira 查询问题，这些问题可以代表 Jira 中的错误、用户故事、支持工单或其他任务

筛选和查看问题

  1. 选择 “字段”，选择下拉列表，然后使用预键从 Jira 实例中的任何字段（包括自定义字段）中进行选择。一些值得尝试的领域：

    • 摘要-问题名称

    • Epic Name — 一期所属的剧集

    • 故事点估计 — 团队为某个问题估算的故事点数

  2. 对问题进行筛选或排序。为此，请输入任何有效的 JQL 表达式，根据议题的任何字段（例如 Proj ec t、Assignee 或 Sprint）对 Atlassian 查询语言 JQL 进行筛选或排序。

从这里，您可以将数据显示在表中，也可以使用 Grafana 变换来操作问题数据、运行计算或将数据转换为时间序列图。有关更多信息，请参阅 应用转换。

时间序列查询

要显示时间序列数据，请选择日期字段和数值字段，然后切换到图表可视化。例如：Sprint 开始日期、故事积分估计。

前面的例子本身并不是很有用。数值字段可以（而且很可能）通过变换计算。使用 Group By Transformation 可以按照 Sprint 开始日期进行分组并汇总故事积分估计值，从而可视化每个 Sprint 一段时间内的故事积分。有关转换的更多信息，请参阅 应用转换。

模板和变量

要添加新的 Jira 查询变量，请参阅添加查询变量。使用您的 Jira 数据源作为数据源。

您可以在仪表板上定义变量并在 JQL 表达式中引用它们。例如，您可以创建项目状态仪表板并在项目之间进行选择，或者创建长篇故事状态仪表板并选择不同的长篇故事，或者创建任务状态仪表板并选择不同的受托人。

要获取项目、长篇故事、受托人等的动态列表供您选择，请创建一个 Query 类型变量。查询类型变量使用 JQL 来查询议题并返回项目、长篇故事、受托人或任何与议题相关的内容。以下是 示例：

创建 Assignee 变量以按受托人获取事务状态

  1. 添加名为 Query 类型的变量assignee。

  2. 选择字段：受托人。

  3. ) 可选) 添加 JQL 筛选器项目 = “您的项目”。

  4. 选择 “运行” 以查看任务接受者列表。

  5. 选择 “更新” 将变量添加到控制面板。

  6. 向仪表板添加一个新面板，然后编辑 JQL 以使用您的新变量 assignee = $ass ignee 进行筛选。

    现在，从下拉列表中进行选择时，您只能看到分配给该用户的问题。

多值变量允许选择多个选项，可用作 IN 子句的一部分。例如，受让人 IN（$assig nee）。

使用 Grafana 中的转换来回答常见问题

宏是引用仪表板时间窗口的变量，因此您只能在控制板窗口的范围内筛选问题。有 2 个宏：

  • $__timeFrom

  • $__timeTo。

以下示例 JQL 查询筛选了在仪表板时间窗口内创建的问题：createdDate >= $__timeFrom AND createdDate <= $__timeTo

充分利用数据源

使用 Grafana 的转换和其他内置功能可以帮助您有意义地查看 Jira 数据。

使用转换来增强 JQL

虽然 Grafana 中有许多转换可供选择，但以下内容提供了一个强大的增强功能，让 JQL 具有 SQL 的一些功能/力量。

分组依据此转换提供了一项不属于标准 Jira JQL 语法的关键功能：分组。使用 G roup By 转换，您可以按冲刺或其他议题字段进行分组，并按组进行聚合，以获得诸如速度和故事点估计值与Sprint中实际完成情况的对比等指标。

O@@ uter Join 与 SQL 联接类似，您可以通过公共字段将 2 个或多个查询连接在一起。这提供了一种合并来自查询的数据集并使用其他转换来计算来自多个查询/数据集的值的方法。

从计算中添加字段与 SQL 表达式类似，此转换允许根据其他字段的计算向数据集中添加新字段。计算中使用的字段可以来自单个查询，也可以来自您连接在一起的查询。您也可以将计算链接在一起，并通过计算字段执行计算。

使用 Grafana 中的转换来回答常见问题

您可以使用 Transformations 对数据集进行可视化、聚合、分组和联接，还可以使用许多其他类型的转换将简单的结果转换为复杂问题的答案。

如何显示每次冲刺的速度？

  1. 选择字段：Sprint 名称、故事积分估计。

  2. 添加 JQL 过滤器：project = "Your Project" AND type != epic AND status = done order by created ASC

  3. 添加分组依据转换：

    • Sprint 名称 | 分组依据

    • 故事积分估计 | 计算 | 总计

  4. 选择条形仪可视化。

如何显示 Sprint 中已完成的与预计的内容？

  1. 添加查询。首先，选择字段：Sprint 名称、Sprint 开始日期、、故事积分估计。

    然后添加一个 JQL 过滤器：project = 'Your Project' AND type != epic

  2. 添加第二个查询。首先，选择字段：Sprint 名称、Sprint 开始日期、、故事积分估计。

    然后添加一个 JQL 过滤器：project = 'Your Project' AND type != epic AND status = done

  3. 添加分组依据转换：

    • Sprint 名称 | 分组依据

    • Sprint 开始日期 | 分组依据

    • 故事积分估计 | 计算 | 总计

  4. 选择图表可视化。

我的项目中完成问题的平均时间是多少？

  1. 添加查询。首先，选择字段：已创建、状态类别已更改。

    然后添加一个 JQL 过滤器：project = 'Your Project' AND type != epic AND status = done

  2. 添加转换：从计算中添加字段

    • 模式 = 减少行

    • 计算 = 差异

  3. 添加转换：从计算中添加字段

    • 模式 = 二进制运算

    • 操作 = 差异/86000000

    • 别名 = 天数

  4. 添加转换：整理字段

    • 隐藏其他字段

  5. 添加转换：按值筛选数据

    • 过滤器类型 = 包含

    • 条件 = 匹配任意条件

      • 字段 = 天数 | 匹配 = 大于 | 值 = 1

  6. 添加转换：减少

    • 模式 = 序列到行

    • 计算 = 平均值

  7. 选择统计可视化。