JIRA集成

JIRA是Atlassian公司出品的项目与事务跟踪工具，被广泛应用于缺陷跟踪、客户服务、需求收集、流程审批、任务跟踪、项目跟踪和敏捷管理等工作领域。JIRA中配置灵活、功能全面、部署简单、扩展丰富，其超过150项特性得到了全球115个国家超过19,000家客户的认可。

---

JIRA集成CA步骤

1. 创建应用

   进入CA中后，点击集成，创建【JIRA】应用，保存并获取AppKey

   

2. 在JIRA中配置告警第三方集成

   JIRA 6.3.6

   1. 登录JIRA账号，点击右上角的管理图标->选择系统->网络钩子->创建webhook

   

   

   

   1. 在下图位置中填写 名称 URL 中输入wehhook地址

      http://api.aiops.com/alert/api/event/jira/  获取的appKey 
      

      勾选 lssure Created lssure Deleted lssure Updated

   

   JIRA 8.13.2

   1. 登录JIRA账号，点击右上角的管理图标->选择系统->webhook->创建网络钩子

   

   1. 在下图位置中填写 名称 状态开启 URL 中输入wehhook地址

      http://api.aiops.com/alert/api/event/jira/  获取的appKey 
      

      勾选 已创建 已更新 工作日志修改 后点击创建即可

   2. JIRA云服务对接CA的webhook地址是https的格式，例如：

      https://caweb.aiops.com/alert/api/event/jira/{appKey}
      

      

测试JIRA告警

在jira中创建一个故障或是缺陷类型的问题，填写相关信息后，点击【创建】即可。登录CA平台查看告警-所有告警，是否有对应的告警信息。如果有则说明对接成功；如果没有请联系睿小象进行排查。

告警对应级别

JIRA级别	CA告警级别
Highest High	严重
Medium	警告
Low Lowest	提醒
其他	提醒

Cloud Alert 对接 JIRA

1. 对接jira software和jira service desk：

   进入CA点击配置-JIRA配置，输入 JIRA地址 用户账号 密码 ，点击保存-同步项目

   

2. 对接云jira：

   1. 登录https://www.atlassian.com/ 申请账户

   2. 开通一个jira software,在开通时保存你的atlassian站点地址

      

   3. 将这个地址填入：类似https://gaoyining.atlassian.net/

      4. 其中用户账号，为创建网站时的账户。

   密码需要经过https://id.atlassian.com/manage-profile/security/api-tokens网站获取api-token

   使用账户登录此网站，点击创建API令牌，输入label,创建一个，点击复制，复制到密码栏

   

   到此配置完成。

   注意，jira cloud 中的项目想要同步，必须在ca中填写的用户信息是网站拥有者的账户，否则只能同步账户信息所有用项目权限的项目。

3. 以上设置完毕后，CloudAlert产生告警后，对应生成jira问题，本系统提供2种方式：

   1. 主告警发生时，自动触发生成一个对应的jira问题。【集成-创建某个应用时（非JIRA应用），可以选择开启自动创建jira问题开关】

   2. 在告警发生后，可针对未关闭的告警手动触发生成一个jira问题

   

注意事项

1. 保证jira可以通过外网访问

2. 用户需要在jira创建一个用户，并把此用户的账号密码，在CA中做个配置。一个团队共用一个JIRA账号

3. 此JIRA用户，可以在jira中创建多个项目，此处可以做项目信息同步，用户在生成JIRA问题时，可以生成选择对应项目信息。

4. CloudAlert中的告警生成的jira问题都为故障|缺陷类型，优先级与告警级别对应。

5. CloudAlert中的告警状态变更，不会影响jira的状态变化，但是jira上问题的状态变化会同步更新CloudAlert中的告警状态

6. 人员的同步信息以邮件地址为准，所以在使用此功能之前请保证jira中的相关处理与CloudAlert中用户邮件地址保持一致

7. 同步项目时，如果提示"无法同步项目，JIRA账号权限不足"则需要首先验证用户名密码是否正确。

Cloud Alert 与 JIRA对应关系

1. 告警标题：jira的标题

2. 告警内容：描述+影响版本：XX；附件：X个；备注：XXXX

示例：XXXXXXXXXXXX。影响版本：202103；附件：无；备注：无。

示例：XXXXXXXXXXXX。影响版本：无；附件：3；备注：XXXXX。

ps：没有就写无

1. 级别：优先级

2. 告警对象：JIRA+项目名+类型

3. 示例：JIRAaiops2020CA缺陷

当jira有变更时，包含以上内容【标题，描述，备注，类型，级别，人】都需要对应更新告警的相关信息，同时更新一下alarm的更新时间和告警发生次数。

每一次更新都需要做通知【支持短信和电话通知】

通知内容为：告警编号：XXXX；告警标题：XXXXX 在2020年11月21日 16:05发生变更，变更内容：名称变更为XXXX，描述变更为XXXX，备注变更为，附件发生变更。级别变更为XXXX，类型变更为XXX。

1. jira -> CA

   创建JIRA到CA生成告警的类型有：事件，问题，故障，新增功能，新功能，改进。

2. CA->JIRA

   CA手动生成告警，主要类型有：

   故障,缺陷,新增功能,新功能,改进,问题,事件,更改,Bug,Incident,Problem,Improvement,

   Change,Submit a request or incident,[System] Incident,[System] Problem

3. 兼容云JIRA类型

   JIRA software 的模板类型：缺陷跟踪、看板、Scrum

   

   JIRA Service-Management的模板类型：IT服务管理、外部服务项目、一般服务项目