mike2194/alertmanager

sinkingpoint/alertmanager 镜像文档

镜像概述

sinkingpoint/alertmanager是基于Prometheus Alertmanager的定制化镜像，核心特性是支持从文件读取PagerDuty告警路由所需的routing_key，而非通过配置文件硬编码或环境变量传递，提升敏感凭证管理的安全性。该镜像保持与原生Alertmanager的功能兼容性，可直接用于告警聚合、 deduplication、分组和路由至PagerDuty等通知渠道。

核心功能与特性

• 安全的routing_key管理：支持从外部文件加载PagerDuty routing_key，避免敏感凭证暴露在配置文件或环境变量中
• 原生Alertmanager兼容：完整保留Alertmanager的核心功能（告警分组、抑制、静默、路由规则等）
• 灵活集成：无缝对接PagerDuty告警通知系统，支持自定义告警模板
• 轻量级定制：在原生Alertmanager基础上最小化修改，保持镜像体积与性能优势

使用场景

• 企业级监控告警系统：需安全管理PagerDuty凭证的生产环境
• 多团队协作场景：不同团队通过独立文件管理各自的PagerDuty routing_key
• 合规性要求高的环境：需满足敏感信息隔离存储的安全合规场景
• 动态凭证更新：支持在不重启容器的情况下通过更新文件刷新routing_key（需配合配置重载机制）

使用方法

前提条件

1. 准备包含PagerDuty routing_key的文件（文件内容仅为routing_key字符串，无额外格式）
2. 准备Alertmanager配置文件（需在PagerDuty接收器配置中引用routing_key文件路径）

基本使用（docker run）

bash
docker run -d \
  --name alertmanager \
  -p 9093:9093 \
  -v /path/to/alertmanager.yml:/etc/alertmanager/alertmanager.yml \
  -v /path/to/pagerduty_routing_key:/etc/secrets/pagerduty_routing_key \
  sinkingpoint/alertmanager

参数说明：

• -v /path/to/alertmanager.yml:/etc/alertmanager/alertmanager.yml：挂载Alertmanager配置文件
• -v /path/to/pagerduty_routing_key:/etc/secrets/pagerduty_routing_key：挂载包含routing_key的文件（路径可自定义，需与配置文件中一致）

配置文件示例（alertmanager.yml）

在PagerDuty接收器配置中通过文件路径引用routing_key：

yaml
global:
  resolve_timeout: 5m

route:
  group_by: ['alertname']
  group_wait: 10s
  group_interval: 10s
  repeat_interval: 1h
  receiver: 'pagerduty'

receivers:
- name: 'pagerduty'
  pagerduty_configs:
  - service_key_file: '/etc/secrets/pagerduty_routing_key'  # 引用routing_key文件路径
    send_resolved: true

Docker Compose示例

yaml
version: '3'

services:
  alertmanager:
    image: sinkingpoint/alertmanager
    container_name: alertmanager
    ports:
      - "9093:9093"
    volumes:
      - ./alertmanager.yml:/etc/alertmanager/alertmanager.yml
      - ./pagerduty_routing_key:/etc/secrets/pagerduty_routing_key
    restart: unless-stopped

配置重载

修改配置文件或routing_key文件后，可通过以下命令触发配置重载，无需重启容器：

bash
docker kill -s SIGHUP alertmanager

注意事项

• routing_key文件权限：建议设置文件权限为600，仅容器内运行用户可读取
• 文件路径一致性：配置文件中的service_key_file路径需与容器内挂载路径完全一致
• 镜像版本：建议使用特定版本标签（如sinkingpoint/alertmanager:v0.25.0）而非latest，确保环境稳定性
• 日志查看：通过docker logs alertmanager检查配置加载状态及告警路由情况