跳转至

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

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

测试JIRA告警

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

告警对应级别

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

Cloud Alert 对接 JIRA

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

  2. 以上设置完毕后,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。