产品底座与账户 / 运行底座

服务健康探针

已验证Web · 已验证代码更新于 2026-10-25

持续自检服务与数据库状态,运维与监控可直接对接;内部实测健康接口 P50 响应约 11ms。

功能价值

持续自检服务与数据库状态,运维与监控可直接对接;内部实测健康接口 P50 响应约 11ms。

使用方式

监控系统按固定间隔请求健康接口即可;桌面壳依赖其判断后端就绪。

所属模块

产品底座与账户 / 运行底座

适用平台

Web · 已验证

已知限制

  • 暂未记录

平台验证状态

本项适用于 1 个平台,逐平台独立判定:平台状态只由该平台的实机验收记录产生,总体状态由平台状态自动汇总,目录与页面都不存放可手写的状态。验收结论仅覆盖记录所列版本、Git SHA 与产物;当前源码或新安装包仍需独立验收。

Web

已验证

验收结果:PASS;通过 5 / 失败 0;产品版本 1.0.0.5;Git SHA 086a98f1fbad9f9b357692a85e656d8972cb6bc3;验证时间 2026-09-29。Acceptance JSON SHA-256 91c33b5256f30443cedcab1fca12d5fabb4bb828eb56c030430d33dfbb6ea7bf

实机录像 / 操作流程

媒体内容已复核,记录结论:验收结果:通过;画面内容:本轮真实浏览器会话录像(webm,16.08s,VP8 1600x1000 25fps,ffmpeg 实测):管理员登录 → 主健康探针 → liveness/readiness/details → 不存在的探针 404。;SHA-256:76356596e7283f6e45584a7a377b701e24cd76828ea3a29502217e40afc9580f(原始文件:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/base-health/video/base-health-web-20260929-135211.webm) 下载原始录像

实机截图

服务健康探针 已复核截图
媒体内容已复核,记录结论:验收结果:通过;画面内容:管理端登录页「管理员登录 / XCMAX 服务器后台 · 平台运维 · 系统管理」:左侧蓝色品牌栏写「企业级 AI 对话与智能体 / 审批工作流与 ERP 集成 / 即时通讯与团队协作」,右侧账号框已填 admin、密码框为掩码(••••••••),可点蓝色「登 录 →」。;SHA-256:c2880c86bc8b6f3e112f573d93b7b6f2d03820c8d68d9f9141c4611a5c6bcacf(原始文件:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/base-health/shot/00-login-form.png) 查看原图
服务健康探针 已复核截图
媒体内容已复核,记录结论:验收结果:通过;画面内容:卡片「H1 · 主健康探针真实应答(含 runtime 组件表)」:GET /api/health,200,{"status":200,"health":"degraded","version":"1.0.0.5","service":"xcagi-fastapi","runtime_status":"degraded","component_count":38,组件样例含 business_route:admin_audit/agent/aibiz_terminal/etl 等}(本环境 redis 不可用故为 degraded)。;SHA-256:7d828adedc5228b85910c54b2ba605a2440e6b78251b9053a26fef0cf2233d4d(原始文件:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/base-health/shot/H1-health-main.png) 查看原图

运行日志

下载原件:base-health-web-20260929-135211.log;SHA-256:7c42a5a45ee213285252b13f641ac92645b381aa344ce4d1addf6482be40c538(仓库路径:FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/base-health/log/base-health-web-20260929-135211.log)

安装包 / 部署产物 SHA-256:cfa52148ab19fd69e6bea715cc2b9ad046f9607dbdee31033cb9d5357d3c7368 · 交付身份 JSON

实现与测试(平台无关)

源码实现

  • FHD/app/fastapi_routes/health_k8s.py

API 端点

  • GET /api/health

自动化测试

  • FHD/tests/routes/test_health_k8s_probe.py

CI 门禁:FHD/.github/workflows/ci-cd.yml

CI 工作流定义

  • FHD/.github/workflows/ci-cd.yml

未标注平台的补充资料

下列资料未绑定到具体平台,仅作实现与历史资料参考,不计入任何平台状态,也不构成实机验收。

实机截图

服务健康探针 已复核截图
记录结论:资料收录(未绑定平台验收);SHA-256:a1450b7488887692e3ae940d401a4ba90d740d6984cfda8eb8e31083e582d641(原始文件:FHD/docs/evidence/capabilities/base-health-01-api-health.png) 查看原图

关联文档

  • FHD/docs/CLAIMED_VS_ACTUAL.md

证据原件存放于私有对象存储,页面通过短时效签名地址读取原图与原始录像; 「核验哈希」会对照本页登记的 SHA-256 与存储对象元数据。对象存储不可用时自动改用站内副本, 也可下载原件后用 sha256sum 自行核对。