一.
概述
在日常工作中,IT運維人員需要及時收到和處理各種IT系統的告警信息,以保證系統穩定運行。在Zabbix監控系統中,用戶可以通過配置發送告警信息的方式,將告警信息發送到特定媒介中以便處理、記錄、分析等。在本文中,我們將介紹如何將Zabbix告警信息同步到多維表格中。
工作流預覽
這個流程有如下步驟
二.
操作步驟
前置準備
一、在Zabbix系統中配置飛書媒介類型並關聯用戶與動作
1. 下載飛書的Zabbix媒介類型
下載地址:zbx_export_mediatype_feishu.xml
2. 在Zabbix中導入該媒介類型
在Zabbix控制檯,選擇管理 > 報警媒介,然後導入該媒介類型。導入規則選擇“更新現有的”和“創建新的”。
3. 配置支持飛書媒介類型的用戶
在Zabbix系統中每個用戶支持的媒介類型需要單獨配置,因此必須要配置支持飛書媒介類型的用戶。
在管理 》 用戶頁面, 選擇已有用戶編輯或者新建用戶頁面,選擇報警媒介頁面,類型選擇“Feishu”,收件人填入飛書的回調地址。
注意:所選用戶必須有告警主機的權限, 否則告警信息是無法發送給該用戶的。權限可以在用戶羣組中進行管理。
回調地址可以點擊工作流中的 Zabbix 節點,在右側 設置 頁面可見回調地址。
4. 修改Action配置
在配置 》 動作中選擇需要發送給目標羣的action進行修改,選擇action,在操作頁面添加發送對象(操作、恢復操作、更新操作都可以配置,可以按照實際情況及需求進行配置)。發送的用戶選擇上一步創建的用戶,“僅送到” 選擇飛書。
注意:動作需要是啓用狀態且條件不能爲空。
注意:zabbix 版本需要是5.0及以上才支持導入媒介類型。
二、準備一個多維表格
使用模板Zabbix告警事件信息模版 ,創建一篇如下圖所示的多維表格文檔。
逐步細分
一、配置Zabbix應用憑證
點擊工作流中的 Zabbix 節點,在右側 憑證 頁面配置新建/選擇已有的“Zabbix應用授權”憑證,下文以“新建”爲例:
新建應用憑證時,填入必填項後,點擊 創建並連接。
注意:如果僅使用該模版,ApiToken和Zabbix域名可以設置爲任意值並創建連接都可以生效。
其中ApiToken是在Zabbix控制檯 》用戶設置》 API Token創建,如下圖:
Zabbix域名填入的是不需要攜帶頁面路徑參數,且 公網可以訪問 的URL地址。例如儀表盤地址爲https://example.com/zabbix/zabbix.php?action=dashboard.view,那麼填入的地址爲: https://example.com/zabbix/
二、配置飛書系應用的憑證
點擊 查詢記錄 節點右側的 憑證,新建/選擇已有的“飛書應用授權”憑證,下文以“新建”爲例:
a. 點擊 新建應用憑證,並在憑證創建頁面點擊 新建飛書應用。
注:通過集成平臺創建的飛書應用會自動提交發布申請,應用發佈審覈未通過時工作流運行會報錯。
b.將創建的“飛書應用授權”憑證,批量更新到剩餘的“飛書系”連接器節點。
c. 選擇好憑證後,如果該憑證需要額外申請權限,可在下提示信息中點擊 配置應用憑證 ,一鍵提交配置申請。
三、選擇多維表格
分別選在 查詢記錄、新建記錄、更新記錄 節點的入參頁面選擇前置準備好的多維表格和數據表。
如果多維表格沒有添加當前的應用,會添加協作應用,點擊去添加,然後選擇確認即可。
四、發佈集成流
完成工作流編輯後,點擊 發佈,該工作流則變爲生效狀態。
常見問題
一、如何將其他的信息同步到多維表格中?
如果需要同步的在當前回調的結果中,首先需要在多維表格中增加需要的字段並設置字段類型。
其次需要在 轉換爲多維表格請求 節點將需要的參數解析出來,轉爲爲多維表格支持格式請求參數,可以參考:新增記錄 - 服務端 API - 開發文檔 - 飛書開放平臺;在下圖箭頭標識的位置插入轉換邏輯。
如果需要同步的字段不在當前回調的結果中,則需要在Zabbix系統中調整飛書媒介類型的入參。
二、爲什麼告警信息沒有同步到多維表格
首先可以在zabbix的控制檯的報表》動作日誌中查看是否有相關發送給飛書的日誌(如下圖)。
如果沒有任何相關的日誌,則原因大概率是配置不正確。首先檢查告警的人員或者羣組是否有對應的主機和主機組的權限、其次按照上面的步驟再檢查一遍。
如果存在日誌,並顯示錯誤則可以按照錯誤提示原因進行排查,常見的問題有:Zabbix主機無法訪問公網等。
如果存在日誌並且日誌爲已送達,則可以在Anycross的運行日誌中進行排查,常見的問題有:應用憑證配置錯誤、羣ID配置錯誤等。如何處理可以參考前面的步驟檢查一遍。
延伸閱讀:
飛書官方| Zabbix告警信息發送飛書卡片消息,讓消息飛來
本文分享自微信公衆號 - Zabbix開源社區(china_zabbix)。
如有侵權,請聯繫 [email protected] 刪除。
本文參與“OSC源創計劃”,歡迎正在閱讀的你也加入,一起分享。