【Prometheus】Alertmanager配置钉钉告警

本文介绍了部署Alertmanager及钉钉告警服务的详细步骤。首先提供了二进制和k8s两种部署Alertmanager的方式。随后详细讲解了钉钉告警服务的配置过程，包括下载prometheus-webhook-dingtalk组件、创建钉钉机器人、配置dingtalk服务等关键环节。文章还包含服务启动测试、Alertmanager对接钉钉告警的配置方法，并给出了完整的配置文件示例。通过本文指导，

A-刘晨阳

14754人浏览 · 2026-03-07 19:10:54

A-刘晨阳 · 2026-03-07 19:10:54 发布

👨‍🎓博主简介

🏅CSDN博客专家
🏅云计算领域优质创作者
🏅华为云开发者社区专家博主
🏅阿里云开发者社区专家博主
💊交流社区：运维交流社区欢迎大家的加入！
🐋 希望大家多多支持，我们一起进步！😄
🎉如果文章对你有帮助的话，欢迎点赞 👍🏻 评论 💬 收藏 ⭐️ 加关注+💗

一、部署Alertmanager

二进制部署Alertmanager

二进制部署Alertmanager可参考：Prometheus + Grafana + Alertmanager 实现邮件监控告警及配置告警信息

k8s部署Alertmanager

k8s部署Alertmanager可参考：k8s部署Prometheus + node_exporter + Grafana + Alertmanager

二、部署钉钉告警所需服务

2.1 prometheus-webhook-dingtalk 安装包下载

进入官方下载地址：prometheus-webhook-dingtalk，根据自己的平台及架构进行下载；

或直接使用wget命令进行下载（右击包名，复制链接地址）；

wget https://github.com/timonwong/prometheus-webhook-dingtalk/releases/download/v2.1.0/prometheus-webhook-dingtalk-2.1.0.linux-amd64.tar.gz

2.2 上传并解压服务

上传到服务器上
解压到/usr/local/alertmanager/下，改名为：dingtalk（路径和名称自己可以自定义，这里放到我安装的alertmanager下）

# 解压服务包
tar xf prometheus-webhook-dingtalk-2.1.0.linux-amd64.tar.gz 

# 移动并重命名目录名为dingtalk到/usr/local/alertmanager/下
mv prometheus-webhook-dingtalk-2.1.0.linux-amd64 /usr/local/alertmanager/dingtalk

2.3 创建钉钉群聊并添加自定义机器人

创建群聊：手机、电脑都可以
创建自定义机器人：电脑（手机会提示需要进行安全配置，需使用电脑端）

登录钉钉
创建群聊

选择好友，群归属可以选择自己的企业，也可以创建为普通群，这里我选择的是企业内部群，可根据自己需求选择

创建新的群聊 --> 群设置，可以修改群聊名称及群头像，这里自选

往下拉找到机器人

添加机器人，找到自定义

点击添加，可以给机器人添加名字（自定义）
选择加签 --> 复制加签里的内容（需要用到）

我已阅读并同意 --> 完成 --> 会出来一个Webhook，这个点击复制保存一下（需要用到） --> 点击完成

完成之后就可以看到有一个机器人了

请记住加签及Webhook的内容，忘记了也可以点击机器人进行查看，最好自己保存一份；

2.4 配置 dingtalk 配置文件

# 进入钉钉配置目录
cd /usr/local/alertmanager/dingtalk

# 复制一份配置文件
cp -ar config.example.yml config.yml

编辑配置

也可以直接复制下面内容到config.yml中；

# 全局超时配置
timeout: 5s

## 全局模板及模板路径配置
templates:
  - contrib/templates/legacy/template.tmpl
 
# 全局默认消息格式
default_message:
  title: '{{ template "legacy.title" . }}'
  text: '{{ template "legacy.content" . }}'
 
## 钉钉机器人目标配置（核心部分）
targets:
  webhook1:
    url: <粘贴Webhook的内容>
    secret: <粘贴加签的内容>

也可以配置多个webhook来区分，生产或者测试；

2.5 启动dingtalk服务并配置开机自启

写systemd管理启动脚本

vim /usr/lib/systemd/system/dingtalk.service

具体dingtalk.service内容，路径根据自己的情况修改；

[Unit]
Description=Prometheus DingTalk Webhook
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/usr/local/alertmanager/dingtalk
ExecStart=/usr/local/alertmanager/dingtalk/prometheus-webhook-dingtalk \
    --config.file=/usr/local/alertmanager/dingtalk/config.yml \
    --web.listen-address=:8060
Restart=always

[Install]
WantedBy=multi-user.target

启动dingtalk服务并配置开机自启

# 加载systemd配置
systemctl daemon-reload
# 配置开机自启并启动服务
systemctl enable --now dingtalk.service
# 确认服务是否启动正常
systemctl status dingtalk.service

