SuperAPI AI 工具集

review-logging-patterns

通用与其它

查看项目

更新于 10-16 09:29

技能介绍

用途:审查并改进 TypeScript/JavaScript 项目的日志写法,把分散的 console.log 转换为结构化宽事件,把普通错误转换为带上下文的结构化错误,并在支持的框架中接入 evlog。

主要能力:宽事件模式、结构化错误、代码审查清单、drain 管道;支持 Nuxt、Next.js、TanStack Start、Nitro v2/v3、Hono、Cloudflare Workers 与独立使用。提供配置项如 env.service、enabled、pretty、include/exclude、routes、sampling.rates/keep、drain、enrich、keep;Nitro 提供 evlog:drain、evlog:enrich、evlog:emit:keep、close 钩子;内置 Axiom、OTLP、PostHog、Sentry、Better Stack 适配器及 UA、Geo、请求大小、Trace 上下文等 enricher。

使用方式:安装 npm install evlog。Nuxt 在 nuxt.config.ts 注册 evlog/nuxt,函数自动导入,drain 写在 server/plugins 的 Nitro 插件中。Next.js 通过 createEvlog() 集中配置,用 withEvlog() 包装路由与 Server Actions,客户端用 EvlogProvider 与 ingest 端点。TanStack Start 使用 Nitro v3 并加 evlogErrorHandler。Hono 使用 initLogger、createRequestLogger、parseError。Cloudflare Workers 使用 evlog/workers。standalone 需手动 log.emit()。

适用场景:新老项目接入 evlog、日志最佳实践审查、console.log 结构化改造、错误上下文增强、drain/采样/富化配置。

限制与注意:客户端 ingest 端点需校验 origin 与 payload;避免记录敏感数据;standalone 必须手动 emit;部分框架配置方式不同,需按对应文档设置。参考文件按任务选择性加载,避免一次全部载入。