概述
通过引用告警标签、属性的变量,实现对故障的严重程度、标题和描述等信息的修改与定制。主要应用在两种场景:Event API 上报
通过告警 Event API 上报自定义告警事件时,可以使用
title_rule 字段自定义告警的标题。告警 Pipeline
在告警 Pipeline 中引用变量,实现对告警的严重程度、标题和描述等信息的修改。
Event API 示例
title_rule
指定
resource 和 check 标签作为告警标题。告警 Pipeline 示例

变量引用方式
通过 ${var} 引用标签
以 [TPL] 作为前缀,使用 ${} 来引用变量,变量内容将从标签中提取,提取不到使用 <no value> 替代。
| 规则 | 标签值 | 生成内容 |
|---|---|---|
[TPL]${resource} / ${check} | {"resource": "127.0.0.1", "check": "cpu idle low"} | 127.0.0.1 / cpu idle low |
[TPL]${resource} / ${check} | {"resource": "127.0.0.1"} | 127.0.0.1 / <no value> |
[TPL]${resource} / 主机宕机 | {"resource": "127.0.0.1"} | 127.0.0.1 / 主机宕机 |
通过 Golang 模版语法引用
以[TPL] 作为前缀,使用 {{}} 来引用变量(可以引用标签和属性),提取不到使用 <no value> 替代。
| 规则 | 变量值 | 生成内容 |
|---|---|---|
[TPL]{{.Labels.resource}} / {{.Labels.check}} | {"resource": "127.0.0.1", "check": "cpu idle low"} | 127.0.0.1 / cpu idle low |
[TPL]{{.Labels.resource}} / {{.Labels.check}} | {"resource": "127.0.0.1"} | 127.0.0.1 / <no value> |
[TPL]{{.EventSeverity}} / 主机宕机 | {"EventSeverity": "Warning"} | Warning / 主机宕机 |
支持引用的属性列表
| 字段 | 类型 | 说明 |
|---|---|---|
| Title | string | 标题 |
| Description | string | 描述 |
| EventSeverity | string | 严重程度 |
常见问题
使用标签动态生成标题,如果标签不存在怎么办?
使用标签动态生成标题,如果标签不存在怎么办?
取决于您使用哪一种变量获取方式,标题可能会保留原始的变量信息或使用
<no value> 替代。