一.
概述
在日常工作中，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源創計劃”，歡迎正在閱讀的你也加入，一起分享。