SuperAPI AI 工具集

observability-baseline

部署与运维

查看项目

更新于 10-15 17:22

技能介绍

用途:在项目脚手架阶段就建立可观测性基线,避免产品上线后在故障时无从排查。该技能默认将三部分能力预置并接入,无需额外决策。

主要能力:一、错误捕获,使用 Sentry,通过 instrumentation.ts(Next.js)或进程启动时初始化 SDK,DSN 取自 SENTRY_DSN 环境变量而非硬编码;CI 在发布时上传 source maps,release 取 git sha;捕获未处理的 Promise 拒绝,并在客户端设置全局错误边界。二、请求级结构化日志,输出 JSON 而非散文式 console.log,包含每请求 request_id(在边缘生成,经 header 或 async-local-storage 传递),级别为 error/warn/info/debug,诊断信息写入 stderr 不混入面向用户的标准输出;每请求一行日志,含 request_id、method、path、status、latency_ms。三、健康端点:GET /healthz 存活探针,GET /readyz 就绪探针(检查 db、cache 等依赖可连),轻量、免认证、不含 PII。

使用方式与接入:该技能需由消费方加载才有价值。app-scaffolder 将其写入生成的应用并添加 SENTRY_DSN 到 .env.example;infra-provisioner 在生产环境变量中设置 SENTRY_DSN,将平台健康探针指向 /readyz,并在 PROVISION 中记录 Sentry 项目;l3-support 首个排障步骤读取 Sentry 与 request-id 日志;devops 部署门禁在部署后 /readyz 未返回 200 时失败。输出为已接入上述三部分的可观测应用,并在 docs/infra/PROVISION-{slug}.md 记录 Sentry 项目与端点。

限制:资料未提供具体命令、价格、支持平台范围等细节,暂未提供。