Zabbix集成

在 Zabbix

7.x 版本
5.x~6.x 版本
3.x~4.x 版本

一、Zabbix 配置

7.x 版本

步骤 1：定义 Flashduty media type

media type 是 Zabbix 中用于发送通知和告警的传输通道。进入终端，通过以下命令，下载完整配置

wget --header="Referer: https://console.flashcat.cloud" https://download.flashcat.cloud/flashduty/integration/zabbix/zbx_mediatype_flashcat_v7.yml

登录 Zabbix 控制台，选择 Alert > Media Types，点击右上角 Import 按钮，进入编辑页面，选择上边下载的配置文件，点击 Import 按钮完成导入
回到 Media Types 页面，可以看到已经导入的 media type。点击名称，进入编辑页面，补全 URL、zabbix_url 以及 HTTPProxy 等内容：
- URL：webhook 推送请求地址，复制集成的推送地址即可
- zabbix_url：Zabbix 控制台地址，直接复制即可（如果您的页面配置了 tomcat/nginx 转发路径，请同时携带），系统会在路径后拼接 trigger_id 等参数来生成告警详情页面连接
- HTTPProxy：如果您的 Zabbix Server 不能直接访问 Flashduty 服务，可以将该参数设置为一个代理地址
点击 Update，保存配置

步骤 2：关联 media type 至 user

media type 必须关联至某个 user 才能发送事件。user 至少拥有对 host 的 read 权限。建议直接关联到 Admin 用户。以 Admin 用户为例：

Type：选择以上创建的 Flashduty media type
Send To：填写 Flashduty
其他配置使用默认配置，保持不变

点击 Add 按钮，退出添加 media 窗口
点击 Update 按钮，退出编辑 user 页面

步骤 3：创建 action

发送通知是 Zabbix 中动作（actions）执行的操作之一。因此，为了建立一个通知，登录 Zabbix 控制台，选择 Alerts > Actions > Trigger actions，然后：

点击 Create action，进入 action 编辑页面

Name：填写为“Send To Flashduty”

选择 Operations，分别添加三种场景的通知发送配置：

在 Operations 配置项，点击 Add 按钮，进入配置窗口
Send to users：选择以上新建或配置的 user
Send only to：选择 Flashduty media type
其他配置保持默认
点击 Add 按钮，完成该配置项配置
重复以上步骤，完成对 Recovery operations 和 Update operations 的配置

步骤 4：发送事件到 Flashduty

点击 Actions，弹窗内可以看到消息通知结果
找到 Flashduty 对应日志，如果 Status 为 Sent，代表通知成功。否则根据提示排查原因

回到集成列表，如果展示了最新事件时间，说明配置成功且收到事件
完成

5.x~6.x 版本

步骤 1：定义 Flashduty media type

media type 是 Zabbix 中用于发送通知和告警的传输通道。进入终端，通过以下命令，下载完整配置

// 5.x版本 XML配置：
wget --header="Referer: https://console.flashcat.cloud" https://download.flashcat.cloud/flashduty/integration/zabbix/zbx_mediatype_flashcat_v5.xml

// 6.x 版本 YAML 配置：
wget --header="Referer: https://console.flashcat.cloud" https://download.flashcat.cloud/flashduty/integration/zabbix/zbx_mediatype_flashcat_v6.yml

登录 Zabbix 控制台，选择 Administration > Media Types，点击右上角 Import 按钮，进入编辑页面，选择上边下载的配置文件，点击 Import 按钮完成导入
回到 Media Types 页面，可以看到已经导入的 media type。点击名称，进入编辑页面，补全 URL、zabbix_url 以及 HTTPProxy 等内容：
- URL：webhook 推送请求地址，复制集成的推送地址即可
- zabbix_url：Zabbix 控制台地址，直接复制即可（如果您的页面配置了 tomcat/nginx 转发路径，请同时携带），系统会在路径后拼接 trigger_id 等参数来生成告警详情页面连接
- HTTPProxy：如果您的 Zabbix Server 不能直接访问 Flashduty 服务，可以将该参数设置为一个代理地址
点击 Update，保存配置

