一.
概述
在日常工作中,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源创计划”,欢迎正在阅读的你也加入,一起分享。