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

# 连接到 Jira 数据来源
<a name="jira-AMG-datasource"></a>

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

**注意**  
此数据来源仅适用于 Grafana Enterprise。有关更多信息，请参阅 [管理对 Enterprise 插件的访问](upgrade-to-enterprise-plugins.md)。  
此外，在支持版本 9 或更高版本的工作区中，此数据来源可能需要您安装相应的插件。有关更多信息，请参阅 [使用插件扩展您的工作区](grafana-plugins.md)。
+ 根据问题创建或解决方案创建注释，以查看问题和指标之间的关系。
+ 跟踪详细的 Jira 统计数据，例如平均解决时间和问题吞吐量。

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

## 已知限制条件
<a name="jira-known-limitations"></a>

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

## 添加数据来源
<a name="jira-adding-the-data-source"></a>

1.  在 Amazon Managed Grafana 工作区中打开 Grafana 控制台，并确保您已登录。

1.  在**配置**（齿轮图标）下的侧边菜单中，选择**数据来源**。

1.  选择**添加数据来源**。
**注意**  
 如果您在侧边菜单中看不到**数据来源**链接，则表示您当前的用户没有 `Admin` 角色。

1.  从数据来源列表中选择 **Jira**。

1. 输入以下信息：
   + 对于**名称**，请输入此 Jira 数据来源的名称。
   + 对于 **URL**，请输入您的 Atlassian 实例的根 URL，例如 **https://bletchleypark.atlassian.net**。
   + 对于 “**用户**”，输入 user/service 账户的电子邮件地址。
   + 对于 **API 令牌**，请输入为用户生成的 API 令牌。

## 查询 Jira 数据来源
<a name="jira-query"></a>

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

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

**筛选和查看问题**

1.  选择**字段**，选择下拉列表，然后使用预键入从 Jira 实例中的任何字段（包括自定义字段）中进行选择。一些值得尝试的字段：
   + **摘要**：问题名称
   + **长篇故事名称**：问题所属的长篇故事
   + **故事点估计**：团队为某个问题估算的故事点数量

1.  对问题进行筛选或排序。为此，请输入任何有效的 JQL 表达式，根据问题的任何字段（例如**项目**、**任务接收者**或**冲刺**）对 Atlassian 查询语言 JQL 的问题进行筛选或排序。

从这里，您可以将数据显示在表中，也可以使用 Grafana 转换来操作问题数据、运行计算或将数据转换为时间序列图。有关更多信息，请参阅 [应用转换](panel-transformations.md#apply-a-transformation)。

## 时间序列查询
<a name="jira-timeseries-query"></a>

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

前面的例子本身并不是很有用。数值字段可以（而且很可能）通过转换计算。使用**分组依据**转换可以按照**冲刺开始日期**进行分组并汇总**故事点估计值**，从而可视化每个冲刺一段时间内的故事点数。有关转换的更多信息，请参阅 [应用转换](panel-transformations.md#apply-a-transformation)。

## 模板和变量
<a name="jira-templates"></a>

要添加新的 Jira 查询变量，请参阅 [添加查询变量](variables-types.md#add-a-query-variable)。使用您的 Jira 数据来源作为数据来源。

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

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

**创建 Assignee 变量以按分配人获取问题状态**

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

1.  选择**字段：Assignee**。

1.  （可选）添加 JQL 筛选器 **project = 'your project'**。

1.  选择**运行**以查看任务接收者列表。

1. 选择**更新**将变量添加到控制面板。

1. 向控制面板添加一个新面板，然后编辑 JQL 以使用您的新变量 **assignee = \$1assignee** 进行筛选。

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

多值变量允许选择多个选项，可用作 IN 子句的一部分。例如，**assignee IN (\$1assignee)**。

## 使用 Grafana 中的转换来回答常见问题
<a name="jira-macros"></a>

宏是引用控制面板时间窗口的变量，因此您只能在控制面板窗口的范围内筛选问题。有 2 个宏：
+ **\$1\$1\$1timeFrom**
+ **\$1\$1\$1timeTo.**

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

## 充分利用数据来源
<a name="jira-getmost"></a>

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

### 使用转换来增强 JQL
<a name="gitlab-transformations-JQL"></a>

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

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

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

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

### 使用 Grafana 中的转换来回答常见问题
<a name="gitlab-transformations-common"></a>

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

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

1.  选择字段：**冲刺名称**、**故事点估计**。

1.  添加 JQL 筛选器：`project = "Your Project" AND type != epic AND status = done order by created ASC`

1.  添加**分组依据**转换：
   + 冲刺名称 \$1 分组依据
   + 故事点估计 \$1 计算 \$1 总计

1. 选择**条形仪**可视化。

**如何显示冲刺中已完成内容与估计的内容？**

1.  添加查询。首先，选择字段：**冲刺名称**、**冲刺开始日期、**、**故事点估计**。

   然后添加一个 JQL 筛选器：`project = 'Your Project' AND type != epic`

1.  添加第二个查询。首先，选择字段：**冲刺名称**、**冲刺开始日期、**、**故事点估计**。

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

1.  添加**分组依据**转换：
   + 冲刺名称 \$1 分组依据
   + 冲刺开始日期 \$1 分组依据
   + 故事点估计 \$1 计算 \$1 总计

1. 选择**图形**可视化。

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

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

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

1.  添加转换：**从计算中添加字段**
   + 模式 = 减少行
   + 计算 = 差异

1.  添加转换：**从计算中添加字段**
   + 模式 = 二进制运算
   + 运算 = 差异 / 86000000
   + 别名 = 天数

1.  添加转换：**整理字段**
   + 隐藏其他字段

1.  添加转换：**按值筛选数据**
   + 筛选器类型 = 包含
   + 条件 = 任意匹配
     + 字段 = 天数 \$1 匹配 = 大于 \$1 值 = 1

1.  添加转换：**减少**
   + 模式 = 序列到行
   + 计算 = 均值

1. 选择**统计**可视化。