用途:为全栈项目建立一致、机器可读的日志规范,覆盖后端 structlog 与前端 Logger 类,并加入关联 ID、日志上下文与级别指南。
主要能力:强制 JSON 结构化日志;通过 CorrelationIdMiddleware 为每个请求生成并绑定 correlation_id,响应头回传 X-Correlation-ID;请求日志记录 method、path、status、duration_ms;代理执行日志记录 agent、task、status、duration_ms 与 error_code;前端 Logger 支持 LOG_LEVEL 过滤、ISO 时间戳与 JSON 上下文,并传播关联 ID;规定 ERROR/WARNING/INFO/DEBUG 使用场景;禁止记录密码、令牌、API 密钥、会话 ID 及完整请求响应体。
使用方式:后端用 from src.utils import get_logger 获取 logger,在 apps/backend/src/api/main.py 注册中间件;前端从 @/lib/logger 导入 logger,替换 console.log。生产环境使用 JSONRenderer,调试使用 ConsoleRenderer。
适用场景:新增模块或 API 端点日志、审查日志一致性、实现请求追踪、通过日志分析排查生产问题、搭建日志聚合与监控管道。
限制:不负责错误响应格式(用 error-taxonomy)、指标仪表盘(用 metrics-collector)或 CI/CD 配置(用 ci-cd-patterns);高频事件需采样;日志不得包含受 Privacy Act 1988 约束的数据。