bandsintown/alertmanager

Alertmanager Docker镜像文档

镜像概述和主要用途

Alertmanager是Prometheus生态系统的重要组件，负责处理由Prometheus服务器等客户端应用发送的告警。它能够对告警进行 deduplication（去重）、grouping（分组）和 routing（路由），将告警发送到邮件、PagerDuty、OpsGenie等接收器，并支持告警的 silencing（静默）和 inhibition（抑制）。

本镜像基于Linux Alpine构建，核心特点是集成Consul和Consul Template，实现Alertmanager配置的动态管理，尤其支持动态添加接收器（receivers），通过Consul键值存储管理alertmanager.yml配置文件。

核心功能和特性

• 轻量级基础：基于Linux Alpine，镜像体积小，资源占用低
• 动态配置：通过Consul和Consul Template实现配置动态更新，无需重启服务
• 完整告警处理：支持告警去重、分组、路由、静默和抑制
• 多接收器支持：兼容邮件、PagerDuty等多种告警接收器
• 灵活配置管理：通过Consul键值对管理全局配置、路由规则、接收器、抑制规则和模板

使用场景和适用范围

• Prometheus监控环境中的告警管理中心
• 需要动态调整告警配置的场景（如频繁变更接收器或路由规则）
• 多团队协作环境下的告警分级路由
• 需要集中管理告警抑制规则和静默策略的场景

配置说明

通过Consul配置

要通过Consul管理Alertmanager配置，需创建以下Consul键：

• 全局配置（global）
• 路由规则（routes）
• 接收器配置（receivers）
• 抑制规则（inhibit_rules）
• 模板（templates）

可通过运行docker-compose up -d查看consulator.yml中的配置示例。

配置文件示例

以下是涵盖YAML配置格式主要方面的示例，完整配置文档参见https://prometheus.io/docs/alerting/configuration/%EF%BC%9A

yaml
global:
  # 邮件通知使用的SMTP服务器和发件人
  smtp_smarthost: 'localhost:25'
  smtp_from: 'alertmanager@example.org'

# 所有入站告警的根路由
route:
  # 根路由必须配置接收器，用于接收不匹配任何子路由的告警
  receiver: 'team-X-mails'

  # 用于对入站告警进行分组的标签
  group_by: ['alertname', 'cluster']

  # 新告警组创建后，等待至少'group_wait'时间再发送初始通知
  group_wait: 30s

  # 首次通知发送后，等待'group_interval'时间再发送同一组的新告警
  group_interval: 5m

  # 告警成功发送后，等待'repeat_interval'时间再重发
  repeat_interval: 3h

  # 子路由树
  routes:
  # 对服务标签进行正则匹配的路由
  - match_re:
      service: ^(foo1|foo2|baz)$
    receiver: team-X-mails

    # 服务的关键告警子路由
    routes:
    - match:
        severity: critical
      receiver: team-X-pager

  - match:
      service: files
    receiver: team-Y-mails

    routes:
    - match:
        severity: critical
      receiver: team-Y-pager

  # 数据库服务告警路由
  - match:
      service: database

    receiver: team-DB-pager
    # 按告警名称、集群和数据库进行分组
    group_by: [alertname, cluster, database]

    routes:
    - match:
        owner: team-X
      receiver: team-X-pager

    - match:
        owner: team-Y
      receiver: team-Y-pager


# 抑制规则：当某个告警触发时，抑制另一组告警
inhibit_rules:
- source_match:
    severity: 'critical'
  target_match:
    severity: 'warning'
  # 当告警名称相同时应用抑制
  equal: ['alertname']


receivers:
- name: 'team-X-mails'
  email_configs:
  - to: 'team-X+alerts@example.org'

- name: 'team-X-pager'
  email_configs:
  - to: 'team-X+alerts-critical@example.org'
  pagerduty_configs:
  - service_key: <team-X-key>

- name: 'team-Y-mails'
  email_configs:
  - to: 'team-Y+alerts@example.org'

- name: 'team-Y-pager'
  pagerduty_configs:
  - service_key: <team-Y-key>

- name: 'team-DB-pager'
  pagerduty_configs:
  - service_key: <team-DB-key>

部署示例

Docker Compose部署

使用以下docker-compose.yml配置启动服务：

yaml
version: '3'
services:
  alertmanager:
    image: docker.xuanyuan.run/bandsintown/alertmanager
    ports:
      - "9093:9093"
    environment:
      - CONSUL_HTTP_ADDR=consul:8500
    depends_on:
      - consul

  consul:
    image: docker.xuanyuan.run/consul:latest
    ports:
      - "8500:8500"

启动命令：

bash
docker-compose up -d

架构

!https://raw.githubusercontent.com/prometheus/alertmanager/4e6695682acd2580773a904e4aa2e3b927ee27b7/doc/arch.jpg

参考链接

• http://prometheus.io/docs/alerting/alertmanager/
• https://github.com/bandsintown/docker-alertmanager
• https://hub.docker.com/r/bandsintown/alertmanager/