通知媒介

本章覆盖：通知渠道 / 通知模版。 通知媒介负责把告警"送达到人":通知渠道 定义推送到哪里(企业微信 / 钉钉 / 飞书 / Webhook),通知模版 定义消息长什么样。二者与告警规则解耦——规则只需勾选渠道,平台在告警触发时按渠道格式与模版内容自动转发,实现多渠道、可定制的告警触达。

通知渠道

. 功能简介

通知渠道(机器人)是告警的推送出口。创建渠道后平台会生成一个回调地址,在「告警规则」中勾选该渠道即可自动注入回调;告警触发时由本平台按对应渠道(企业微信 / 钉钉 / 飞书 / Webhook)的格式转发消息。

. 进入路径

左侧导航栏 通知媒介 → 通知渠道,或直接访问 /notify/robots。

. 界面总览

页面为通知渠道列表,顶部有使用说明,右上角提供「新建通知渠道」入口。

. 界面元素说明

渠道列表字段:

字段	含义
名称	渠道名称
渠道	渠道类型(企业微信 / 钉钉 / 飞书 / Webhook,带图标)
回调地址(填入告警规则)	平台生成的回调地址,可一键复制,用于告警规则勾选
启用	行内开关,启用 / 停用该渠道
操作	编辑 / 删除

新建通知渠道抽屉字段:

字段	含义
类型	企业微信 / 钉钉 / 飞书 / Webhook
名称	渠道名称
Webhook 地址	目标渠道的机器人 Webhook 地址
加签密钥	仅钉钉 / 飞书需要,填「加签」安全设置中的密钥;其它渠道不显示此项
关联模版	选择消息模版,留空则用内置默认模版
启用	是否启用

. 操作步骤

1. 点击右上角 新建通知渠道 打开抽屉。
2. 选择 类型(如 企业微信)。
3. 填写 名称(如 wechat-sre-oncall)。
4. 粘贴目标机器人的 Webhook 地址。
5. 若类型为钉钉或飞书,填写 加签密钥(其它类型无此项)。
6. (可选)在 关联模版 选择一个消息模版,留空则用内置默认模版。
7. 确认 启用 打开,点击 创建;成功后提示"通知渠道已创建,回调地址已生成"。
8. 回到列表复制该渠道的 回调地址,或直接在告警规则的「通知渠道」中勾选它即可。

. 常见问题 / 注意事项

• 加签密钥仅钉钉 / 飞书需要:企业微信与 Webhook 无需填写,抽屉也不会显示该项。
• 渠道与规则解耦:渠道创建后需在告警规则里勾选才会真正推送;单独创建不会自动关联任何规则。
• 删除影响:删除渠道后,引用它的告警规则将不再向其推送,请先确认无在用规则。
• 新建、编辑、删除及行内启用开关需 notify:write 权限。

通知模版

. 功能简介

通知模版定义告警消息的内容与排版。模版采用 Go text/template 语法,可引用规则名、级别、状态、触发时间、触发值、标签等字段,实现符合团队习惯的消息格式。模版创建后可在通知渠道中关联使用。

. 进入路径

左侧导航栏 通知媒介 → 通知模版,或直接访问 /notify/templates。

. 界面总览

页面以卡片形式展示已有模版,每张卡片显示模版名、正文预览与变量个数,右上角提供「新建模版」入口。

. 界面元素说明

模版卡片:

元素	含义
模版名	模版名称
正文预览	模版内容(为空显示"(默认模版)")
N 个变量	正文中不同 {{ 变量 }} 占位的数量
编辑 / 删除	卡片底部操作

新建模版抽屉字段:

字段	含义
模版名称	模版名称(如 default-zh)
模版内容	Go text/template 正文;留空则使用内置默认模版

可用字段:RuleName(规则名)、SeverityLabel(级别文案)、StatusLabel(状态文案)、TriggerTimeStr(触发时间)、TriggerValue(当前值)、Tags(标签列表)、TagsMap(标签映射)、Annotations(附加信息)、RuleNote(规则说明)。

. 操作步骤

1. 点击右上角 新建模版 打开抽屉。

2. 填写 模版名称(如 default-zh)。

3. 在 模版内容 中编写正文,引用上述字段。新建时会预置一份默认模版作为起点,例如:

   【{{.SeverityLabel}}】{{.RuleName}}
   状态：{{.StatusLabel}}
   时间：{{.TriggerTimeStr}}
   当前值：{{.TriggerValue}}
   标签：{{range .Tags}}{{.}} {{end}}
   {{if .RuleNote}}说明：{{.RuleNote}}{{end}}

4. 点击 创建 保存。

5. 回到「通知渠道」,在目标渠道的 关联模版 中选择该模版即可生效。

. 常见问题 / 注意事项

• 语法为 Go text/template:变量以 {{.字段名}} 引用,可使用 range、if 等控制结构;字段名区分大小写。
• 留空即用默认模版:模版内容留空时,渠道会回退到内置默认模版。
• 删除影响:删除模版后,引用它的渠道将回退到默认模版。
• 新建、编辑、删除模版需 notify:write 权限。