webdevops/alertmanager2es

alertmanager2es

镜像概述

本镜像为cloudflare/alertmanager2es的分叉版本，采用新Go语言项目结构，使用官方ElasticSearch客户端并支持认证。作为守护进程运行，接收AlertManager的HTTP webhook通知，将告警以组形式插入ElasticSearch索引，方便后续搜索与分析。

核心功能

• 接收AlertManager的webhook告警通知
• 将告警组存储至ElasticSearch
• 支持ElasticSearch的HTTP基本认证与API key认证
• 可配置带日期占位符的索引名称（如%y/%m/%d）
• 暴露Prometheus metrics用于监控
• 提供调试/verbose日志模式及JSON格式日志输出

使用场景

• 分析特定时间段内的告警记录，优化告警规则
• 追溯事件发生时的告警情况，评估事件影响
• 存储告警历史数据，满足合规或审计需求

配置说明

Docker部署示例

docker run命令

bash
docker run -d \
  --name alertmanager2es \
  -p 9097:9097 \
  -e ELASTICSEARCH_ADDRESS=http://es-host:9200 \
  -e ELASTICSEARCH_USERNAME=es-user \
  -e ELASTICSEARCH_PASSWORD=es-pass \
  -e ELASTICSEARCH_INDEX=alertmanager-%y.%m \
  webdevops/alertmanager2es

docker-compose示例

yaml
version: '3'
services:
  alertmanager2es:
    image: webdevops/alertmanager2es
    ports:
      - "9097:9097"
    environment:
      - ELASTICSEARCH_ADDRESS=http://es:9200
      - ELASTICSEARCH_APIKEY=base64-encoded-api-key
      - ELASTICSEARCH_INDEX=alertmanager-%y.%m
    restart: always

alertmanager2es参数配置

通过命令行参数或环境变量配置，关键参数如下：

• --elasticsearch.address（ELASTICSEARCH_ADDRESS）：ElasticSearch地址
• --elasticsearch.username（ELASTICSEARCH_USERNAME）：ES用户名
• --elasticsearch.password（ELASTICSEARCH_PASSWORD）：ES密码
• --elasticsearch.apikey（ELASTICSEARCH_APIKEY）：ES API key（优先级高于用户名密码）
• --elasticsearch.index（ELASTICSEARCH_INDEX）：索引名称（默认：alertmanager-%y.%m）
• --bind（SERVER_BIND）：服务绑定地址（默认：:9097）

AlertManager配置示例

接收器配置

yaml
receivers:
- name: alertmanager2es
  webhook_configs:
    - url: http://alertmanager2es:9097/webhook

路由配置

yaml
route:
  receiver: alertmanager2es
  continue: true  # 允许告警继续发送到其他接收器

ElasticSearch模板示例

启动前建议应用以下模板以优化存储：

json
{
  "template": "alertmanager-2*",
  "settings": {
    "number_of_shards": 1,
    "number_of_replicas": 1,
    "index.refresh_interval": "10s",
    "index.query.default_field": "groupLabels.alertname"
  },
  "mappings": {
    "_default_": {
      "_all": {"enabled": false},
      "properties": {"@timestamp": {"type": "date", "doc_values": true}},
      "dynamic_templates": [
        {
          "string_fields": {
            "match": "*",
            "match_mapping_type": "string",
            "mapping": {
              "type": "string",
              "index": "not_analyzed",
              "ignore_above": 1024,
              "doc_values": true
            }
          }
        }
      ]
    }
  }
}