JIRA集成¶
JIRA是Atlassian公司出品的项目与事务跟踪工具,被广泛应用于缺陷跟踪、客户服务、需求收集、流程审批、任务跟踪、项目跟踪和敏捷管理等工作领域。JIRA中配置灵活、功能全面、部署简单、扩展丰富,其超过150项特性得到了全球115个国家超过19,000家客户的认可。
JIRA集成CA步骤¶
-
创建应用
进入CA中后,点击集成,创建【JIRA】应用,保存并获取AppKey
-
在JIRA中配置告警第三方集成
JIRA 6.3.6
- 登录JIRA账号,点击右上角的管理图标->选择系统->网络钩子->创建webhook
-
在下图位置中填写 名称 URL 中输入wehhook地址 http://api.aiops.com/alert/api/event/jira/ 获取的appKey
勾选 lssure Created lssure Deleted lssure Updated
JIRA 8.13.2
- 登录JIRA账号,点击右上角的管理图标->选择系统->webhook->创建网络钩子
- 在下图位置中填写 名称 状态开启 URL 中输入wehhook地址 http://api.aiops.com/alert/api/event/jira/ 获取的appKey
勾选 已创建 已更新 工作日志修改 后点击创建即可
测试JIRA告警¶
在jira中创建一个故障或是缺陷类型的问题,填写相关信息后,点击【创建】即可。登录CA平台查看告警-所有告警,是否有对应的告警信息。如果有则说明对接成功;如果没有请联系睿小象进行排查。
告警对应级别¶
JIRA级别 | CA告警级别 |
---|---|
Highest High | 严重 |
Medium | 警告 |
Low Lowest | 提醒 |
其他 | 提醒 |
Cloud Alert 对接 JIRA¶
-
进入CA点击配置-JIRA配置,输入 JIRA地址 用户账号 密码 ,点击
保存
-同步项目
-
以上设置完毕后,CloudAlert产生告警后,对应生成jira问题,本系统提供2种方式:
-
主告警发生时,自动触发生成一个对应的jira问题。【集成-创建某个应用时(非JIRA应用),可以选择开启自动创建jira问题开关】
-
在告警发生后,可针对未关闭的告警手动触发生成一个jira问题
-
注意事项¶
-
保证jira可以通过外网访问
-
用户需要在jira创建一个用户,并把此用户的账号密码,在CA中做个配置。一个团队共用一个JIRA账号
-
此JIRA用户,可以在jira中创建多个项目,此处可以做项目信息同步,用户在生成JIRA问题时,可以生成选择对应项目信息。
-
CloudAlert中的告警生成的jira问题都为故障|缺陷类型,优先级与告警级别对应。
-
CloudAlert中的告警状态变更,不会影响jira的状态变化,但是jira上问题的状态变化会同步更新CloudAlert中的告警状态
-
人员的同步信息以邮件地址为准,所以在使用此功能之前请保证jira中的相关处理与CloudAlert中用户邮件地址保持一致
-
同步项目时,如果提示"无法同步项目,JIRA账号权限不足"则需要首先验证用户名密码是否正确。
Cloud Alert 与 JIRA对应关系¶
-
告警标题:jira的标题
-
告警内容:描述+影响版本:XX;附件:X个;备注:XXXX
示例:XXXXXXXXXXXX。影响版本:202103;附件:无;备注:无。
示例:XXXXXXXXXXXX。影响版本:无;附件:3;备注:XXXXX。
ps:没有就写无
-
级别:优先级
-
告警对象:JIRA+项目名+类型
-
示例:JIRAaiops2020CA缺陷
当jira有变更时,包含以上内容【标题,描述,备注,类型,级别,人】都需要对应更新告警的相关信息,同时更新一下alarm的更新时间和告警发生次数。
每一次更新都需要做通知【支持短信和电话通知】
通知内容为:告警编号:XXXX;告警标题:XXXXX 在2020年11月21日 16:05发生变更,变更内容:名称变更为XXXX,描述变更为XXXX,备注变更为,附件发生变更。级别变更为XXXX,类型变更为XXX。