mrkaran/calert

calert 镜像文档

概述

calert是一个轻量级二进制工具，旨在通过webhook集成将Alertmanager通知推送到Google Chat。它提供了简单高效的告警转发功能，适用于需要将监控系统告警集中管理到Google Chat的场景。更多信息请访问https://github.com/mr-karan/calert%E3%80%82

核心功能与特性

• 轻量级设计：作为独立二进制工具，部署简单，资源占用低
• Alertmanager集成：原生支持接收Alertmanager发送的标准告警通知
• Google Chat推送：通过webhook协议将告警信息转发到Google Chat
• 易于配置：支持通过环境变量或配置文件进行参数设置

使用场景

• 监控告警通知：将Prometheus+Alertmanager生态产生的告警实时推送至Google Chat
• 团队协作场景：使团队成员在日常沟通平台中及时接收系统告警
• 轻量级部署需求：适用于资源受限环境或简单监控架构的告警转发

使用方法与配置说明

环境变量配置

calert主要通过环境变量进行配置，核心参数如下：

• GOOGLE_CHAT_WEBHOOK_URL：Google Chat webhook URL（必填），用于接收告警通知的目标地址
• LISTEN_ADDR：服务监听地址，默认为:8080
• LOG_LEVEL：日志输出级别，可选值：debug、info、warn、error，默认info

Docker部署示例

基本运行命令

bash
docker run -d \
  --name calert \
  -p 8080:8080 \
  -e GOOGLE_CHAT_WEBHOOK_URL="https://chat.googleapis.com/v1/spaces/XXX/messages?key=XXX&token=XXX" \
  mrkaran/calert:latest

Docker Compose配置

yaml
version: '3'
services:
  calert:
    image: mrkaran/calert:latest
    container_name: calert
    ports:
      - "8080:8080"
    environment:
      - GOOGLE_CHAT_WEBHOOK_URL=https://chat.googleapis.com/v1/spaces/XXX/messages?key=XXX&token=XXX
      - LISTEN_ADDR=:8080
      - LOG_LEVEL=info
    restart: unless-stopped

与Alertmanager集成

在Alertmanager配置文件（alertmanager.yml）中添加webhook接收器，指向calert服务：

yaml
route:
  receiver: 'google-chat'
receivers:
- name: 'google-chat'
  webhook_configs:
  - url: '[***]  # 需替换为实际calert服务地址
    send_resolved: true  # 可选，是否发送已解决的告警通知