使用场景
系统在以下场景分派故障时会使用模板:系统使用 Golang 模板语法 解析数据,支持逻辑判断、循环、pipeline 及常用函数。更多函数请参考 sprig 函数库。
配置模板
1
创建自定义模板
进入 模板管理 页面,点击 创建自定义模板 或 复制默认模板
2
编辑模板内容
按通知渠道编辑对应内容,可引用下方变量列表中的字段
3
保存模板
点击 保存 完成创建
应用模板
变量引用
引用示例
Incident 变量
故障对象的完整变量列表:关联对象
Person - 人员信息
Person - 人员信息
Assignment - 分派配置
Assignment - 分派配置
Responder - 处理人
Responder - 处理人
Alert - 告警详情
Alert - 告警详情
常见问题
如何知道 Labels 有哪些标签?
如何知道 Labels 有哪些标签?
- 手动创建的故障没有标签
- 自动创建的故障存在标签,与合入的第一条告警的标签相同
配置了自定义模板,实际却使用了默认模板?
配置了自定义模板,实际却使用了默认模板?
创建自定义模板时,系统使用 mock 数据检查语法。mock 数据覆盖场景有限,实际运行时可能渲染失败,系统将使用默认模板兜底。
故障标题含有字符转义(如 >)?
故障标题含有字符转义(如 >)?
使用
toHtml 函数处理:如何转换时间格式?
如何转换时间格式?
如何在 for 循环内部引用外部变量?
如何在 for 循环内部引用外部变量?
在外部变量前增加
$:如何提取带 . 的字段值(如 obj.instance)?
如何提取带 . 的字段值(如 obj.instance)?
使用
index 函数:如何提取关联告警中的 label 并去重?
如何提取关联告警中的 label 并去重?
如何遍历并打印 Labels?
如何遍历并打印 Labels?
如何从 JSON 字段中提取信息?
如何从 JSON 字段中提取信息?
使用
jsonGet 函数从合法 JSON 中按 path 提取值。语法参考 gjson.dev。如何在发送应用消息时携带图片?
如何在发送应用消息时携带图片?
通过 imageSrcToURL 获取图片 URL
imageSrcToURL 函数用于将图片的Src 属性转换为可访问的 URL。参数说明:$root:根上下文对象Src:图片源,可以是image_key或 http/https URL
- 如果
Src是从图片上传界面获取的image_key,会转换为可访问的 URL(短期有效) - 如果
Src是 http/https 地址,直接返回该地址
通过 transferImage 上传图片到第三方平台
transferImage 函数用于将图片转换并上传到第三方通知平台。参数说明:$root:根上下文对象Src:图片源,可以是image_key或 http/https URL
- 最大图片大小:10 MB
- 支持格式:JPG、JPEG、PNG、WEBP、GIF、BMP、ICO、TIFF、HEIC
如何使用逻辑运算?
如何使用逻辑运算?
如何查阅更多函数?
如何查阅更多函数?
- 函数列表:functions.go
- 使用示例:查看对应的
_test.go文件,如 date_test.go
渠道模板
不同通知渠道支持的模板格式和限制不同。- 飞书应用
- 钉钉应用
- 企业微信应用
- Slack 应用
- Microsoft Teams
需预先配置 飞书集成。支持消息卡片格式,系统会自动删除因标签不存在导致的渲染空行。默认模板(渲染全部标签):
精简模板(仅展示关键标签):

飞书应用通知效果
卡片字段与底部操作按钮
编辑飞书应用模板时,正文内容 旁的 附加信息 页签提供卡片字段开关面板(面板提示「以下内容由系统渲染,可通过开关控制是否展示在消息底部。」),用于控制协作空间、暂缓截止时间、严重程度、聚合告警数、处理人员、详情按钮、AI 分析共 7 个系统字段是否渲染在卡片底部。其中 创建作战室 开关在飞书应用、钉钉应用、Slack 应用模板中均可配置(分别对应字段feishu_app_war_room_enabled、dingtalk_app_war_room_enabled、slack_app_war_room_enabled,默认关闭,开启后需保存模板生效)。开关文案即 创建作战室,面板中的说明为「开启后,满足建群条件时,在卡片底部展示独立的创建作战室按钮。」- 开启:故障未关闭、未创建作战室且存在处理人员时,对应渠道的故障卡片底部会展示独立的 👥 创建作战室 按钮,点击按钮即可发起建群
- 关闭:卡片底部不展示该按钮
incident_card_closed_action_apps 为字符串数组,存放已开启该能力的渠道 key(如 ["feishu_app"]),默认关闭(数组为空即关闭),开启后需保存模板生效。- 开启:面板说明为「已开启,故障关闭后 3 天内可从消息卡片中执行已配置的自定义操作,超过有效期请进入详情页执行。」故障关闭后 3 天内已配置的自定义操作仍可从消息卡片直接执行,超过 3 天需进入故障详情页执行
- 关闭:面板说明为「已关闭,故障关闭后将隐藏消息卡片中的自定义操作入口,仍可进入详情页执行。」故障关闭后消息卡片不再展示自定义操作入口,仍需进入故障详情页执行
机器人模板
群聊机器人支持的模板格式。- 飞书机器人
- 钉钉机器人
- 企业微信机器人
- Slack 机器人
- Telegram 机器人
支持消息卡片、富文本和普通文本三种格式。消息最大 4000 字节,超出后截断。
消息卡片(msg_type: interactive)
消息卡片(msg_type: interactive)
富文本(msg_type: post)
富文本(msg_type: post)
普通文本
普通文本
其他渠道
- 短信
- 语音
- 邮件
默认模板:
延伸阅读
配置分派策略
定义故障的通知规则和升级机制
配置个人偏好
自定义通知时段和渠道偏好




