SuperAPI AI 工具集

structured-logging-lite

部署与运维

查看项目

更新于 10-16 09:59

技能介绍

用途:面向仓库证据设计、审计或实现应用结构化日志架构,回答“是否加日志、加在哪里、如何组织”等问题。

主要能力:先检索仓库指令、清单文件、入口点、日志器构建、日志调用、上下文传播、错误映射、panic 处理、适配器、worker、审计记录、指标、测试与部署配置;再区分库、CLI/批处理、HTTP 服务、长驻 worker 或多服务系统。梳理生命周期、请求、认证、里程碑、外部适配器、后台任务、降级路径、崩溃与第三方输出的覆盖情况,把重复缺失字段、假成功信号、密钥泄露等固化为字段契约或校验测试。

使用方式:设计/审计默认只读,用户要求实现或升级时才做本地修改。先在组合根配置输出,传输中间件观察请求,适配器记录副作用失败,worker 记录批处理结果,领域代码不依赖日志器。优先沿用仓库既有日志器或语言标准库。授权实现时按 P0 请求/错误/安全、P1 适配器与 worker、P2 追踪或后端集成递进,并用仓库原生构建、测试及日志捕获、密钥金丝雀、路由归一化、panic、流式响应测试验证。

限制:不打印或持久化凭据、令牌、Cookie、签名、请求体、DSN、私密 URL 或密钥;不吞掉、降级或替换错误;日志、指标、追踪、审计记录是不同契约;每个请求一个完成事件;指标与索引标签避免高基数标识;健康检查成功日志应排除或采样,安全失败不得采样;保留可选响应/流接口。发布、推送、改远程可观测设施、触碰生产前需先确认。references/full-guide.md 为设计前必读,Go 仓库还需读 references/go.md;完整可观测/SLO/追踪方案转 observability-sre。交付格式包含 verdict、current_evidence、chosen_stack、boundary_map、event_and_field_contract、privacy_and_cardinality、coverage_gaps、P0_P1_P2、validation、remaining_risks;实现时另报改动文件与验证命令。