schlauerlauer/alertmanager-webhook-signal

Alertmanager Webhook Signal镜像说明

镜像概述

本镜像提供容器化HTTP端点，接收Alertmanager或Grafana的webhook请求，并映射到signal-cli（bbernhard开发的signal-cli-rest-api）发送消息。适用于已部署signal-cli的环境（如Home Assistant通知器），实现监控告警的Signal消息推送。

核心功能

• 支持Alertmanager和Grafana的webhook请求
• 通过Prometheus标签recipients指定消息接收人
• 显示Grafana告警的预览图表
• 可配置过滤告警标签/注释、是否包含生成器URL
• 支持默认接收人及命名接收人映射

使用场景

• Prometheus+Alertmanager监控系统的Signal告警通知
• Grafana告警的可视化消息推送
• 已运行signal-cli的智能家居环境（如Home Assistant）的告警集成

配置说明

需通过config.yaml文件配置，示例如下：

yaml
# Alertmanager webhook地址：/api/v3/alertmanager
# Grafana webhook地址：/api/v3/grafana
server:
  port: 10000 # 服务监听端口（必填）
  debug: false
signal:
  number: "+4923456" # 发送消息的号码（必填）
  recipients: # 未指定标签时的默认接收人（必填）
  - "+49123123123"
  send: http://127.0.0.1:10001/v2/send # signal-cli的HTTP端点（必填）
alertmanager:
  ignoreLabels: # 过滤的标签（可选）
  - "alertname"
  ignoreAnnotations: [] # 过滤的注释（可选）
  generatorURL: true # 是否包含生成器URL（可选，默认false）
  matchLabel: "recipients"
recipients: # 命名接收人映射（可选）
  alice: "+49123123123"
  bob: "+49234234234"

部署示例

Docker Run命令

bash
docker run -d --name alertmanager-signal \
  -p 10000:10000 \
  -v $(pwd)/config.yaml:/config.yaml \
  docker.io/schlauerlauer/alertmanager-webhook-signal:1.1.0

Prometheus规则示例

yaml
groups:
  - name: "test.rules"
    rules:
      - alert: "默认接收人测试告警"
        annotations:
          message: "默认接收人测试消息"
        expr: 'vector(1)'
        for: "1m"

      - alert: "指定接收人测试告警"
        annotations:
          message: "指定接收人测试消息"
        labels:
          recipients: "alice"
        expr: 'vector(1)'
        for: "1m"

Alertmanager配置示例

yaml
global:

route:
  receiver: "signal"
  group_by: ["alertname"]
  group_wait: "5s"
  group_interval: "5m"
  repeat_interval: "3h"
receivers:
  - name: "signal"
    webhook_configs:
      - url: "[***]"
        send_resolved: true