coco/aggregate-healthcheck

CoCo Aggregate Healthcheck 镜像

镜像概述

该镜像用于批量查询多个服务的健康检查端点，缓存结果并以FT标准健康检查格式返回，同时及时向Graphite发送统计数据，助力运维人员监控服务集群的整体健康状态。

核心功能

1. 批量调用多个服务的健康检查接口
2. 缓存健康检查结果，支持强制刷新
3. 输出FT标准格式的健康报告（JSON/HTML）
4. 向Graphite推送服务健康统计数据
5. 支持服务级别和集群级别的异常确认（ACK）
6. 基于分类管理服务检查策略（弹性、周期、Sticky模式）

使用场景

• 微服务集群监控：实时掌握多服务运行状态
• 运维异常处理：标记已确认的服务异常，避免重复告警
• 性能分析：通过Graphite数据跟踪服务健康趋势
• 部署验证：强制刷新缓存确认部署后的服务状态

配置说明

端点说明

• /__health：接受application/json或text/html请求头，返回健康结果
• /__gtg：返回服务是否可用（FT标准合规）

查询参数

• categories：逗号分隔的服务类别列表，如/__health?categories=read,system
• cache：是否使用缓存（默认true），如/__health?cache=false强制刷新

ACK支持

服务级别ACK

手动在Etcd创建键：

bash
etcdctl set /ft/healthcheck/[服务名]/ack "ACK详情（确认人、原因等）"

移除ACK：

bash
etcdctl rm /ft/healthcheck/[服务名]/ack

集群级别ACK

确认整个集群异常：

bash
etcdctl set /ft/config/aggregate-healthcheck/cluster-ack "ACK消息"

移除ACK：

bash
etcdctl rm /ft/config/aggregate-healthcheck/cluster-ack

注意：/__gtg端点不受集群ACK影响，仍返回真实可用状态。

分类管理

服务类别定义在Etcd的/ft/healthcheck-categories/路径下，包含：

• period_seconds：检查周期（秒）
• is_resilient：弹性模式（仅当类别下所有实例异常时影响集群健康）
• sticky：Sticky模式（一旦失败保持失败状态）

Sticky模式

启用Sticky：

bash
etcdctl set /ft/healthcheck-categories/[类别名]/sticky true

恢复Sticky类别：

bash
etcdctl set /ft/healthcheck-categories/[类别名]/enabled true

Docker部署示例

构建镜像

bash
CGO_ENABLED=0 go build -a -installsuffix cgo -o aggregate-healthcheck .
docker build -t coco/aggregate-healthcheck .

运行容器

bash
docker run \
    --env ETCD_PEERS=http://localhost:2379 \
    --env VULCAND_ADDRESS=localhost:8080 \
    --env GRAPHITE_HOST=graphite.ft.com \
    --env GRAPHITE_PORT=2003 \
    --env ENVIRONMENT=local \
    docker.xuanyuan.run/coco/aggregate-healthcheck

代码逻辑说明

1. 监听Etcd特定键变化，动态更新服务和类别配置
2. 缓存服务健康结果并保留历史队列
3. 并行调度服务检查，按类别调整周期
4. 每分钟将历史结果发送到Graphite用于统计分析