查看端口是否正常：默认监听8060端口

如需修改端口，可以再启动时的配置中修改--web.listen-address=:8060的端口；

netstat -anput | grep 8060

2.6 测试配置是否成功

curl -X POST http://localhost:8060/dingtalk/webhook1/send   -H "Content-Type: application/json"   -d '{"status":"firing","alerts":[{"labels":{"alertname":"Test","instance":"localhost"},"annotations":{"summary":"测试告警"}}]}'

出现OK并接收到消息就没问题；

如果有问题可通过journalctl -u dingtalk -f命令来查看服务日志是否有报错；

三、配置 Alertmanager 添加钉钉告警

这里是基于我二进制部署的alertmanager的路径，可根据自己实际情况进行修改

# 进入alertmanager目录
cd /usr/local/alertmanager

# 修改alertmanager配置文件
vim /usr/local/alertmanager/alertmanager.yml

alertmanager 具体配置文件

global:   # 全局的配置
  resolve_timeout: 5m  # 解析的超时时间

route:    # 将告警具体怎么发送
  group_by: ['alertname']  # 根据标签进行分组
  group_wait: 10s          # 发送告警等待时间
  group_interval: 10s      # 发送告警邮件的间隔时间
  repeat_interval: 1h      # 重复的告警发送时间
  receiver: 'dingtalk'     # 接收者是谁，需和receivers中的name一致

receivers:                 # 将告警发送给谁
- name: 'dingtalk'
  webhook_configs:
    - url: 'http://172.16.11.230:8060/dingtalk/webhook1/send'
      send_resolved: true   # 开启恢复通知
inhibit_rules:   # 抑制告警
  - source_match:
      severity: 'critical'   # 当收到同一台机器发送的critical时候，屏蔽掉warning类型的告警
    target_match:
      severity: 'warning'
    equal: ['alertname', 'severity', 'instance']  # 根据这些标签来定义抑制

url中需注意：
url路由规则：http://<host>:<port>/dingtalk/<target_name>/send，target_name为dingtalk配置中的targets：的 webhook1（可自定义的）；

3.1 验证 alertmanger 配置文件

cd /usr/local/alertmanager/
./amtool check-config alertmanager.yml

3.2 重载alertmanager和Prometheus的配置

重载 alertmanager 配置

curl -lv -X POST http://localhost:9093/-/reload

重载 Prometheus 配置

curl -X POST http://localhost:9090/-/reload

3.3 通过Prometheus接口进行测试 - 模拟告警

curl -X POST http://localhost:9093/api/v2/alerts \
  -H "Content-Type: application/json" \
  -d '[{
    "labels": {
      "alertname": "TestDingTalk",
      "severity": "critical",
      "instance": "test-server-01"
    },
    "annotations": {
      "summary": "测试钉钉告警",
      "description": "这是一条测试消息，用于验证钉钉告警是否正常工作"
    },
    "startsAt": "2024-01-01T00:00:00Z"
  }]'

如下，正常收到信息，没问题

3.4 进行正常告警测试

需提前配置好告警规则；

告警测试

恢复告警测试

四、钉钉告警模板的优化

4.1 创建钉钉告警模板

vim /usr/local/alertmanager/dingtalk/contrib/templates/legacy/dingtalk.tmpl

路径可以自定义

{{ define "__subject" }}
[{{ .Status | toUpper }}{{ if eq .Status "firing" }}:{{ .Alerts.Firing | len }}{{ end }}]
{{ end }}

{{ define "__alert_list" }}{{ range . }}
---
**告警主题**: {{ .Annotations.summary }}

**告警类型**: {{ .Labels.alertname }}

**告警级别**: {{ .Labels.severity }}

**告警主机**: {{ .Labels.instance }}

**告警信息**: {{ .Annotations.description }}

**触发时间**: {{ .StartsAt.Format "2006-01-02 15:04:05" }}
{{ end }}{{ end }}

{{ define "__resolved_list" }}{{ range . }}
---
**恢复主题**: {{ .Annotations.summary }}

**告警类型**: {{ .Labels.alertname }}

**告警级别**: {{ .Labels.severity }}

**告警主机**: {{ .Labels.instance }}

**告警信息**: {{ .Annotations.description }}

**触发时间**: {{ .StartsAt.Format "2006-01-02 15:04:05" }}

**恢复时间**: {{ .EndsAt.Format "2006-01-02 15:04:05" }}
{{ end }}{{ end }}

{{ define "dingtalk.title" }}
{{ if eq .Status "firing" }}🔥【Prometheus告警】{{ .CommonLabels.alertname }}{{ else }}✅【Prometheus恢复】{{ .CommonLabels.alertname }}{{ end }}
{{ end }}

