kittyandrew/grafana-to-ntfy

Grafana-Ntfy 桥接服务镜像

概述

该镜像提供一个轻量级微服务，用于连接Grafana的通知系统与ntfy.sh开源通知服务，实现Grafana告警通知向ntfy.sh服务的无缝转发与集成。通过此服务，用户可将Grafana产生的监控告警通过ntfy.sh推送至各类客户端（如手机、桌面应用）。

核心功能

• 通知桥接：接收Grafana的webhook通知并转发至ntfy.sh服务
• 格式转换：自动适配Grafana通知格式至ntfy.sh可识别的消息格式
• 配置灵活：支持自定义ntfy.sh服务器地址、主题和消息优先级
• 轻量可靠：基于精简运行时构建，资源占用低且具备基本错误重试机制

使用场景

• 运维团队需将Grafana监控告警推送至ntfy.sh客户端
• 开发团队希望通过ntfy.sh接收应用性能监控（APM）相关告警
• 需要统一管理多源告警渠道，将Grafana告警整合至ntfy.sh通知流的场景

使用方法

环境变量配置

快速启动（Docker Run）

bash
docker run -d \
  --name grafana-ntfy-bridge \
  -p 8080:8080 \
  -e NTFY_TOPIC=grafana-alerts \
  -e MESSAGE_PRIORITY=high \
  your-registry/grafana-ntfy-bridge:latest

Docker Compose 配置

yaml
version: '3.8'
services:
  grafana-ntfy-bridge:
    image: your-registry/grafana-ntfy-bridge:latest
    container_name: grafana-ntfy-bridge
    ports:
      - "8080:8080"
    environment:
      - NTFY_SERVER=https://ntfy.example.com  # 自定义ntfy服务器
      - NTFY_TOPIC=production-alerts          # 目标告警主题
      - LISTEN_PORT=8080
      - MESSAGE_PRIORITY=urgent
    restart: unless-stopped

Grafana 配置步骤

1. 登录Grafana控制台，进入Alerting > Notification channels
2. 点击Add channel，选择Webhook类型
3. 配置URL为：http://<服务IP或域名>:<LISTEN_PORT><GRAFANA_WEBHOOK_PATH>（例：http://192.168.1.100:8080/grafana-webhook）
4. 设置名称（如"ntfy-alerts"）并保存
5. 在告警规则中选择该通知渠道，完成集成

注意事项

• 确保Grafana服务器可访问桥接服务的监听地址
• ntfy.sh主题需提前创建或确保接收端已订阅目标主题
• 生产环境建议通过环境变量配置自定义ntfy服务器以提高隐私性