健康检查端点技能

概述

本技能实现健康检查和就绪端点，SDK消费者可用其验证连接性和依赖项健康状态，尤其适用于Kubernetes和负载均衡器集成。

能力

设计健康检查契约和响应
实现依赖项检查（数据库、缓存、外部API）
支持Kubernetes存活性和就绪性探针
生成健康状态报告
配置降级状态处理
实现级联健康检查
支持自定义健康指标
配置健康聚合策略

目标流程

可观测性集成
平台API网关设计
SDK架构设计

集成点

Kubernetes探针端点
负载均衡器健康检查
监控系统
服务网格健康
断路器状态

输入要求

需要检查的依赖项
健康检查间隔
超时配置
降级策略
Kubernetes探针要求

输出工件

健康检查端点实现
依赖项检查模块
健康响应模式
Kubernetes探针配置
监控集成
健康聚合逻辑

使用示例

skill:
  name: health-check-endpoint
  context:
    endpoints:
      health: /health
      ready: /ready
      live: /live
    checks:
      - name: database
        type: tcp
        critical: true
      - name: cache
        type: redis
        critical: false
      - name: externalApi
        type: http
        url: https://api.example.com/health
    kubernetes:
      livenessProbe:
        path: /live
        periodSeconds: 10
      readinessProbe:
        path: /ready
        periodSeconds: 5

最佳实践

将存活性与就绪性分离
确保健康检查快速执行
包含依赖项状态
支持优雅降级
避免在存活检查中进行昂贵操作
适当缓存健康检查结果