跳到主要内容

通知对象

信息

通知对象用于统一管理告警推送的目标渠道,支持企微机器人、飞书机器人、钉钉机器人、Webhook 四种类型。创建后可在通知策略中直接引用,避免同一渠道信息在多条告警规则中重复维护。

提示

本页仅用于维护 IM 机器人和 Webhook 等群组 / 系统通知渠道。如需维护具体人员的邮箱、手机号、企业微信 ID 等个人信息,请前往接收人管理。

快速上手​

第一步:进入创建页面

进入 设置中心 → 通知对象,点击创建,进入新建通知对象页面。

第二步:填写基本信息

  1. 选择通知类型:企微机器人 / 飞书机器人 / 钉钉机器人 / Webhook
  2. 填写通知对象名称(必填,最长 50 字符)
  3. 填写 Webhook 地址(必填)

第三步:完成专属配置并保存

  1. 根据所选类型填写专属配置(如 Webhook 的请求头、成功判断规则)
  2. 确认启停状态(默认开启)
  3. 点击发送测试验证连通性,确认无误后点击保存

功能说明​

通知对象列表​

1785239158112

列表展示当前账号下所有通知对象,支持按名称、类型、启停状态进行搜索过滤;Webhook 地址过长时自动截断,鼠标悬浮可查看完整地址。

操作说明
测试弹出测试内容输入框,填写内容后发送,实时展示发送结果(成功 / 失败)及响应体摘要
编辑修改通知对象的名称、地址及专属配置
删除永久删除该通知对象,需二次确认,提示"关联的通知将无法通过此渠道推送通知,且操作不可撤销"
启停状态点击列表中的状态按钮可直接切换启用 / 禁用,无需进入编辑弹窗;禁用后关联的告警规则将跳过该渠道,重新启用后自动恢复

创建通知对象​

1785239184243

基本信息​

字段是否必填说明
通知类型是支持企微机器人、飞书机器人、钉钉机器人、Webhook 四种类型,选定后不可再修改类型,如需更换建议重新创建
通知对象名称是通知对象的显示名称,用于在告警规则、通知策略中引用,最长 50 字符
Webhook 地址是推送消息的目标 URL,各平台格式不同,可从对应机器人的创建后台获取

各类型专属配置​

企微机器人​
字段是否必填说明
消息类型是支持文本消息、Markdown 消息
飞书机器人​
字段是否必填说明
签名校验密钥否飞书机器人开启"签名校验"安全设置时必填,密文输入,支持点击眼睛图标临时预览,长度限制 100 字符
消息类型是支持纯文本、富文本、卡片消息
钉钉机器人​
字段是否必填说明
消息类型是支持文本消息、Markdown 消息、卡片消息
安全设置否选择加签密钥时展开密文输入框,需填写以 SEC 开头的密钥,支持点击眼睛图标预览,长度限制 100 字符
提示

钉钉机器人的安全设置在此仅支持无和加签密钥两种。"自定义关键词"和"IP 白名单"需在钉钉机器人侧配置,无需在通知对象中填写。

Webhook​
字段是否必填说明
请求方法固定固定为POST,不可修改
请求头否点击添加请求头逐条添加自定义 Header,最多 10 条,Key 限 64 字符、Value 限 1024 字符;Value 右侧带眼睛图标,可切换查看/隐藏原文,编辑态默认以 •••••••• 展示
HTTP 状态码是判断推送是否成功的规则之一,支持2xx(默认,200–299)、仅 200、自定义(手动填写允许的状态码,逗号分隔,如 200,201,204)
响应体匹配否点击添加匹配规则,配置 JSONPath 表达式和期望值,可添加多条,多条之间取 AND 关系,最多 10 条
信息

仅 HTTP 状态码正确不代表业务成功。为 Webhook 添加响应体匹配规则(如 JSONPath 填 $.errcode,期望值填 0),可识别目标系统返回的业务层错误,避免误判发送成功。

测试发送​

在测试弹窗的输入框中填写测试内容(必填,限 200 字符),点击发送后展示测试结果:

  • 结果区:成功(绿色)/ 失败(红色),显示"【通知对象名称】测试消息发送成功 / 失败"
  • 响应体摘要:等宽字体展示原始响应体,超出限高部分可滚动查看
信息

成功判定逻辑为 HTTP 状态码符合规则 且 所有响应体匹配规则均满足,两者同时成立才展示为发送成功。

常见场景​

场景:统一管理多个企微群机器人 为"核心服务告警群"和"基础设施告警群"分别创建企微机器人类型通知对象,消息类型选择 Markdown。后续在通知策略中直接引用对应通知对象,修改 Webhook 地址只需在通知对象页操作一次,无需逐条修改告警规则。

场景:对接外部系统并识别业务层失败 类型选择 Webhook,认证信息通过请求头传入(如 Authorization: Bearer ${token})。成功判断规则中 HTTP 状态码选 2xx,并添加响应体匹配规则 $.code = 0。即使接口返回 200,只要响应体中 code 不为 0,也会被判定为发送失败。

场景:钉钉机器人加签校验 类型选择钉钉机器人,安全设置选择加签密钥,填写以 SEC 开头的密钥。保存后推送消息将自动携带签名,避免因钉钉群开启加签校验而导致消息被拦截。

注意事项​

注意

删除或禁用通知对象前,请确认当前没有告警规则或通知策略仍在引用它。禁用后关联的推送会被静默跳过而不会报错,容易被忽略。

危险

删除通知对象为不可逆操作,删除后关联的通知策略将无法继续通过该渠道推送通知,请谨慎操作。