步骤 2：关联 media type 至 user

media type 必须关联至某个 user 才能发送事件。user 至少拥有对 host 的 read 权限。建议直接关联到 Admin 用户。以 Admin 用户为例：

Type：选择以上创建的 Flashduty media type
Send To：填写 N/A
其他配置使用默认配置，保持不变

点击 Add 按钮，退出添加 media 窗口
点击 Update 按钮，退出编辑 user 页面

步骤 3：创建 action

发送通知是 Zabbix 中动作（actions）执行的操作之一。因此，为了建立一个通知，登录 Zabbix 控制台，选择 Configuration > Actions，然后：

点击 Create action，进入 action 编辑页面

Name：填写为“Send To Flashduty”

选择 Operations，分别添加三种场景的通知发送配置：

在 Operations 配置项，点击 Add 按钮，进入配置窗口
Send to users：选择以上新建或配置的 user
Send only to：选择 Flashduty media type
其他配置保持默认
点击 Add 按钮，完成该配置项配置
重复以上步骤，完成对 Recovery operations 和 Update operations 的配置

步骤 4：发送事件到 Flashduty

点击 Actions，弹窗内可以看到消息通知结果
找到 Flashduty 对应日志，如果 Status 为 Sent，代表通知成功。否则根据提示排查原因

回到集成列表，如果展示了最新事件时间，说明配置成功且收到事件
完成

3.x~4.x 版本

步骤 1：定义 Flashduty media type

登录 Zabbix 控制台，选择 Administration > Media Types，点击右上角 Create media type 按钮，进入编辑页面
在编辑页面，Type 选择Script，Parameter 依次填写以下内容（不要调整顺序，没有值的也要留空，脚本按顺序获取参数值）：

{ALERT.SUBJECT}：告警标题，保持在第一个参数
{ALERT.MESSAGE}：告警信息，保持在第二个参数
- Flashduty webhook 推送请求地址，复制集成的推送地址即可，保持在第三个参数
- Zabbix 控制台地址，直接复制即可（如果您的页面配置了 tomcat/nginx 转发路径，请同时携带），用于生成告警详情页面连接。如果没有空着即可，保持在第四个参数
- HTTPProxy：如果您的 Zabbix Server 不能直接访问 Flashduty 服务，可以将该参数设置为一个代理地址。如果没有空着即可，保持在第五个参数

Script name 填写 send-to-flashduty.sh
点击 Update，保存配置
登录 Zabbix server 所在服务器，执行以下命令：

#1. 进入告警脚本加载目录（具体地址配置在 Zabbix Server 配置文件中 `AlertScriptsPath` 变量，一般为`/usr/lib/zabbix/alertscripts`）
cd /usr/lib/zabbix/alertscripts

#2. 下载脚本
wget --header="Referer: https://console.flashcat.cloud" https://download.flashcat.cloud/flashduty/integration/zabbix/send-to-flashduty.sh

#3. 更改脚本为可执行状态
chmod +x send-to-flashduty.sh

注意，脚本中使用了 curl 和 jq 命令，确保这个 Zabbix server 进程可以找到并执行这两个命令，如果没有您需要根据情况安装

步骤 2：关联 media type 至 user

media type 必须关联至某个 user 才能发送事件。user 至少拥有对 host 的 read 权限。建议直接关联到 Admin 用户。以 Admin 用户为例：

登录 Zabbix 控制台，选择 Administration > Users，选择 Admin 用户，选择 media，选择 Add，进入编辑窗口：
- Type：选择以上创建的 Flashduty media type
- Send To：填写 N/A
- 其他配置使用默认配置，保持不变
点击 Add 按钮，退出添加 media 窗口
点击 Update 按钮，退出编辑 user 页面

步骤 3：创建 action

发送通知是 Zabbix 中动作（actions）执行的操作之一。因此，为了建立一个通知，登录 Zabbix 控制台，选择 Configuration > Actions，然后：

