swatto/promtotwilio

Prometheus警报短信通知工具

该镜像提供一个简单工具，可接收来自Prometheus的webhook请求，并通过Twilio服务将警报摘要以短信形式发送给指定接收者。镜像体积小于15MB，部署便捷。

!https://img.shields.io/docker/pulls/swatto/promtotwilio.svg?style=flat-square

核心功能

• 接收Prometheus的警报webhook
• 通过Twilio发送包含警报摘要的短信
• 支持指定接收者或使用默认接收者
• 提供健康检查接口（访问/路径返回200 OK）

使用场景

适用于Prometheus监控系统的警报通知场景，例如：

• 服务器故障或资源利用率超限
• 应用服务异常停止
• 系统关键指标异常波动

配置说明

需设置以下4个环境变量：

• SID：Twilio账户SID
• TOKEN：Twilio认证令牌
• RECEIVER：默认接收者电话号码（可选）
• SENDER：Twilio管理的发送者电话号码

测试命令

向指定电话号码（如+zxxxyyyyyyy）发送测试短信：

bash
curl -H "Content-Type: application/json" -X POST -d \
'{"version":"2","status":"firing","alerts":[{"annotations":{"summary":"Server down"},"startsAt":"2016-03-19T05:54:01Z"}]}' \
http://localhost:9090/send?receiver=%2Bzxxxyyyyyyy

部署示例

以下是与cAdvisor、Prometheus、Alertmanager、Grafana配合使用的Docker Compose示例：

yml
sms:
  image: swatto/promtotwilio:latest
  environment:
    SID: xxx
    TOKEN: xxx
    RECEIVER: xxx
    SENDER: xxx

alert:
  image: prom/alertmanager:latest
  links:
   - sms
  volumes:
   - ./alertmanager.yml:/etc/alertmanager/config.yml

container:
  image: google/cadvisor:latest
  volumes:
   - /:/rootfs:ro
   - /var/run:/var/run:rw
   - /sys:/sys:ro
   - /var/lib/docker/:/var/lib/docker:ro

prometheus:
  image: prom/prometheus:latest
  links:
   - container
   - alert
  volumes:
   - ./prometheus.yml:/etc/prometheus/prometheus.yml
   - ./alerts.conf:/etc/prometheus/alerts.conf
  entrypoint: /bin/prometheus -config.file=/etc/prometheus/prometheus.yml -alertmanager.url=http://alert:9093

web:
  image: grafana/grafana:latest
  links:
   - prometheus
  ports:
   - "3000:3000"
  environment:
    GF_SERVER_ROOT_URL: http://stats.example.com
    GF_SECURITY_ADMIN_PASSWORD: 123456

AlertManager配置示例

在AlertManager配置中指向该工具：

yml
route:
  receiver: 'admin'

receivers:
- name: 'admin'
  webhook_configs:
  - url: '[***]