{{ define "dingtalk.content" }}
{{ if eq .Status "firing" }}🔥【Prometheus告警】{{ .CommonLabels.alertname }}{{ else }}✅【Prometheus恢复】{{ .CommonLabels.alertname }}{{ end }}
{{ if gt (len .Alerts.Firing) 0 }}
**==== 侦测到 {{ .Alerts.Firing | len }} 个故障 ====**
{{ template "__alert_list" .Alerts.Firing }}
{{ end }}

{{ if gt (len .Alerts.Resolved) 0 }}
**==== 已恢复 {{ .Alerts.Resolved | len }} 个故障 ====**
{{ template "__resolved_list" .Alerts.Resolved }}
{{ end }}
{{ end }}

{{ define "legacy.title" }}{{ template "dingtalk.title" . }}{{ end }}
{{ define "legacy.content" }}{{ template "dingtalk.content" . }}{{ end }}

4.2 修改dingtalk配置文件

vim /usr/local/alertmanager/dingtalk/config.yml

# 全局超时配置
timeout: 5s

## 全局模板及模板路径配置
templates:
  - /usr/local/alertmanager/dingtalk/contrib/templates/legacy/dingtalk.tmpl

# 全局默认消息格式
default_message:
  title: '{{ template "legacy.title" . }}'
  text: '{{ template "legacy.content" . }}'

## 钉钉机器人目标配置（核心部分）
targets:
  webhook1:
    url: <粘贴Webhook的内容>
    secret: <粘贴加签的内容>

主要修改了 全局模板及模板路径配置 ；

4.3 重启dingtalk

# 重启服务
systemctl restart dingtalk.service

# 确认服务是否启动正常
systemctl status dingtalk.service

4.4 测试模板是否可用

curl -X POST http://localhost:8060/dingtalk/webhook1/send \
  -H "Content-Type: application/json" \
  -d '{
    "receiver": "dingtalk",
    "status": "resolved",
    "alerts": [
      {
        "status": "resolved",
        "labels": {
          "alertname": "TestAlert",
          "severity": "critical",
          "instance": "192.168.1.100:9100"
        },
        "annotations": {
          "summary": "节点宕机超过1分钟",
          "description": "192.168.1.100 节点无法连接"
        },
        "startsAt": "2026-02-25T10:00:00.000Z",
        "endsAt": "2026-02-25T10:05:30.000Z"
      }
    ],
    "groupLabels": {
      "alertname": "TestAlert"
    },
    "commonLabels": {
      "alertname": "TestAlert",
      "severity": "critical",
      "instance": "192.168.1.100:9100"
    },
    "commonAnnotations": {
      "summary": "节点宕机超过1分钟"
    }
  }'

4.5 进行正常告警测试

需提前配置好告警规则；

告警测试

恢复告警测试

五、钉钉多个群组配置

在targets中配置多个target_name，一个target_name代表的一个群聊机器人；

比如：我创建了两个群聊，一个运维，一个开发的群
那么这两个群都需要添加一个机器人，然后获取到对应群聊的Webhook和加签的内容；
并在targets中配置两个target_name，将Webhook和加签的内容填到对应的target_name中；

targets:
  webhook1:
    url: <粘贴Webhook的内容>
    secret: <粘贴加签的内容>

  development:
    url: <粘贴Webhook的内容>
    secret: <粘贴加签的内容>

在Alertmanager配置中写URL为：
http://localhost:8060/dingtalk/webhook1/send 和 http://localhost:8060/dingtalk/development/send

六、多种通知方式同时触发

邮件+钉钉同时告警，主要注意的地方就是route的receiver和receivers的name要一致，一个receivers里可以有多个接收平台；

更多不同级别的告警分配不同人或平台进行告警请参考：Prometheus 之 Alertmanager配置说明及路由的使用；

松山湖开发者村综合服务平台

助力广东及东莞地区开发者，代码托管、在线学习与竞赛、技术交流与分享、资源共享、职业发展，成为松山湖开发者首选的工作与学习平台

更多推荐

用 Python 搭建本地 AI 问答系统：避开 90% 新手都会踩的环境坑

松山湖开发者村综合服务平台

网工必备 - 跨网络互联与安全传输需求隧道技术全解析（基于华为VRP系统）

MPLS VPN中隧道为底层承载，配置复杂度高，需配合BGP/VPN-instance使用。点对点静态配置，不支持自动发现；

松山湖开发者村综合服务平台

How to Use Firewalld Direct Rules for Advanced Packet Filtering on RHEL

【代码】How to Use Firewalld Direct Rules for Advanced Packet Filtering on RHEL。

松山湖开发者村综合服务平台

所有评论(0)

查看更多评论

A-刘晨阳

@liu_chen_yang

已为社区贡献6条内容