夜莺 v7.beta11 发版，优化钉钉、企微、飞书通知

巴辉特 2024-06-14 00:08:08

夜莺之前的版本也支持钉钉、企微、飞书通知，不过整体逻辑设计的比较绕，这个版本提供了一个更直观的配置方式，顺带优化了 at 人的功能，当然，夜莺未来会重构整个告警通知逻辑，引入 pipeline 的能力，届时会提供更好的通知配置方式，现阶段的话，算是一个过渡的优化版本。

升级方法

从 v6 版本开始，程序自动创建表结构，所以 v6、v7 的各个小版本之间升级，相对容易，整体逻辑是：

1.备份，包括数据库、二进制、配置文件、integrations目录，以防万一
2.下载新版本解压，修改配置文件中的数据库连接地址、redis连接地址、时序库连接地址等个性化信息
3.停掉老版本，启动新版本（建议新老版本使用不同的安装目录，都保留不删，建个软链指向当前使用的版本）

配置方式

新版本可以直接在告警规则里配置企微、钉钉、飞书等机器人的 webhook 地址，进而直接实现告警通知效果，样例如下：

夜莺 v7.beta11 发版，优化钉钉、企微、飞书通知 - 配置方式

这里我没有配置通知媒介，也没有配置告警接收组，但是配置了回调地址，这个回调地址就是钉钉机器人（使用关键字认证方式，关键字写的 20）的回调地址，除了 access_token 参数之外，还手工加了一个 ats 的参数，表示我要 at 的人，钉钉 at 人就直接写人的手机号就可以了，如果是 at 多个人，就用逗号分隔多个手机号。

如果是老版本，既然没有配置通知媒介和接收组，肯定就不会发告警通知了。但是新版本会自动识别回调地址，发现回调地址是钉钉、企微、飞书的地址，就会自动发通知，比如我的钉钉提醒如下：

夜莺 v7.beta11 发版，优化钉钉、企微、飞书通知 - 钉钉提醒

点开消息之后，具体通知的内容如下：

夜莺 v7.beta11 发版，优化钉钉、企微、飞书通知 - 通知内容

我这个钉钉的通知模板，用的是下面的模板，大家可以参考一下：

#### {{if .IsRecovered}}<font color="#008800">💚{{.RuleName}}</font>{{else}}<font color="#FF0000">💔{{.RuleName}}</font>{{end}}

---
{{$time_duration := sub now.Unix .FirstTriggerTime }}{{if .IsRecovered}}{{$time_duration = sub .LastEvalTime .FirstTriggerTime }}{{end}}
- **告警级别**: {{.Severity}}级
{{- if .RuleNote}}
- **规则备注**: {{.RuleNote}}
{{- end}}
{{- if not .IsRecovered}}
- **当次触发时值**: {{.TriggerValue}}
- **当次触发时间**: {{timeformat .TriggerTime}}
- **告警持续时长**: {{humanizeDurationInterface $time_duration}}
{{- else}}
{{- if .AnnotationsJSON.recovery_value}}
- **恢复时值**: {{formatDecimal .AnnotationsJSON.recovery_value 4}}
{{- end}}
- **恢复时间**: {{timeformat .LastEvalTime}}
- **告警持续时长**: {{humanizeDurationInterface $time_duration}}
{{- end}}
- **告警事件标签**:
{{- range $key, $val := .TagsMap}}
{{- if ne $key "rulename" }}
  - `{{$key}}`: `{{$val}}`
{{- end}}
{{- end}}