v0.6.0 Operations and Observability
English
ModelFaucet v0.6.0 adds the operations and observability layer for running the control API and gateway with clearer production signals.
Highlights
- Added
/readyand Prometheus-style/metricsendpoints to the API and gateway. - Added request ID propagation on responses and JSON error bodies.
- Added configurable in-memory rate limiting with
x-ratelimit-*andretry-afterheaders. - Added English and Chinese operations docs covering health checks, metrics, request IDs, and rate-limit tuning.
- Updated README, API spec, roadmap, changelog, and environment examples for the 0.6 release.
Verification
- Local
verify:secrets, docs build, lint, typecheck, tests, dashboard build, CRM build, and local smoke test passed. - GitHub Actions
cirun27707919894passed. - GitHub Actions
docsrun27707920293passed and deployed Pages.
Security posture is unchanged: provider API keys remain server-side, BYOK remains explicit, and cloud services are not allowed to access localhost or private LAN URLs.
中文
ModelFaucet v0.6.0 增加了面向生产运行的运维与可观测性基础能力,让控制 API 和网关具备更清晰的健康、指标和限流信号。
重点更新
- 为 API 和 Gateway 增加
/ready与 Prometheus 风格/metrics端点。 - 增加请求 ID 透传,并在 JSON 错误响应中返回
request_id。 - 增加可配置的内存限流,并返回
x-ratelimit-*与retry-after响应头。 - 新增英文/中文运维文档,覆盖健康检查、指标、请求 ID 和限流调优。
- 更新 README、API 规范、路线图、变更日志和环境变量示例到 0.6 版本。
验证
- 本地已通过
verify:secrets、docs build、lint、typecheck、tests、dashboard build、CRM build 和 local smoke test。 - GitHub Actions
cirun27707919894已通过。 - GitHub Actions
docsrun27707920293已通过并部署 Pages。
安全边界保持不变:provider API key 仅保留在服务端,BYOK 仍然是显式能力,云服务不会访问 localhost 或私有 LAN URL。