Go应用中Prometheus Alertmanager 0.24.0搭建文档及升级问题咨询

一、下载与解压 #

• 下载对应架构的安装包（以Linux amd64为例）：

  wget https://github.com/prometheus/alertmanager/releases/download/v0.24.0/alertmanager-0.24.0.linux-amd64.tar.gz
  

• 解压至目标目录：

  tar -zxvf alertmanager-0.24.0.linux-amd64.tar.gz
  mv alertmanager-0.24.0.linux-amd64 /usr/local/alertmanager
  

二、核心配置文件示例 #

创建或修改/usr/local/alertmanager/alertmanager.yml，基础配置如下：

global:
  resolve_timeout: 5m
  smtp_smarthost: 'smtp.example.com:587'
  smtp_from: 'alertmanager@example.com'
  smtp_auth_username: 'alertmanager@example.com'
  smtp_auth_password: 'your_password'

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

receivers:
- name: 'email-receiver'
  email_configs:
  - to: 'admin@example.com'
    send_resolved: true

inhibit_rules:
- source_match:
    severity: 'critical'
  target_match:
    severity: 'warning'
  equal: ['alertname', 'dev', 'instance']

三、启动服务 #

方式1：直接启动（前台运行） #

cd /usr/local/alertmanager
./alertmanager --config.file=alertmanager.yml

方式2：Systemd 服务托管（推荐） #

创建/etc/systemd/system/alertmanager.service文件：

[Unit]
Description=Alertmanager Service
After=network.target

[Service]
User=root
ExecStart=/usr/local/alertmanager/alertmanager --config.file=/usr/local/alertmanager/alertmanager.yml
Restart=on-failure

[Install]
WantedBy=multi-user.target

启动并设置开机自启：

systemctl daemon-reload
systemctl start alertmanager
systemctl enable alertmanager

四、升级注意事项（针对从0.21.0升级） #

• 配置文件兼容性：0.24.0 对部分旧配置字段有废弃调整，比如slack_configs中的icon_url字段已被icon_emoji替代，需检查配置文件是否存在此类废弃项。
• 客户端签名差异：若出现TLS签名相关问题，需确认Alertmanager的TLS配置（若启用）是否与客户端兼容，0.24.0默认加密套件有所调整，可在global配置中显式指定兼容的套件：

  global:
    tls_config:
      cipher_suites:
      - TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
      - TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
  

• 功能故障排查：升级后先检查日志（默认输出至控制台，Systemd托管可通过journalctl -u alertmanager查看），定位具体报错信息，比如规则匹配、接收器连接问题等。

内容的提问来源于stack exchange，提问作者Sanjay Nag