Skip to main content
版本要求:此功能需要 On-call 专业版及以上订阅。了解更多

使用场景

系统在以下场景分派故障时会使用模板:
系统使用 Golang 模板语法 解析数据,支持逻辑判断、循环、pipeline 及常用函数。更多函数请参考 sprig 函数库。
出于安全考虑,以下 sprig 函数已被禁用,在模板中使用会触发 function "xxx" not defined 解析错误:如需在模板中使用唯一标识,可改用故障变量(如 {{.IncidentID}}、{{.LabelsMD5}});如需引用环境信息,请通过告警标签或字段映射传入,不要在模板中读取宿主机环境变量。

配置模板

1

创建自定义模板

进入 模板管理 页面,点击 创建自定义模板 或 复制默认模板
2

编辑模板内容

按通知渠道编辑对应内容,可引用下方变量列表中的字段
3

保存模板

点击 保存 完成创建

应用模板

1

进入分派策略

前往 协作空间 → 分派策略,点击 编辑
2

选择模板

在策略配置中选择 按照哪个模板 进行通知
3

保存配置

点击 保存 完成配置。详见 配置分派策略

变量引用

引用示例

Incident 变量

故障对象的完整变量列表:

关联对象

常见问题

  • 手动创建的故障没有标签
  • 自动创建的故障存在标签,与合入的第一条告警的标签相同
前往 故障列表 → 查看故障详情,可以看到全部标签信息。
创建自定义模板时,系统使用 mock 数据检查语法。mock 数据覆盖场景有限,实际运行时可能渲染失败,系统将使用默认模板兜底。
建议在引用变量前先判断是否存在:
使用 toHtml 函数处理:
在外部变量前增加 $:
使用 index 函数:
使用 jsonGet 函数从合法 JSON 中按 path 提取值。语法参考 gjson.dev。

通过 imageSrcToURL 获取图片 URL

imageSrcToURL 函数用于将图片的 Src 属性转换为可访问的 URL。参数说明:
  • $root:根上下文对象
  • Src:图片源,可以是 image_key 或 http/https URL
处理逻辑:
  • 如果 Src 是从图片上传界面获取的 image_key,会转换为可访问的 URL(短期有效)
  • 如果 Src 是 http/https 地址,直接返回该地址
适用平台: 钉钉应用、Slack 应用使用示例:

通过 transferImage 上传图片到第三方平台

transferImage 函数用于将图片转换并上传到第三方通知平台。参数说明:
  • $root:根上下文对象
  • Src:图片源,可以是 image_key 或 http/https URL
限制条件:
  • 最大图片大小:10 MB
  • 支持格式:JPG、JPEG、PNG、WEBP、GIF、BMP、ICO、TIFF、HEIC
权限要求: 需要应用具备”获取与上传图片或文件资源”的权限适用平台: 飞书应用(Lark App)使用示例:

渠道模板

不同通知渠道支持的模板格式和限制不同。
需预先配置 飞书集成。支持消息卡片格式,系统会自动删除因标签不存在导致的渲染空行。默认模板(渲染全部标签):
飞书应用通知

飞书应用通知效果

精简模板(仅展示关键标签):

卡片字段与底部操作按钮

编辑飞书应用模板时,正文内容 旁的 附加信息 页签提供卡片字段开关面板(面板提示「以下内容由系统渲染,可通过开关控制是否展示在消息底部。」),用于控制协作空间、暂缓截止时间、严重程度、聚合告警数、处理人员、详情按钮、AI 分析共 7 个系统字段是否渲染在卡片底部。其中 创建作战室 开关在飞书应用、钉钉应用、Slack 应用模板中均可配置(分别对应字段 feishu_app_war_room_enabled、dingtalk_app_war_room_enabled、slack_app_war_room_enabled,默认关闭,开启后需保存模板生效)。开关文案即 创建作战室,面板中的说明为「开启后,满足建群条件时,在卡片底部展示独立的创建作战室按钮。」
  • 开启:故障未关闭、未创建作战室且存在处理人员时,对应渠道的故障卡片底部会展示独立的 👥 创建作战室 按钮,点击按钮即可发起建群
  • 关闭:卡片底部不展示该按钮
故障关闭后保留自定义操作 开关在飞书应用、钉钉应用、Slack 应用、Microsoft Teams 模板中均提供,企业微信应用模板不提供(面板不渲染该开关)。对应字段 incident_card_closed_action_apps 为字符串数组,存放已开启该能力的渠道 key(如 ["feishu_app"]),默认关闭(数组为空即关闭),开启后需保存模板生效。
  • 开启:面板说明为「已开启,故障关闭后 3 天内可从消息卡片中执行已配置的自定义操作,超过有效期请进入详情页执行。」故障关闭后 3 天内已配置的自定义操作仍可从消息卡片直接执行,超过 3 天需进入故障详情页执行
  • 关闭:面板说明为「已关闭,故障关闭后将隐藏消息卡片中的自定义操作入口,仍可进入详情页执行。」故障关闭后消息卡片不再展示自定义操作入口,仍需进入故障详情页执行
加上上文 7 个卡片字段开关,飞书应用、钉钉应用、Slack 应用模板的 附加信息 面板各有 9 个开关,Microsoft Teams 模板 7 个,企业微信应用模板 6 个(见下方各渠道模板说明)。同时,飞书应用卡片底部的操作区已调整:更多操作(占位文案即「更多操作」)改为下拉选择菜单,菜单内为自定义操作、暂缓时长与取消认领等选项,作战室按钮不再位于该菜单中。

机器人模板

群聊机器人支持的模板格式。
支持消息卡片、富文本和普通文本三种格式。消息最大 4000 字节,超出后截断。

其他渠道

默认模板:

延伸阅读

配置分派策略

定义故障的通知规则和升级机制

配置个人偏好

自定义通知时段和渠道偏好