portworx/alertmanager

Prometheus Alertmanager 镜像文档

镜像概述

Prometheus Alertmanager是Prometheus监控生态系统的核心组件，专门用于处理Prometheus服务器生成的告警。它接收来自Prometheus的告警信息，通过去重、分组、路由等机制，将告警准确、高效地分发到指定的通知接收端（如邮件、Slack、PagerDuty等），是构建企业级监控告警系统的关键组件。

核心功能与特性

• 告警分组：支持基于标签（labels）将告警按服务类型、环境、严重级别等维度分组，避免告警风暴。
• 告警去重：自动识别并过滤重复告警，确保同一事件不会多次触发通知。
• 灵活路由：通过路由树（route tree）配置，基于告警标签和属性将不同类型的告警路由到对应接收者。
• 静默管理：支持配置静默规则（silences），临时抑制特定标签组合的告警通知。
• 模板化通知：提供Go模板支持，可自定义告警通知内容格式，包含告警详情、触发条件、标签等信息。
• 高可用性：支持集群部署，通过gossip协议实现配置同步和高可用，确保服务稳定运行。

使用场景

• 企业监控系统：集中管理多服务、多环境的监控告警，确保运维人员及时接收关键告警。
• 云原生应用监控：在Kubernetes等容器平台中，配合Prometheus监控容器化应用，将告警分发到团队协作工具。
• IT基础设施监控：监控服务器、网络设备、数据库等基础设施，通过Alertmanager将告警发送到邮件或短信网关。
• 多团队协作：根据告警标签将不同服务的告警路由到对应负责团队的通知渠道（如开发团队的Slack频道、运维团队的邮件组）。

使用方法与配置说明

获取镜像

从quay.io仓库拉取官方镜像：

bash
docker pull quay.io/prometheus/alertmanager:latest

基本运行示例

简单启动（默认配置）

bash
docker run -d --name alertmanager -p 9093:9093 quay.io/prometheus/alertmanager:latest

默认监听9093端口，可通过http://localhost:9093访问Web UI，使用内置默认配置文件。

挂载自定义配置文件

Alertmanager核心配置通过alertmanager.yml文件定义，需挂载自定义配置文件到容器：

1. 创建本地配置文件alertmanager.yml（示例配置）：

yaml
global:
  resolve_timeout: 5m  # 告警从firing转为resolved状态后的超时时间

route:
  group_by: ['alertname']  # 按alertname分组
  group_wait: 10s  # 组内首个告警触发后等待10s再发送（聚合同组告警）
  group_interval: 10s  # 同组告警再次发送的间隔
  repeat_interval: 1h  # 重复发送相同告警的间隔
  receiver: 'default-receiver'  # 默认接收者

receivers:
- name: 'default-receiver'
  email_configs:  # 邮件接收配置示例
  - to: 'admin@example.com'
    send_resolved: true  # 告警恢复时发送通知
    smtp_from: 'alertmanager@example.com'
    smtp_smarthost: 'smtp.example.com:587'
    smtp_auth_username: 'alertmanager@example.com'
    smtp_auth_password: 'your-smtp-password'
    smtp_require_tls: true

inhibit_rules:  # 抑制规则（可选）
  - source_match:
      severity: 'critical'
    target_match:
      severity: 'warning'
    equal: ['alertname', 'dev', 'instance']  # critical告警触发时抑制同标签的warning告警

2. 启动容器并挂载配置文件：

bash
docker run -d --name alertmanager \
  -p 9093:9093 \
  -v /path/to/alertmanager.yml:/etc/alertmanager/alertmanager.yml \
  quay.io/prometheus/alertmanager:latest

配置文件结构说明

alertmanager.yml包含以下核心配置段：

• global：全局配置，如超时时间、SMTP服务器、API URL等通用参数。
• route：路由规则，定义告警分组、发送间隔及默认接收者。
• receivers：接收者配置，定义告警的通知渠道（邮件、Slack、Webhook等）。
• inhibit_rules：抑制规则，定义在特定条件下抑制某些告警的触发。

环境变量

支持通过环境变量覆盖部分配置：

• ALERTMANAGER_CONFIG_FILE：指定配置文件路径（默认：/etc/alertmanager/alertmanager.yml）
• ALERTMANAGER_STORAGE_PATH：告警状态数据存储路径（默认：/alertmanager）
• WEB_LISTEN_ADDRESS：Web服务监听地址（默认：:9093）

示例（修改监听端口）：

bash
docker run -d --name alertmanager \
  -p 9094:9094 \
  -e WEB_LISTEN_ADDRESS=":9094" \
  quay.io/prometheus/alertmanager:latest

持久化存储

Alertmanager状态数据（如静默规则、告警状态）默认存储在/alertmanager目录，建议挂载本地目录持久化数据：

bash
docker run -d --name alertmanager \
  -p 9093:9093 \
  -v /path/to/alertmanager.yml:/etc/alertmanager/alertmanager.yml \
  -v /path/to/alertmanager-data:/alertmanager \
  quay.io/prometheus/alertmanager:latest

与Prometheus集成

需在Prometheus配置文件prometheus.yml中指定Alertmanager地址，使Prometheus将告警发送至Alertmanager：

yaml
alerting:
  alertmanagers:
  - static_configs:
    - targets:
      - 'alertmanager:9093'  # Alertmanager容器地址（需在同一网络或使用IP）

健康检查

提供健康检查接口：

• 服务健康状态：http://localhost:9093/-/healthy
• 服务就绪状态：http://localhost:9093/-/ready

总结

Prometheus Alertmanager通过灵活的配置和丰富的功能，实现了监控告警的分组、去重、路由和分发，适用于企业监控系统、云原生应用监控、IT基础设施监控等场景。通过Docker部署可快速搭建服务，配合自定义配置文件满足个性化告警策略需求。