hai046/alertmanager

Prometheus Alertmanager 企业***消息扩展版

镜像概述

本镜像基于Prometheus Alertmanager构建，扩展了对企业***消息的支持，允许将监控告警通过企业微信API发送到指定群组或用户，提升告警通知的及时性和可达性。源代码托管于https://github.com/hai046/alertmanager%E3%80%82

核心功能与特性

• 企业*消息支持**：通过企业微信API发送告警消息到指定群组，支持群聊创建和成员指定
• 灵活的告警路由：支持按标签分组、设置等待时间、重复间隔等路由策略
• 模板化消息：支持通过模板自定义消息格式，提供默认模板示例
• 告警抑制规则：可配置告警抑制规则，避免重复或冗余告警
• 配置示例：提供完整的高可用配置示例，配置项前缀为wechat_，详见https://github.com/hai046/alertmanager/tree/master/examples/ha

使用场景

• 企业级监控系统告警通知，需通过企业微信进行群内协作处理
• 需要将Prometheus监控告警集中发送到指定项目组或运维群组
• 需自定义告警消息格式，包含关键监控指标和上下文信息
• 需实现告警的分组、抑制和重复通知控制

使用方法

配置说明

核心配置文件为alertmanager.yml，主要包含以下部分：

全局配置（global）

yaml
global:
  wechat_api_url: 'https://qyapi.weixin.qq.com/cgi-bin/'  # 企业微信API地址
  wechat_api_secret: '#wechat_api_secret'                # 企业微信应用密钥
  wechat_api_corp_id: '#wechat corp id'                  # 企业微信企业ID
  resolve_timeout: 1m                                    # 告警解决超时时间

路由配置（route）

yaml
route:
  group_by: ['application']       # 按标签分组
  group_wait: 30s                 # 组内第一个告警等待时间
  group_interval: 1m              # 组内新告警间隔时间
  repeat_interval: 1m             # 重复告警间隔时间
  receiver: 'groupWechat'         # 默认接收器

接收器配置（receivers）

支持***和个人消息发送，示例：

yaml
receivers:
  - name: 'groupWechat'  # 群组接收器
    wechat_configs:
      - send_resolved: true               # 发送告警解决通知
        to_tag: '服务报警'                 # 标签标识
        message_type: 'groupMarkdown'     # 消息类型（群Markdown）
        message: '{{ template "wechat.default.groupMessage" . }}'  # 消息模板
        agent_id: '#wechat agent id'      # 企业微信应用ID
        group_title: '{{ template "wechat.default.groupTitle" . }}'  # 群聊标题
        group_users:                      # 群成员列表
          - haizhu
          - FengYu
  - name: 'wechat'       # 个人接收器
    wechat_configs:
      - send_resolved: true
        to_user: "xxx"                    # 接收用户ID
        to_tag: '服务报警'
        message_type: 'groupMarkdown'
        message: '{{ template "wechat.default.message" . }}'
        agent_id: '#wechat agent id'

告警抑制规则（inhibit_rules）

yaml
inhibit_rules:
  - source_match:
      severity: 'critical'  # 源告警级别
    target_match:
      severity: 'warning'   # 目标告警级别
    equal: ['alertname', 'dev', 'instance']  # 匹配标签

Docker部署示例

1. 单容器运行

bash
docker run -d \
  --name alertmanager-wechat \
  -p 9093:9093 \
  -v /path/to/alertmanager.yml:/etc/alertmanager/alertmanager.yml \
  -v /path/to/templates:/etc/alertmanager/config \
  ha046/alertmanager:latest

2. Docker Compose配置

yaml
version: '3'
services:
  alertmanager:
    image: ha046/alertmanager:latest
    container_name: alertmanager-wechat
    ports:
      - "9093:9093"
    volumes:
      - ./alertmanager.yml:/etc/alertmanager/alertmanager.yml
      - ./templates:/etc/alertmanager/config
    restart: always

测试方法

使用以下脚本发送测试告警：

bash
#!/usr/bin/env bash
alerts1='[
    {
        "labels": {
            "application": "app1",
            "instance": "instance1",
            "groupTitle": "微服务测试"
        },
        "startsAt": "2021-01-20T14:31:39.000Z",
        "endsAt": "2021-06-28T04:09:43.534Z",
        "annotations": {
            "summary": "summary info",
            "message": "message content"
        },
        "generatorURL": "http://example.com"
    }
]'
curl -XPOST -d"$alerts1" -H "Content-Type:application/json" http://localhost:9093/api/v2/alerts

执行脚本后，企业***将收到相应的告警通知。