点击Create action，进入 action 编辑页面
- Name：填写为“Send To Flashduty”
选择 Operations，分别更新三种场景的通知用户配置：
- 在 Operations 配置项，点击 Add 按钮，进入配置窗口
- Send to users：选择以上新建或配置的 user
- Send only to：选择 Flashduty media type
- 其他配置保持默认
- 点击 Add 按钮，完成该配置项配置
- 重复以上步骤，完成对 Recovery operations 和 Update operations 的配置
选择 Operations，分别更新三种场景的通知内容配置：
- 在 Default Message 配置项，完整复制以下内容，粘贴在默认内容之后，Flashduty 收到事件后将解析对应文字，找到告警属性信息：

-----Flashduty Required Starts-----event_severity={TRIGGER.SEVERITY}||event_name={TRIGGER.NAME}||event_id={EVENT.ID}||event_tags={EVENT.TAGS}||event_ack={EVENT.ACK.STATUS}||event_value={EVENT.VALUE}||trigger_id={TRIGGER.ID}||trigger_desc={TRIGGER.DESCRIPTION}||trigger_expr={TRIGGER.EXPRESSION}||host_group={TRIGGER.HOSTGROUP.NAME}||host_ip={HOST.IP}||host_name={HOST.NAME}||item_name={ITEM.NAME}||item_value={ITEM.VALUE}-----Flashduty Required Ends-----

重复以上步骤，完成对 Recovery operations 和 Update operations 的配置

步骤 4：发送事件到 Flashduty

点击 Actions，弹窗内可以看到消息通知结果
找到 Flashduty 对应日志，如果 Status 为 Sent，代表通知成功。否则根据提示排查原因
回到集成列表，如果展示了最新事件时间，说明配置成功且收到事件
完成

二、状态对照

Zabbix 到 Flashduty 告警等级映射关系：

Zabbix	Flashduty	状态
Disaster	Critical	严重
High	Critical	严重
Average	Warning	警告
Warning	Warning	警告
Information	Info	提醒
Not classified	Info	提醒

快速开始

产品对比

协作空间

故障管理

故障复盘

状态页

分析看板

集成配置

配置中心

高级功能

集成中心

最佳实践

在 Flashduty On-call

使用专属集成

使用共享集成

在 Zabbix

一、Zabbix 配置

7.x 版本

步骤 1：定义 Flashduty media type

步骤 2：关联 media type 至 user

步骤 3：创建 action

步骤 4：发送事件到 Flashduty

5.x~6.x 版本

步骤 1：定义 Flashduty media type

步骤 2：关联 media type 至 user

步骤 3：创建 action

步骤 4：发送事件到 Flashduty

3.x~4.x 版本

步骤 1：定义 Flashduty media type

步骤 2：关联 media type 至 user

步骤 3：创建 action

步骤 4：发送事件到 Flashduty

二、状态对照

​在 Flashduty On-call

​使用专属集成

​使用共享集成

​在 Zabbix

​一、Zabbix 配置

​7.x 版本

​步骤 1：定义 Flashduty media type

​步骤 2：关联 media type 至 user

​步骤 3：创建 action

​步骤 4：发送事件到 Flashduty

​5.x~6.x 版本

​步骤 1：定义 Flashduty media type

​步骤 2：关联 media type 至 user

​步骤 3：创建 action

​步骤 4：发送事件到 Flashduty

​3.x~4.x 版本

​步骤 1：定义 Flashduty media type

​步骤 2：关联 media type 至 user

​步骤 3：创建 action

​步骤 4：发送事件到 Flashduty

​二、状态对照

在 Flashduty On-call

使用专属集成

使用共享集成

在 Zabbix

一、Zabbix 配置

7.x 版本

步骤 1：定义 Flashduty media type

步骤 2：关联 media type 至 user

步骤 3：创建 action

步骤 4：发送事件到 Flashduty

5.x~6.x 版本

步骤 1：定义 Flashduty media type

步骤 2：关联 media type 至 user

步骤 3：创建 action

步骤 4：发送事件到 Flashduty

3.x~4.x 版本

步骤 1：定义 Flashduty media type

步骤 2：关联 media type 至 user

步骤 3：创建 action

步骤 4：发送事件到 Flashduty

二、状态对照