metio/matrix-alertmanager-receiver

matrix-alertmanager-receiver

镜像概述

matrix-alertmanager-receiver是一个轻量级服务，用于接收Prometheus Alertmanager发送的告警通知，并将其转发到指定的Matrix聊天室。作为连接监控系统与Matrix聊天平台的中间件，它帮助团队通过Matrix及时获取系统告警信息，提升故障响应效率。

核心功能与特性

• Alertmanager集成：支持接收Alertmanager的webhook请求，兼容标准Alertmanager告警格式
• Matrix消息转发：将告警信息格式化后发送至配置的Matrix房间，支持文本消息展示
• 灵活配置：通过环境变量自定义Matrix连接参数、消息格式等关键配置
• 轻量级部署：容器化设计，资源占用低，易于集成到现有监控架构

使用场景

• DevOps团队实时接收Prometheus监控告警，通过Matrix进行协作响应
• 运维团队配置关键系统告警通知，确保基础设施异常及时触达
• 开发团队获取应用监控告警，快速定位并解决应用性能或可用性问题

使用方法

环境变量配置

运行容器前需配置以下必要环境变量：

Docker运行示例

bash
docker run -d \
  --name matrix-alertmanager-receiver \
  -p 8080:8080 \
  -e MATRIX_HOMESERVER="https://matrix.example.com" \
  -e MATRIX_ACCESS_TOKEN="syt_xxx_xxxx" \
  -e MATRIX_ROOM_ID="!abc123:example.com" \
  metio/matrix-alertmanager-receiver

Docker Compose配置示例

yaml
version: '3'
services:
  matrix-alertmanager-receiver:
    image: metio/matrix-alertmanager-receiver
    ports:
      - "8080:8080"
    environment:
      - MATRIX_HOMESERVER=https://matrix.example.com
      - MATRIX_ACCESS_TOKEN=syt_xxx_xxxx
      - MATRIX_ROOM_ID=!abc123:example.com
      - LISTEN_ADDRESS=:8080
    restart: unless-stopped

Alertmanager配置

在Alertmanager配置文件中添加webhook接收器，指向本服务：

yaml
route:
  receiver: 'matrix-receiver'
receivers:
- name: 'matrix-receiver'
  webhook_configs:
  - url: 'http://matrix-alertmanager-receiver:8080/webhook'  # 容器服务地址
    send_resolved: true  # 可选：发送告警解决通知

注意事项

• 确保Matrix用户已加入目标房间，且访问令牌具有发送消息权限
• 详细配置及高级功能（如消息模板自定义）请参考官方文档：https://github.com/metio/matrix-alertmanager-receiver