SuperAPI AI 工具集

using-logging

办公与效率

查看项目

更新于 10-15 16:49

技能介绍

用途:在应用中统一采用 Pino 结构化日志,规范日志级别与上下文字段,并覆盖工作流等受限运行环境的日志写法。

主要能力:通过 @/lib/logging/logger 导出的 logger 记录日志,支持 info、warn、error、debug 等调用形式;结构化日志要求把上下文对象放在第一个参数、消息放在第二个参数,错误场景先传 err。文档给出级别速查:trace 用于极细调试,debug 用于开发排查,info 记录正常运营与业务事件,warn 表示可恢复问题或弃用警告,error 表示需关注的失败,fatal 表示应用无法继续的严重故障。

使用方式:通过环境变量 LOG_LEVEL 控制输出,默认 info,可取 trace、debug、info、warn、error、fatal,例如 LOG_LEVEL="debug" 或生产环境 LOG_LEVEL="warn"。API 路由中可在请求开始记录时间,完成时打印 duration 与 status,异常时以 logger.error({ err, duration }, ...) 记录并返回 500。工作流函数运行在受限环境,需用带 "use step" 的 logger 步骤包装函数,在 workflow 中以 await log("info", ...) 调用。

适用场景:需要结构化、可检索日志的 Web 应用、API 路由与工作流。

限制:资料未提供安装步骤、依赖版本、logger 模块的具体实现、性能开销或与其他日志工具的对比信息。