Flashduty Docs
中文EnglishRoadmapAPI官网控制台
中文EnglishRoadmapAPI官网控制台
  1. 集成引导
  2. 告警集成
  • 快速开始
    • 入门介绍
    • 快速开始
    • 常见问题
    • 产品对比
  • 故障管理
    • 什么是故障
    • 检索与查看故障
    • 处理与更新故障
    • 升级与分派故障
    • 自定义字段
    • 自定义操作
    • 了解降噪过程
    • 了解历史故障
    • 了解新奇故障
  • 配置Flashduty
    • 协作空间管理
    • 多种方式接入告警
    • 配置路由规则
    • 配置标签增强
    • 配置告警降噪
    • 配置分派策略
    • 故障静默与抑制
    • 配置值班规则
    • 配置通知模板
    • 配置服务日历
    • 配置个人信息
    • 配置过滤条件
    • 通知机器人
    • 告警处理 pipeline
  • 平台功能
    • 团队和成员
    • 了解权限设计
    • 配置单点登录
    • 分析数据
  • 高级功能
    • 引用变量
    • 动态分派
  • 集成引导
    • 告警集成
      • 邮件 Email 集成指引
      • 夜莺 Flashcat 集成指引
      • Prometheus 集成指引
      • 标准告警事件集成指引
      • Grafana 集成指引
      • Zabbix 集成指引
      • Uptime Kuma 集成指引
      • 阿里云 ARMS 集成指引
      • 阿里云监控 CM 事件集成指引
      • 阿里云监控 CM 指标集成指引
      • 阿里云 SLS 集成指引
      • AWS CloudWatch 集成指引
      • Azure Monitor 集成指引
      • 百度云监控 BCM 集成指引
      • 华为云监控 CES 集成指引
      • 腾讯云 CLS 集成指引
      • 腾讯云监控 CM 集成指引
      • 腾讯云 Event Bridge 集成指引
      • Influxdata 集成指引
      • Open Falcon 集成指引
      • Pagerduty 集成指引
      • 蓝鲸智云集成指引
      • OceanBase 集成指引
      • Graylog 集成指引
      • Skywalking 集成指引
      • Sentry 集成指引
      • 监控宝告警集成指引
      • AWS EventBridge 集成指引
      • Dynatrace 集成指引
      • 华为云 LTS 集成指引
      • GoogleCloud 集成指引
      • Splunk 集成指引
      • AppDynamics 集成指引
      • SolarWinds 集成指引
      • 火山引擎CM 指标集成指引
      • 火山引擎CM 事件集成指引
      • 火山引擎日志服务 TLS 集成指引
      • Opmanager 告警事件
      • Meraki 告警事件
    • 即时消息
      • 飞书 Lark 集成指引
      • 钉钉 Dingtalk 集成指引
      • 企业微信 Wecom 集成指引
      • Slack 集成指引
      • Microsoft Teams 集成指引
    • 单点登录
      • Authing 集成指引
      • Keycloak 集成指引
      • OpenLDAP 集成指引
    • Webhooks
      • 告警 webhook
      • 故障 webhook
      • 自定义操作
    • 变更集成
      • 标准变更事件集成指引
      • Jira 事件集成指引
  • 服务协议
    • 服务条款
    • 用户协议/隐私政策
    • SLA承诺
  1. 集成引导
  2. 告警集成

Zabbix 集成指引

通过 webhook 的方式同步 Zabbix 告警事件到 Flashduty（支持 Zabbix 3.x ~ 7.x 版本，不同版本配置有差异），实现告警事件自动化降噪处理。

在 Flashduty#

您可通过以下2种方式，获取一个集成推送地址，任选其一即可。

使用专属集成#

当您不需要将告警事件路由到不同的协作空间，优先选择此方式，更简单。
展开
1.
进入 Flashduty 控制台，选择 协作空间，进入某个空间的详情页面
2.
选择 集成数据 tab，点击 添加一个集成，进入添加集成页面
3.
选择 Zabbix 集成，点击 保存，生成卡片。
4.
点击生成的卡片，可以查看到 推送地址，复制备用，完成。

使用共享集成#

