mwalbeck/alerta

docker-alerta

镜像概述和主要用途

docker-alerta 是一个基于官方 Alerta Web 容器（https://hub.docker.com/r/alerta/alerta-web%EF%BC%89%E6%9E%84%E5%BB%BA%E7%9A%84 Docker 镜像，其核心差异在于预集成了 Matrix 告警通知插件。该镜像旨在简化 Alerta 告警管理系统的部署流程，同时提供通过 Matrix 协议发送告警通知的能力。Alerta 是一款开源的告警聚合与管理工具，可帮助用户集中处理、分类和跟踪各类监控系统产生的告警。

核心功能和特性

基础功能（继承自官方 Alerta 镜像）

• 告警聚合与去重：集中接收、合并重复告警，减少告警噪音
• 告警生命周期管理：支持告警状态跟踪（新建、确认、关闭等）
• 告警查询与过滤：提供多维度查询能力，支持按状态、级别、资源等筛选
• 可扩展架构：支持通过插件扩展功能（如通知集成、数据导入等）

扩展功能（新增特性）

• Matrix 插件集成：内置 Matrix 协议通知插件，支持将告警事件通过 Matrix 房间发送给指定用户或群组，实现实时告警通知

使用场景和适用范围

适用场景

• 企业 IT 监控系统：需集中管理服务器、网络设备、应用程序等产生的告警
• DevOps/DevSecOps 环境：配合 CI/CD 流程、容器平台（如 Kubernetes）监控，实现告警快速响应
• 多团队协作场景：通过 Matrix 房间实现跨团队告警同步与协作

目标用户

• 负责监控系统运维的工程师
• 需要通过 Matrix 进行团队沟通的技术团队
• 使用 Alerta 进行告警管理并需扩展通知渠道的组织

使用方法和配置说明

前置要求

• Docker 环境（20.10+ 版本推荐）
• 有效的 Matrix 账号及可访问的 Matrix homeserver（如 Synapse、Element 等）
• Alerta 后端数据库（如 PostgreSQL、MySQL，参考 Alerta 官方文档）

Alerta 系统基础配置

本镜像基于官方 Alerta 容器构建，基础配置（如数据库连接、认证授权、API 端口等）与官方镜像完全一致，可直接参考 https://hub.docker.com/r/alerta/alerta-web 进行设置。

Matrix 插件配置

Matrix 插件用于将 Alerta 告警转发至 Matrix 房间，配置步骤如下：

1. 插件配置文件
   需通过挂载配置文件或环境变量指定 Matrix 插件参数，关键配置项包括：

   • matrix_homeserver：Matrix homeserver 地址（如 https://matrix.org）
   • matrix_user_id：发送告警的 Matrix 用户 ID（如 @alerta_bot:matrix.org）
   • matrix_access_token：Matrix 用户访问令牌（从 Matrix 账号设置中获取）
   • matrix_room_id：接收告警的 Matrix 房间 ID（如 !abc123:matrix.org）

2. 配置参考文档
   详细配置说明可参考：

   • matrix-alerta 项目文档
   • https://github.com/alerta/alerta-contrib/tree/master/plugins/matrix

Docker 部署示例

1. 快速启动（docker run）

bash
docker run -d \
  --name alerta \
  -p 8080:8080 \
  -e DATABASE_URL="postgresql://user:pass@db-host:5432/alerta" \  # 替换为实际数据库地址
  -e SECRET_KEY="your-secure-secret-key" \  # 替换为随机生成的安全密钥
  -v /path/to/matrix-plugin-config:/app/plugins/matrix  # 挂载 Matrix 插件配置文件（可选）
  mwalbeck/alerta

2. Docker Compose 配置示例

yaml
version: '3.8'

services:
  alerta:
    image: mwalbeck/alerta
    container_name: alerta
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      - DATABASE_URL=postgresql://user:pass@db:5432/alerta  # 假设使用同 Compose 文件中的 PostgreSQL
      - SECRET_KEY=your-secure-secret-key
      - AUTH_REQUIRED=True  # 启用认证（可选，参考官方文档）
    volumes:
      - ./matrix-config:/app/plugins/matrix  # 本地 Matrix 插件配置目录挂载
    depends_on:
      - db

  db:
    image: postgres:14-alpine
    container_name: alerta-db
    restart: unless-stopped
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=pass
      - POSTGRES_DB=alerta
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

配置参数说明

Alerta 核心配置（环境变量）

更多核心配置参数见 Alerta 官方配置文档。

Matrix 插件配置（配置文件）

插件配置文件通常为 matrix.py 或 matrix.conf，关键参数：

详细配置项及格式参考 matrix-alerta 项目文档。

镜像信息

• Docker Hub 地址：https://hub.docker.com/r/mwalbeck/alerta
• 源码仓库：GitLab（主仓库）、https://github.com/mwalbeck/docker-alerta%EF%BC%88%E9%95%9C%E5%83%8F%E4%BB%93%E5%BA%93%EF%BC%89