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

一.

概述

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

工作流预览

这个流程有如下步骤

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

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

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

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

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

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

二.

操作步骤

前置准备

一、在Zabbix系统中配置飞书媒介类型并关联用户与动作

1. 下载飞书的Zabbix媒介类型

下载地址：

2. 在Zabbix中导入该媒介类型

在Zabbix控制台，选择管理 > 报警媒介，然后导入该媒介类型。导入规则选择“更新现有的”和“创建新的”。

3. 配置支持飞书媒介类型的用户

在Zabbix系统中每个用户支持的媒介类型需要单独配置，因此必须要配置支持飞书媒介类型的用户。

在管理 》 用户页面， 选择已有用户编辑或者新建用户页面，选择报警媒介页面，类型选择“Feishu”，收件人填入飞书的回调地址。

注意：所选用户必须有告警主机的权限， 否则告警信息是无法发送给该用户的。权限可以在用户群组中进行管理。

回调地址可以点击工作流中的Zabbix 节点，在右侧设置页面可见回调地址。

4. 修改Action配置

在配置 》 动作中选择需要发送给目标群的action进行修改，选择action，在操作页面添加发送对象（操作、恢复操作、更新操作都可以配置，可以按照实际情况及需求进行配置）。发送的用户选择上一步创建的用户，“仅送到” 选择飞书。

注意：动作需要是启用状态且条件不能为空。

注意：zabbix 版本需要是5.0及以上才支持导入媒介类型。

二、准备一个多维表格

使用模板 ，创建一篇如下图所示的多维表格文档。

逐步细分

一、配置Zabbix应用凭证

点击工作流中的Zabbix节点，在右侧 凭证 页面配置新建/选择已有的“Zabbix应用授权”凭证，下文以“新建”为例：

新建应用凭证时，填入必填项后，点击创建并连接。

注意：如果仅使用该模版，ApiToken和Zabbix域名可以设置为任意值并创建连接都可以生效。

其中ApiToken是在Zabbix控制台 》用户设置》 API Token创建，如下图：

Zabbix域名填入的是不需要携带页面路径参数，且公网可以访问的URL地址。例如仪表盘地址为，那么填入的地址为:

二、配置飞书系应用的凭证

点击查询记录节点右侧的凭证，新建/选择已有的“飞书应用授权”凭证，下文以“新建”为例：

a. 点击新建应用凭证，并在凭证创建页面点击新建飞书应用。

注：通过集成平台创建的飞书应用会自动提交发布申请，应用发布审核未通过时工作流运行会报错。

b.将创建的“飞书应用授权”凭证，批量更新到剩余的“飞书系”连接器节点。

c. 选择好凭证后，如果该凭证需要额外申请权限，可在下提示信息中点击配置应用凭证，一键提交配置申请。

三、选择多维表格

分别选在查询记录、新建记录、更新记录节点的入参页面选择前置准备好的多维表格和数据表。

如果多维表格没有添加当前的应用，会添加协作应用，点击去添加，然后选择确认即可。

四、发布集成流

完成工作流编辑后，点击发布，该工作流则变为生效状态。

常见问题

一、如何将其他的信息同步到多维表格中？

如果需要同步的在当前回调的结果中，首先需要在多维表格中增加需要的字段并设置字段类型。

其次需要在转换为多维表格请求节点将需要的参数解析出来，转为为多维表格支持格式请求参数，可以参考：；在下图箭头标识的位置插入转换逻辑。

如果需要同步的字段不在当前回调的结果中，则需要在Zabbix系统中调整飞书媒介类型的入参。

二、为什么告警信息没有同步到多维表格

首先可以在zabbix的控制台的报表》动作日志中查看是否有相关发送给飞书的日志（如下图）。

如果没有任何相关的日志，则原因大概率是配置不正确。首先检查告警的人员或者群组是否有对应的主机和主机组的权限、其次按照上面的步骤再检查一遍。

如果存在日志，并显示错误则可以按照错误提示原因进行排查，常见的问题有：Zabbix主机无法访问公网等。

如果存在日志并且日志为已送达，则可以在Anycross的运行日志中进行排查，常见的问题有：应用凭证配置错误、群ID配置错误等。如何处理可以参考前面的步骤检查一遍。