当您需要根据告警事件的 Payload 信息，将告警路由到不同的协作空间，优先选择此方式。
展开
1.
进入 Flashduty 控制台，选择 集成中心=>告警事件，进入集成选择页面。
2.
选择 Zabbix 集成：
集成名称：为当前集成定义一个名称。
3.
点击 保存 后，复制当前页面的新生成的 推送地址 备用。
4.
点击 创建路由，为集成配置路由规则。您可以按条件匹配不同的告警到不同的协作空间，也可以直接设置默认协作空间作为兜底，后续再按需调整。
5.
完成。

在 Zabbix#

7.x 版本#

步骤 1：定义快猫星云 media type#

1.
media type 是 Zabbix 中用于发送通知和告警的传输通道。进入终端，通过以下命令，下载完整配置
wget --header="Referer: https://console.flashcat.cloud" https://download.flashcat.cloud/flashduty/integration/zabbix/zbx_mediatype_flashcat_v7.yml
2.
登录 Zabbix 控制台，选择 Alert > Media Types，点击右上角 Import 按钮，进入编辑页面，选择上边下载的配置文件，点击 Import 按钮完成导入
3.
回到 Media Types 页面，可以看到已经导入的 media type。点击名称，进入编辑页面，补全 URL、zabbix_url 以及 HTTPProxy 等内容：
URL：webhook 推送请求地址，复制集成的推送地址即可
zabbix_url：Zabbix 控制台地址，直接复制即可（如果您的页面配置了 tomcat/nginx 转发路径，请同时携带），系统会在路径后拼接 trigger_id 等参数来生成告警详情页面连接
HTTPProxy：如果您的 Zabbix Server 不能直接访问快猫星云服务，可以将该参数设置为一个代理地址
drawing
4.
点击 Update，保存配置

步骤 2：关联 media type 至 user#

media type 必须关联至某个 user 才能发送事件。user 至少拥有对 host 的 read 权限。建议直接关联到 Admin 用户。以 Admin 用户为例：
1.
登录 Zabbix 控制台，选择 Users > Users，选择 Admin 用户，选择 media，选择 Add，进入编辑窗口：
Type： 选择以上创建的快猫星云 media type
Send To：填写 FlashDuty
其他配置使用默认配置，保持不变
drawing
2.
点击 Add 按钮，退出添加 media 窗口
3.
点击 Update 按钮，退出编辑 user 页面

步骤 3：创建 action#

发送通知是 Zabbix 中动作（actions）执行的操作之一。因此，为了建立一个通知，登录 Zabbix 控制台，选择 Alerts > Actions > Trigger actions，然后：
1.
点击 Create action，进入 action 编辑页面
Name：填写为“Send To FlashDuty”
2.
选择 Operations，分别添加三种场景的通知发送配置：
在 Operations 配置项，点击 Add 按钮，进入配置窗口
Send to users：选择以上新建或配置的 user
Send only to：选择快猫星云 media type
其他配置保持默认
点击 Add 按钮，完成该配置项配置
重复以上步骤，完成对 Recovery operations 和 Update operations 的配置
drawingdrawing

步骤 4：发送事件到快猫星云#

登录 Zabbix 控制台，选择 Monitoring > Problems，查看最新的告警列表。
1.
点击 Actions，弹窗内可以看到消息通知结果
2.
找到快猫星云对应日志，如果 Status 为 Sent，代表通知成功。否则根据提示排查原因
drawing
3.
回到集成列表，如果展示了最新事件时间，说明配置成功且收到事件
4.
完成

5.x~6.x 版本#

步骤 1：定义 Flashduty media type#

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

步骤 2：关联 media type 至 user#

media type 必须关联至某个 user 才能发送事件。user 至少拥有对 host 的 read 权限。建议直接关联到 Admin 用户。以 Admin 用户为例：
1.
登录 Zabbix 控制台，选择 Administration > Users，选择 Admin 用户，选择 media，选择 Add，进入编辑窗口：
Type： 选择以上创建的 Flashduty media type
Send To：填写 N/A
其他配置使用默认配置，保持不变
drawing
2.
点击 Add 按钮，退出添加 media 窗口
3.
点击 Update 按钮，退出编辑 user 页面

步骤 3：创建 action#

