飞书官方|Zabbix告警信息同步到多维表格

2023/10/09 08:00
阅读数 60

一.

概述


在日常工作中,IT运维人员需要及时收到和处理各种IT系统的告警信息,以保证系统稳定运行。在Zabbix监控系统中,用户可以通过配置发送告警信息的方式,将告警信息发送到特定媒介中以便处理、记录、分析等。在本文中,我们将介绍如何将Zabbix告警信息同步到多维表格中。


工作流预览



这个流程有如下步骤


1. Zabbix触发器:接收Zabbix的回调信息,触发工作流运行。


2. 转换为多维表格请求:解析Zabbix回调的信息并转换为多维表格的请求的参数格式。


3. 查询记录:通过多维表格连接器查询当前事件的ID的事件记录。


4. 分支:判断是否查询到当前事件ID的记录。


5. 新建记录:通过多维表格连接器新建一条事件记录。


6. 更新记录:通过多维表格连接器更新已经存在的事件记录。



二.

操作步骤


前置准备


一、在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告警信息发送飞书卡片消息,让消息飞来

干货|Webhook配置钉钉/飞书机器人告警


本文分享自微信公众号 - Zabbix开源社区(china_zabbix)。
如有侵权,请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”,欢迎正在阅读的你也加入,一起分享。

展开阅读全文
加载中
点击引领话题📣 发布并加入讨论🔥
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部