JIRA Grafana数据源

得到您的开发过程的整体结合问题JIRA的数据应用程序性能来自其他来源的数据。

• 基于问题创建注释创建或分辨率,看到问题和指标之间的关系
• 追踪详细Jira统计,平均解决时间和吞吐量问题

下面的说明假设您正在配置本地JIRA数据源。查看视频云配置,请参阅可视化JIRA Grafana云。

需求

这个插件有以下要求:

• Atlassian账户访问JIRA项目
• 以下账户类型之一:
  • Grafana云:专业客户,先进的客户,与企业或专业试验用户启用插件插件
  • Grafana企业:客户提供的激活许可证和一个用户与Grafana服务器或组织管理权限
• 企业启用插件插件

已知的限制

自定义字段类型从JIRA插件可能不支持。

插件安装JIRA数据源

安装的数据源,请参考安装

配置JIRA Atlassian API密匙

按照下列指示来创建一个API令牌:Atlassian管理API的令牌

配置数据源

遵循这些指令添加一个新JIRA数据源,并选择从三个数据源配置选项:

字段	描述
提供者	选择JIRA云如果你JIRA Atlassian主机在云上。如果你选择JIRA服务器JIRA被托管在别处。
的名字	对于这个特定的JIRA数据源输入一个名称。
URL	输入Atlassian根URL,例如https://bletchleypark.atlassian.net
用户	为用户输入一个电子邮件地址/服务帐户,例如joan.clarke@bletchleypark.com
API的令牌	为用户输入一个API生成令牌。

配置数据源的配置

数据源可以配置Grafana的供应系统。你可以阅读更多关于它是如何工作的和所有的设置可以设置数据源配置文档页面

apiVersion: 1数据源:名称:Jira类型:grafana-jira-datasource访问:代理basicAuth:假可编辑:真正启用:真正的jsonData: url: Atlassian实例用户根url:电子邮件地址的用户托管:服务器或云secureJsonData:令牌:API令牌

查询的数据源

从JIRA查询编辑器可以选择字段和查询问题。

过滤器和查看问题

JIRA JIRA数据源查询问题可以表示错误,用户故事,JIRA支持门票,或其他任务。首先选择一个你想好视野,然后使用JQL过滤和/或你的问题。

1. 选择字段

单击下拉预选择的任何字段并使用JIRA实例,包括定制字段。某些领域尝试:

• 总结:问题的名称

• 史诗般的名字:一个问题属于的史诗

• 故事点估计:故事点团队的人数估计为一个问题

1. 过滤和/或排序问题

输入任何有效JQL表达式过滤和/或你的问题基于排序的项目、受让人,或与Atlassian查询语言JQL冲刺。有关更多信息,请参考搜索与JQL JIRA像一个老板。

从这里,你可以显示你的数据表中,或者使用Grafana问题数据的转换操作,运行计算,或把数据变成一个时间序列图。有关更多信息,请参考应用转换

时间序列查询

显示时间序列数据,选择一个日期字段以及一个数字字段,然后切换到图形可视化。

例如:Sprint开始日期,故事点估计

上面的例子中,就其本身而言,不是很有用。数值字段可以(很可能)计算转换。

使用集团转换将允许分组Sprint开始日期和总结的故事点估计允许每个Sprint故事点的可视化。了解更多关于转换在这里

模板和变量

添加一个新的JIRA查询变量,请参考添加一个查询变量。使用JIRA数据源作为数据源

你可以定义变量仪表盘和JQL表达式中引用它们。

例如,您可以创建一个项目状态指示板和选择项目,或者一个状态指示板和选择不同的史诗,史诗或任务状态指示板和选择不同的受让人。

得到的动态列表项目,史诗,权利人,等可供选择,创建一个查询类型变量。查询类型变量使用JQL查询问题和返回项目,史诗、受托人或任何相关问题。

例子:创建一个受让人变量被受让人的地位问题。