发送通知是 Zabbix 中动作（actions）执行的操作之一。因此，为了建立一个通知，登录 Zabbix 控制台，选择 Configuration > Actions，然后：
1.
点击 Create action，进入 action 编辑页面
Name：填写为“Send To FlashDuty”
2.
选择 Operations，分别添加三种场景的通知发送配置：
在 Operations 配置项，点击 Add 按钮，进入配置窗口
Send to users：选择以上新建或配置的 user
Send only to：选择 Flashduty media type
其他配置保持默认
点击 Add 按钮，完成该配置项配置
重复以上步骤，完成对 Recovery operations 和 Update operations 的配置
drawingdrawing

步骤 4：发送事件到 Flashduty#

登录 Zabbix 控制台，选择 Monitoring > Problems，查看最新的告警列表。
1.
点击 Actions，弹窗内可以看到消息通知结果
2.
找到 Flashduty 对应日志，如果 Status 为 Sent，代表通知成功。否则根据提示排查原因
drawing
3.
回到集成列表，如果展示了最新事件时间，说明配置成功且收到事件
4.
完成

3.x~4.x 版本#

步骤 1：定义 Flashduty media type#

1.
登录 Zabbix 控制台，选择 Administration > Media Types，点击右上角 Create media type 按钮，进入编辑页面
2.
在编辑页面，Type 选择Script，Parameter 依次填写以下内容（不要调整顺序，没有值的也要留空，脚本按顺序获取参数值）：
{ALERT.SUBJECT}：告警标题，保持在第一个参数
{ALERT.MESSAGE}：告警信息，保持在第二个参数
FlashDuty webhook 推送请求地址，复制集成的推送地址即可，保持在第三个参数
Zabbix 控制台地址，直接复制即可（如果您的页面配置了 tomcat/nginx 转发路径，请同时携带），用于生成告警详情页面连接。如果没有空着即可，保持在第四个参数
HTTPProxy：如果您的 Zabbix Server 不能直接访问 Flashduty 服务，可以将该参数设置为一个代理地址。如果没有空着即可，保持在第五个参数
drawing
3.
Script name 填写 send-to-flashduty.sh
4.
点击 Update，保存配置
5.
登录 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
6.
注意，脚本中使用了 curl 和 jq 命令，确保这个 Zabbix server 进程可以找到并执行这两个命令，如果没有您需要根据情况安装

步骤 2：关联 media type 至 user#

media type 必须关联至某个 user 才能发送事件。user 至少拥有对 host 的 read 权限。建议直接关联到 Admin 用户。以 Admin 用户为例：
1.
登录 Zabbix 控制台，选择 Administration > Users，选择 Admin 用户，选择 media，选择 Add，进入编辑窗口：
Type： 选择以上创建的 Flashduty media type
Send To：填写 N/A
其他配置使用默认配置，保持不变
drawing
2.
点击 Add 按钮，退出添加 media 窗口
3.
点击 Update 按钮，退出编辑 user 页面

步骤 3：创建 action#

发送通知是 Zabbix 中动作（actions）执行的操作之一。因此，为了建立一个通知，登录 Zabbix 控制台，选择 Configuration > Actions，然后：
1.
点击Create action，进入 action 编辑页面
Name：填写为“Send To FlashDuty”
2.
选择 Operations，分别更新三种场景的通知用户配置：
在 Operations 配置项，点击 Add 按钮，进入配置窗口
Send to users：选择以上新建或配置的 user
Send only to：选择 Flashduty media type
其他配置保持默认
点击 Add 按钮，完成该配置项配置
重复以上步骤，完成对 Recovery operations 和 Update operations 的配置
drawing
3.
选择 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 的配置
drawing

步骤 4：发送事件到 Flashduty#

登录 Zabbix 控制台，选择 Monitoring > Problems，查看最新的告警列表。
1.
点击 Actions，弹窗内可以看到消息通知结果
2.
找到 Flashduty 对应日志，如果 Status 为 Sent，代表通知成功。否则根据提示排查原因
drawing
3.
回到集成列表，如果展示了最新事件时间，说明配置成功且收到事件
4.
完成

状态对照#

Zabbix 到 Flashduty 告警等级映射关系：
ZabbixFlashduty状态
DisasterCritical严重
HighCritical严重
AverageWarning警告
WarningWarning警告
InformationInfo提醒
Not classifiedInfo提醒
修改于 2025-01-07 03:42:06
上一页
Grafana 集成指引
下一页
Uptime Kuma 集成指引
Built with