服务健康检查

一键诊断

单机

./scripts/doctor.sh           # 关键服务状态 + 健康检查
./scripts/doctor.sh --all     # 检查全部服务
./scripts/doctor.sh --logs    # 附带关键服务最近 20 行日志

K8s

./scripts/verify-k8s-install.sh

# Pod 状态
kubectl -n <ns> get pods -o wide
kubectl -n <ns> get deploy -o wide

# 事件
kubectl -n <ns> get events --sort-by=.lastTimestamp

# 日志
kubectl -n <ns> logs -l app=<svc> --tail=100
kubectl -n <ns> logs <pod> --previous    # 上一容器日志

单点健康探测

finclaw 微服务（21 个）

curl http://localhost:26100/health   # api-gateway
curl http://localhost:26101/health   # identity-service
curl http://localhost:26102/health   # orchestrator
curl http://localhost:26103/health   # ag-ui-server
curl http://localhost:26104/health   # persona-service
curl http://localhost:26105/health   # skill-service
curl http://localhost:26107/health   # claw-fleet-manager
curl http://localhost:26108/health   # a2a-gateway
curl http://localhost:26109/health   # auth-fabric-proxy（profile gated）
curl http://localhost:26115/health   # auth-fabric（profile gated）
curl http://localhost:26200/health   # conversation-store
curl http://localhost:26201/health   # delivery
curl http://localhost:26202/health   # inbox-service
curl http://localhost:26203/health   # push-service
curl http://localhost:26205/health   # document-service
curl http://localhost:26450/health   # ai-infra-rs
curl http://localhost:26118/healthz  # searxng（注意是 /healthz 不是 /health）
curl http://localhost:26460/health   # feishu-connector
curl http://localhost:26461/health   # doc-toolkit
curl http://localhost:26462/health   # dingtalk-connector
curl http://localhost:26550/health   # wecom-connector

K8s 下用 kubectl port-forward 或 kubectl exec curl。

基础服务

# PostgreSQL
docker exec chatkit-postgres pg_isready -U postgres -d chatkit
# 或（从主机探测端口）
pg_isready -h <host> -p 26110

# TimescaleDB
pg_isready -h <host> -p 26111

# NATS（客户端端口连通性）
nc -z <host> 26112
# 无 nc 时：timeout 3 bash -c 'echo > /dev/tcp/<host>/26112'

# Redis
docker exec chatkit-redis redis-cli ping

# TEI
curl http://localhost:26117/health

# Restate
curl http://localhost:26181/health

contract 版本握手（关键）

curl http://localhost:26450/health | jq .contract_version

预期：返回非 unknown 的版本号（如 1.2.1）。

若返回 unknown：contract 版本号在镜像构建时内嵌，unknown 属异常镜像，请联系凡泰支持。详见 服务日志查看。

license 健康

# 单机
curl -s http://localhost:26101/health | jq .deployment_license
# K8s（先 port-forward 再访问本地端口）
kubectl -n <ns> port-forward svc/identity-service 26101:26101

预期：status 为 active；expired / unloaded 表示已过期或未加载，到期时间见 expires_at。若有异常，联系凡泰续期，流程见 更新 License。

排障建议

健康检查失败时，标准三步：

1. doctor.sh（单机）或 verify-k8s-install.sh（K8s）获取整体状态
2. 针对具体服务查日志（见 服务日志查看）
3. 单点 /health 探测确认