SuperAPI AI 工具集

http_health_check_probes

通用与其它

查看项目

更新于 10-15 20:33

技能介绍

用途:在KYC身份验证流水线的各微服务(活体检测、OCR、人脸比对、文档处理、反欺诈、决策引擎)中实现或更新HTTP健康检查端点,是获得基础可观测性的第一步。

主要能力:提供三类端点。/live仅表示进程存活并返回200;/ready检查服务能否接收流量,验证数据库、Redis、ML模型等依赖,全部就绪返回200,否则503;/health输出详细报告,含各依赖连接状态、延迟毫秒、模型推理就绪状态、运行时长与版本。整体状态分为healthy、degraded、unhealthy,依据模型是否加载、数据库延迟是否超过500毫秒、Redis延迟是否超过100毫秒判定。

使用方式:在每个微服务中创建health.py模块,用FastAPI的APIRouter定义路由,编写带短超时(最长2秒)的依赖检查辅助函数,再通过app.include_router(health_router, prefix="")注册到主应用。健康端点不应要求认证,并需在日志中间件中过滤以避免生产环境日志过多。

适用场景:需要让编排器与负载均衡器基于依赖状态做出流量路由决策的微服务环境。

限制:健康检查应在3秒内响应,依赖超时则标记为降级但不阻塞整体响应;各微服务需按自身依赖定制检查(如face_match验证ArcFace已加载);不得暴露敏感信息(精确依赖版本、凭据、内部路径),详细信息仅限内网访问。具体部署环境与配置细节暂未提供。