feat: 实现日志追踪链路 #185

实现内容：
- 创建 trace/gin_logger.go，实现 GinLogger 和 GinRecovery 中间件
- GinLogger 自动记录所有 HTTP 请求的 method/path/status/latency/client_ip
- GinRecovery 使用 zap 记录 panic 恢复信息，替代 gin.Recovery()
- 修改 main.go 注册三层中间件：TraceMiddleware -> GinLogger -> GinRecovery
- 所有日志自动附加 trace_id 和 request_id 字段

日志示例：
{
  "level": "info",
  "ts": "2026-06-21T22:26:07.610+0800",
  "msg": "request completed",
  "trace_id": "01KVN964KSY6BFDKB9S932NXB8",
  "request_id": "01KVN964KSY6BFDKB9S932NXB8",
  "method": "GET",
  "path": "/api/health",
  "status": 200,
  "latency_ms": 0,
  "client_ip": "::1"
}

测试：已验证健康检查接口日志正常输出

feat: WebSocket 追踪集成（Phase 5） 6ab4776e08

- 在 WebSocket 升级后生成连接级 trace_id
- 为每个 query 注入 request_id 到 context
- 使用 trace.FromContext 替换所有 logger.Log
- trace_id 贯穿整个 WebSocket 生命周期
- 自动附加 trace_id/session_id/request_id 到所有日志

feat: Eino adapter 和 callback 迁移到 trace 包（Phase 6.1） ad700743ef

- 移除 adapter.go 中的 ctxKeySessionID 定义
- 移除 callback.go 中的 ctxKeyRequestID 定义
- 统一使用 trace.WithSessionID/WithRequestID
- adapter.go 使用 trace.FromContext 替换 logger.Log
- callback.go 使用 trace.FromContext
- 移除双重日志，SetActiveRequest 失败直接返回错误
- 更新测试文件导入 trace 包

feat: Eino nodes 迁移到 trace 包（Phase 6.2） 76d331c885

- nodes_stt.go 使用 trace.FromContext 替换 logger.Log
- nodes_history.go 使用 trace.FromContext
- nodes_tts.go 使用 trace.FromContext
- nodes_done.go 使用 trace.FromContext
- 移除所有 nodes 中的 request_id 手动字段（自动附加）
- 所有日志消息改为英文

feat: 日志级别优化（Phase 7） 6b4b033df3

- nodes_stt.go: STT 识别开始降为 Debug
- nodes_history.go: 历史组装完成降为 Debug
- nodes_tts.go: TTS 流中断降为 Debug
- 保持关键里程碑为 Info：query completed、tts synthesis started/completed
- 中间步骤详情降为 Debug，减少生产环境日志噪音

docs: 完善日志追踪文档 55f7f183a7

feat: 为 PostgreSQL store 层添加 trace 日志 d0e4bdaeec

为 4 个 PostgreSQL repository 添加 trace-aware 日志：
- session_pg.go: Save/Find/Update/Delete 操作日志
- user_pg.go: 用户 CRUD 和 refresh token 管理日志
- message_pg.go: 消息存储和查询日志
- user_scenario_repository.go: 自定义情景 CRUD 日志

日志策略：
- Error: 数据库操作失败
- Debug: 操作成功（避免 Info 级别噪音）
- NotFound (ErrNoRows) 不记录错误日志

feat: 升级 session/redis.go 日志为 trace-aware 1c7dd708a0

替换 logger.Log 为 trace.FromContext(ctx)：
- CreateWithID: session 创建日志
- Get: session 获取日志（新增错误日志）
- UpdateConfig: 配置更新日志
- UpdateTitle: 标题更新日志
- GetHistory: 无效历史条目警告日志
- Destroy: session 销毁日志

feat: 升级 cached_user.go 日志为 trace-aware 9dce107a84

替换 logger.Log 为 trace.FromContext(ctx)：
- SaveRefreshToken: Redis 缓存写入失败降级日志
- FindRefreshToken: Redis 缓存读取失败降级日志
- DeleteRefreshToken: Redis 缓存删除失败降级日志
- DeleteUserRefreshTokens: Redis 批量删除失败降级日志

feat: 为 redis_bucket.go 添加限流日志 edc66625ba

添加 trace-aware 日志：
- Error: Redis 限流检查失败（fail-open 降级）
- Warn: 限流触发，记录 key 和 retry_after_sec

docs: 补充存储层和限流器日志实现说明 d430e6e5b2

添加 PostgreSQL、Redis、限流器三个模块的日志实现文档：
- PostgreSQL 4 个 repository 的日志策略和代码示例
- Redis 会话存储、缓存装饰器、限流器的日志级别选择
- 存储层日志查询示例（数据库错误、Redis 降级）
- 更新架构图，添加存储层节点

docs: 同步限流和鉴权文档的日志实现说明 239f8f9877

- 更新限流文档：limiter 内部使用 trace.FromContext 自动记录日志
- 更新鉴权文档：Redis 降级策略使用 trace-aware 日志
- 引用 13-日志追踪.md 作为详细说明
- 移除过时的手动 logger.Log 调用示例

huanghaosheng merged commit 583c33727a into develop

2026-06-21 23:23:23 +08:00

huanghaosheng referenced this issue from a commit

2026-06-21 23:23:24 +08:00

Merge pull request 'feat: 实现日志追踪链路' (#185) from feature/log-track into develop

huanghaosheng deleted branch feature/log-track

2026-06-21 23:56:52 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: XEngineers/CamTalk#185