jertel/elastalert2

ElastAlert 2 Docker镜像文档

镜像概述

ElastAlert 2是一款基于Elasticsearch的告警工具，用于从Elasticsearch中查询数据并根据预定义规则触发告警。本镜像为ElastAlert 2的官方Docker镜像，提供便捷的部署方式，适用于快速搭建Elasticsearch监控告警系统。

项目信息：https://github.com/jertel/elastalert2
官方文档：https://elastalert2.readthedocs.io/

核心功能与特性

• Elasticsearch集成：直接与Elasticsearch集群通信，支持查询索引数据
• 灵活规则定义：支持通过YAML文件配置告警规则（如频率、阈值、异常检测等）
• 多告警渠道：支持Email、Slack、PagerDuty、Webhook等多种告警通知方式
• 定时任务：按配置的时间间隔执行查询与规则检查
• 轻量部署：通过Docker容器化部署，简化环境依赖管理

使用场景

• 日志监控：实时监控应用或系统日志，检测错误、异常访问等并触发告警
• 安全告警：监控安全日志，检测登录失败、权限变更等安全事件
• 业务指标监控：监控关键业务指标（如订单量、响应时间），超出阈值时告警
• 异常检测：通过统计分析识别数据中的异常模式（如流量突增、服务不可用）

使用方法

基本部署（Docker Run）

需挂载ElastAlert 2配置文件（config.yaml）和告警规则目录（存放.yaml规则文件）：

bash
docker run -d \
  --name elastalert2 \
  -v /path/to/config.yaml:/opt/elastalert/config.yaml \
  -v /path/to/rules:/opt/elastalert/rules \
  -e ELASTICSEARCH_HOST=elasticsearch \
  -e ELASTICSEARCH_PORT=9200 \
  docker.xuanyuan.run/jertel/elastalert2:latest

Docker Compose示例

配合Elasticsearch部署的docker-compose.yml示例：

yaml
version: '3'
services:
  elasticsearch:
    image: ***-elastic.xuanyuan.run/elasticsearch/elasticsearch:8.11.0
    environment:
      - discovery.type=single-node
    ports:
      - "9200:9200"
    networks:
      - elastalert-network

  elastalert2:
    image: docker.xuanyuan.run/jertel/elastalert2:latest
    volumes:
      - ./config.yaml:/opt/elastalert/config.yaml
      - ./rules:/opt/elastalert/rules
    environment:
      - ELASTICSEARCH_HOST=elasticsearch
      - ELASTICSEARCH_PORT=9200
      - ELASTICSEARCH_USER=elastic
      - ELASTICSEARCH_PASSWORD=changeme
    depends_on:
      - elasticsearch
    networks:
      - elastalert-network

networks:
  elastalert-network:

环境变量配置

规则文件配置

告警规则需在挂载的rules目录中创建.yaml文件（如error_alert.yaml），示例规则：

yaml
name: High Error Rate Alert
type: frequency
index: logs-*
num_events: 10
timeframe:
  minutes: 5
filter:
  - query:
      query_string:
        query: "level: ERROR"
alert:
  - "email"
email:
  - "alerts@example.com"

相关资源

• 项目GitHub：https://github.com/jertel/elastalert2
• 官方文档：https://elastalert2.readthedocs.io/
• Kubernetes Helm Chart：https://github.com/jertel/elastalert2/tree/master/chart/elastalert2
• 备用镜像仓库：https://github.com/jertel/elastalert2/pkgs/container/elastalert2%2Felastalert2