ARMS告警管理支持通過Jira賬號信息或OAuth的方式集成Jira工單系統,本文介紹如何通過Jira賬號信息在ARMS告警管理中集成Jira工單系統,使告警在創建時能同時在Jira中創建問題工單,告警狀態與工單狀態可以實現雙向同步。
在ARMS告警管理中集成Jira
- 登錄ARMS控制臺,在左側導航欄選擇 。
在集成頁面單擊通知集成頁簽,然后單擊JIRA。
在添加集成配置向導頁面,進行以下配置:
在基本信息向導頁輸入集成名稱、Jira的地址URL,選擇驗證方式為JIRA賬號登錄,并輸入Jira的用戶名和密碼,根據需要添加集成描述,然后單擊測試連接。
頁面顯示連接成功后,單擊下一步。
說明若連接失敗,則表示配置的Jira的地址、用戶名或密碼有誤,請修改后重新單擊測試連接驗證。
在告警源配置向導頁通過以下參數配置告警同步信息,然后單擊保存。
參數
說明
示例
問題所屬項目
告警產生時同步到的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中創建問題。
在控制臺左側導航欄選擇 。
在通知策略頁面單擊新建通知策略或者編輯已有的通知策略。
在編輯通知策略頁面的當告警生成時區域,選擇的通知人/排班至少包含聯系人或聯系人組。
重要Jira會在系統中查詢與通知策略中識別到的第一個聯系人擁有相同郵箱或姓名(用戶名)的用戶,該Jira用戶將會被設置為問題經辦人。
如果通知策略識別到的第一個通知人在Jira中沒有對應的用戶,那么告警將無法同步至Jira中。
選擇工單系統為已創建的Jira集成。根據需求設置其他參數,具體操作,請參見通知策略。
設置完成后單擊保存。
配置完成后,匹配到該通知策略的告警將會推送到Jira中。
方式二
在告警發送歷史頁面將已產生的告警推送至Jira中,并在Jira中生成對應問題。
在控制臺左側導航欄選擇 。
在告警發送歷史頁面右上角關聯操作人(作為Jira問題中的經辦人),然后單擊目標告警名稱。
重要Jira會在系統中查詢與聯系人擁有相同郵箱或姓名(用戶名)的用戶,該Jira用戶將會被設置為問題經辦人。
如果操作人在Jira中無對應的用戶,那么告警將無法同步至Jira中。
在告警詳情頁面右上角單擊圖標,然后單擊推送告警。
在彈出的對話框中,選擇工單系統為已創建的Jira集成,然后單擊確認。
推送成功后,可在告警詳情頁面看到告警對應的Jira問題的鏈接。
方式三
已產生告警并在釘釘群中收到告警卡片后,在釘釘群的告警卡片中將告警推送至Jira中,并在Jira中生成對應問題。
當前在釘釘群中處理告警推送的操作人將會作為Jira問題中的經辦人。
操作人為已在釘釘群的告警卡片中綁定過手機號的聯系人,具體操作,請參見處理告警。
如果Jira中存在用戶的郵箱或用戶名與ARMS聯系人的郵箱或姓名相同,則對應的ARMS聯系人即為Jira中的用戶。
如果操作人在Jira中無對應的用戶,那么告警將無法同步至Jira中。
在釘釘群收到的告警卡片中,單擊推送告警,然后選擇已創建的Jira集成。
在告警卡片中單擊目標告警名稱,在告警詳情面板單擊設置,然后單擊推送工單,并選擇已創建的Jira集成。
推送成功后,可在告警詳情頁面看到告警對應的Jira問題的鏈接。
支持同步的告警操作
完成以上步驟后,在ARMS告警管理中對告警的以下操作將會同步至Jira工單系統中。
在告警發送歷史頁面的操作:
認領告警:同步更新Jira問題中的經辦人。
說明認領人必須在Jira中有對應的用戶。
評論告警:同步增加Jira問題中的評論。
解決告警:同步解決方案到Jira問題中的評論。
在釘釘群的告警卡片中的操作:
認領告警:同步更新Jira問題中的經辦人。
認領人必須在Jira中有對應的用戶。
將Jira操作同步至告警中
在ARMS告警管理的集成頁面的通知集成頁簽下獲取Jira的集成密鑰。
進入Jira工單系統,在Jira頁面右上角單擊設置圖標,然后單擊系統。
輸入管理員密碼,單擊確認進入系統配置頁面。
在系統頁的左側導航欄選擇 。
在WebHook頁面單擊+創建WebHook。
在創建WebHook頁面設置URL為
http://alerts.aliyuncs.com/api/jira/receiver/{token}/${project.key}/${issue.key}
。其中,{token}為步驟1操作中獲取的Jira集成密鑰。根據需求設置其他參數,更多信息,請參見Jira官方文檔,然后單擊新建。
完成以上步驟后,在Jira中對問題的以下操作將會同步至ARMS告警管理中。
問題修改經辦人:對應告警的處理人會同步修改。
問題新增備注:對應告警的評論會同步新增。