dagviggo/consul-alerts

镜像概述

dagviggo/consul-alerts是Consul Alerts工具的Docker化实现，支持Opsgenie API v2，用于监控Consul集群的健康检查结果并发送告警通知。该工具利用Consul的KV存储和选举机制实现高可用，可自动故障转移，保证通知服务的连续性。

核心功能

• 多通知器支持：内置邮件、Slack、PagerDuty、Opsgenie、AWS SNS等多种通知方式，满足不同场景需求
• 高可用设计：通过Consul选举机制实现节点故障自动切换，确保告警不丢失
• 灵活配置：支持通知阈值、黑名单（按节点/服务/检查ID屏蔽通知）、自定义通知模板等
• 事件处理：可接收并处理Consul事件，触发自定义处理逻辑

使用场景

• 微服务架构中服务健康状态的实时告警
• 集群节点或基础设施异常时的及时通知
• 多环境（开发/测试/生产）下的监控告警统一管理
• 配合Consul实现分布式系统的高可用监控

配置说明

配置存储于Consul KV的consul-alerts/config/前缀下，主要配置项包括：

• 通知器配置：如邮件SMTP参数、Slack webhook URL等
• 告警阈值：设置健康检查状态持续时长（默认60秒）后触发通知
• 黑名单：屏蔽特定节点、服务或检查ID的通知
• 通知配置文件：自定义通知接收方式和频率

Docker部署示例

链接到现有Consul容器

bash
docker run -ti \
  -p 9000:9000 \
  --name consul-alerts \
  --link consul:consul \
  dagviggo/consul-alerts start \
  --consul-addr=consul:8500 \
  --log-level=info --watch-events --watch-checks

指向远程Consul实例

bash
docker run -ti \
  -p 9000:9000 \
  --name consul-alerts \
  dagviggo/consul-alerts start \
  --consul-addr=remote-consul-server.domain:8500 \
  --log-level=info --watch-events --watch-checks

启用内置Consul Agent（需覆盖入口点）

bash
# 启动Consul Agent
docker run -ti \
  --rm -p 9000:9000 \
  --hostname consul-alerts \
  --name consul-alerts \
  --entrypoint=/***/consul \
  dagviggo/consul-alerts \
  agent -data-dir /data -server -bootstrap -client=0.0.0.0

# 启动Consul Alerts（新终端）
docker exec -ti consul-alerts /***/consul-alerts start --alert-addr=0.0.0.0:9000 --log-level=info --watch-events --watch-checks