应用实时监控服务ARMS：通过Jira账号信息集成Jira工单系统

在ARMS告警管理中集成Jira

1. 登录ARMS控制台，在左侧导航栏选择告警管理 > 集成。

2. 在集成页面单击通知集成页签，然后单击JIRA。

3. 在添加集成配置向导页面，进行以下配置：

   1. 在基本信息向导页输入集成名称、Jira的地址URL，选择验证方式为JIRA账号登录，并输入Jira的用户名和密码，根据需要添加集成描述，然后单击测试连接。

   2. 页面显示连接成功后，单击下一步。

      说明

      若连接失败，则表示配置的Jira的地址、用户名或密码有误，请修改后重新单击测试连接验证。

   3. 在告警源配置向导页通过以下参数配置告警同步信息，然后单击保存。

      参数	说明	示例
      问题所属项目	告警产生时同步到的Jira项目。	监管控一体化项目
      类型	告警对应的Jira问题类型。 任务 子任务 改进 新功能 故障 Epic 故事	故障
      告警关闭时，问题的状态	Jira问题关闭时的状态。当Jira问题处于设置的状态时，Jira问题将会被认定为关闭，问题对应的告警操作将不再同步到该问题上。Jira问题状态选项： 待办 处理中 正评审 完成 说明 建议选择Jira问题关闭时的状态为完成。如果选择其他状态，当问题状态变更为完成时，告警操作仍会同步至Jira对应的问题中。	完成
      优先级	告警等级与Jira中问题优先级的映射关系。 重要 如果某个告警等级没有配置与Jira的优先级的映射关系，那么该等级的告警将不会同步到Jira中。 告警首次被推送到Jira中时将会根据映射关系同步告警等级。同步后，在ARMS告警管理只修改告警等级将不会推送到Jira的问题中。	P1：Hightest P2：High P3：Medium P4：Low P5：Lowest

   配置完成后，在通知集成页签可以查看已创建的Jira集成。

将告警推送至Jira中

配置完Jira集成后，可以通过以下3种方式将告警推送到Jira中。

方式一

设置通知策略，使告警产生时同步在Jira中创建问题。

1. 在控制台左侧导航栏选择告警管理 > 通知策略。

2. 在通知策略页面单击新建通知策略或者编辑已有的通知策略。

3. 在编辑通知策略页面的当告警生成时区域，选择的通知人/排班至少包含联系人或联系人组。

   重要

   • Jira会在系统中查询与通知策略中识别到的第一个联系人拥有相同邮箱或姓名（用户名）的用户，该Jira用户将会被设置为问题经办人。

   • 如果通知策略识别到的第一个通知人在Jira中没有对应的用户，那么告警将无法同步至Jira中。

4. 选择工单系统为已创建的Jira集成。根据需求设置其他参数，具体操作，请参见通知策略。

5. 设置完成后单击保存。

   配置完成后，匹配到该通知策略的告警将会推送到Jira中。

方式二

在告警发送历史页面将已产生的告警推送至Jira中，并在Jira中生成对应问题。

1. 在控制台左侧导航栏选择告警管理 > 告警发送历史。

2. 在告警发送历史页面右上角关联操作人（作为Jira问题中的经办人），然后单击目标告警名称。

   重要

   • Jira会在系统中查询与联系人拥有相同邮箱或姓名（用户名）的用户，该Jira用户将会被设置为问题经办人。

   • 如果操作人在Jira中无对应的用户，那么告警将无法同步至Jira中。

3. 在告警详情页面右上角单击图标，然后单击推送告警。

4. 在弹出的对话框中，选择工单系统为已创建的Jira集成，然后单击确认。

   推送成功后，可在告警详情页面看到告警对应的Jira问题的链接。

方式三

已产生告警并在钉钉群中收到告警卡片后，在钉钉群的告警卡片中将告警推送至Jira中，并在Jira中生成对应问题。

• 在钉钉群收到的告警卡片中，单击推送告警，然后选择已创建的Jira集成。

• 在告警卡片中单击目标告警名称，在告警详情面板单击设置，然后单击推送工单，并选择已创建的Jira集成。

推送成功后，可在告警详情页面看到告警对应的Jira问题的链接。

支持同步的告警操作

完成以上步骤后，在ARMS告警管理中对告警的以下操作将会同步至Jira工单系统中。

在告警发送历史页面的操作：

• 认领告警：同步更新Jira问题中的经办人。

  说明

  认领人必须在Jira中有对应的用户。

• 评论告警：同步增加Jira问题中的评论。

• 解决告警：同步解决方案到Jira问题中的评论。

在钉钉群的告警卡片中的操作：

认领告警：同步更新Jira问题中的经办人。

将Jira操作同步至告警中

1. 在ARMS告警管理的集成页面的通知集成页签下获取Jira的集成密钥。

   

2. 进入Jira工单系统，在Jira页面右上角单击设置图标，然后单击系统。

   

3. 输入管理员密码，单击确认进入系统配置页面。

4. 在系统页的左侧导航栏选择告警 > WebHook。

5. 在WebHook页面单击+创建WebHook。

   

6. 在创建WebHook页面设置URL为http://alerts.aliyuncs.com/api/jira/receiver/{token}/${project.key}/${issue.key}。其中，{token}为步骤1操作中获取的Jira集成密钥。

   

7. 根据需求设置其他参数，更多信息，请参见Jira官方文档，然后单击新建。

   完成以上步骤后，在Jira中对问题的以下操作将会同步至ARMS告警管理中。

   • 问题修改经办人：对应告警的处理人会同步修改。

   • 问题新增备注：对应告警的评论会同步新增。