1. 添加一个变量类型的查询受让人
2. 选择字段:受让人
3. 添加JQL过滤器(可选):项目= '您的项目'。
4. 单击Run按钮底部的受托人。
5. 单击更新变量添加到仪表板。
6. 添加下拉显示在仪表板的受托人。
7. 面板添加到仪表板,编辑JQL过滤使用你的新变量受让人= $受让人。
8. 现在选择从下拉时,你只看到分配给该用户的问题。

允许选择多个选项,可以使用多值变量的一部分在条款。受让人(受让人)

在创建一个变量可以使用它在你通过使用JIRA查询这个语法。

参考有关变量的更多信息这。

进口JIRA的仪表板

遵循这些指令导入一个仪表板。

进口的仪表板可以在配置>数据源>选择JIRA数据源>选择仪表板选项卡可用预先做好的仪表板。

宏

宏变量参考仪表板时间窗口范围内的所以你只能过滤问题的仪表板的窗口。

有两个宏:__timeFrom美元和__timeTo美元。

例如:JQL仪表板时间窗口中创建过滤问题。

createdDate > = __timeFrom和createdDate < = __timeTo美元

得到最多的插件

利用Grafana的转换和其他功能可以帮助你故意地把JIRA数据。

转换增加JQL

虽然有许多转换Grafana可供选择,以下提供一个强大的增强给JQL / SQL的力量的一些特性。更多信息参考类型的转换这。

集团这种转变提供了一个关键特性,并非标准JIRA JQL语法的一部分:分组。使用Group By转换,可以小组由Sprint或其他问题领域,并由集团总指标如速度和故事点估计与实际完成Sprint。

外连接类似于SQL连接,你可以加入2个或更多的查询由共同的领域。这提供了一种组合查询的数据从多个查询和使用其他转换计算值/数据集。

从计算添加字段类似于SQL表达式,该转换允许添加新的字段其他领域的数据集的基础上计算。计算中使用的字段可以来自一个查询或查询你已经连接在一起。你也可以计算和执行计算,从计算字段链接在一起。

使用转换从Grafana回答常见问题

现在,您可以执行基本的JIRA查询找到问题,您可以使用转换可视化、聚合、集团和连接数据集,以及许多其他类型的转换将简单的结果为复杂问题的答案。

问题:我如何显示每冲刺速度?

1. 选择字段:Sprint的名字,故事点估计
2. 添加JQL过滤器项目= "项目"和类型! =史诗和状态=命令创建了ASC完成
3. 添加组的转换
   • Sprint名称|组
   • 故事点估计| |计算总数
4. 选择杆规可视化

问题:我如何显示完成vs估计在一个Sprint是什么?

1. 添加一个查询
   • 选择字段:Sprint的名字,Sprint开始日期,故事点估计
   • 添加JQL过滤器:项目=‘项目’和类型! =史诗
2. 添加第二个查询
   • 选择字段:Sprint的名字,Sprint开始日期,故事点估计
   • 添加JQL过滤器:项目=‘项目’和类型! = =完成史诗和状态
3. 添加组的转换
   • Sprint名称|组
   • Sprint开始日期|集团
   • 故事点估计| |计算总数
4. 选择图形可视化

问题:什么是平均时间完成问题在我的项目吗?

1. 添加一个查询
   • 选择字段:创建、身份类别改变
   • 添加JQL过滤器:项目=‘项目’和类型! = =完成史诗和状态
2. 添加转换:从计算添加字段
   • 模式=减少行
   • 计算=区别
3. 添加转换:从计算添加字段
   • 模式=二元运算
   • 操作=差/ 86000000(1000 * 3600 * 24天
   • 别名=天
4. 添加转换:组织领域
   • 隐藏不同领域
5. 添加转换:过滤数据的值
   • 过滤器类型=包括
   • =匹配任何条件
     • 字段=天|匹配= |大值= 1
6. 添加转换:减少
   • 行模式=系列
   • 计算=意味着
7. 选择可视化:统计

额外的链接

• 添加注释
• 配置和使用模板变量
• 添加转换
• 设置报警