docs: 同步更新日志系统文档(文件轮转 + 分级存储)

- system-architecture.md: 更新环境日志策略表,新增文件输出和轮转策略说明
- phase1 实施计划: 更新 LogConfig 结构体定义,补充 LogFileConfig

Made-with: Cursor
This commit is contained in:
bujinyuan
2026-02-28 15:18:20 +08:00
parent 63c6079667
commit 323232d875
2 changed files with 36 additions and 6 deletions

View File

@@ -317,8 +317,24 @@ func TraceMiddleware() gin.HandlerFunc {
| 环境 | 最低级别 | 输出方式 | 格式 |
|------|---------|---------|------|
| 开发 | DEBUG | 控制台(彩色 | 可读文本 |
| 生产 | INFO | 文件 + 控制台 | JSON 结构化 |
| 开发 | DEBUG | 控制台(彩色文本+ 文件JSON | 控制台 text / 文件 JSON |
| 生产 | INFO | 控制台JSON+ 文件JSON | JSON 结构化 |
**日志文件输出(基于 lumberjack 轮转):**
| 文件 | 级别 | 用途 |
|------|------|------|
| `logs/app.log` | 全量(与配置级别一致) | 持久化存储、接入 ELK/Loki |
| `logs/error.log` | 仅 WARN + ERROR | 快速定位问题 |
**日志文件轮转策略:**
| 配置项 | 开发默认值 | 生产建议值 | 说明 |
|--------|-----------|-----------|------|
| `max_size` | 50 MB | 200 MB | 单文件最大大小,超过自动切割 |
| `max_backups` | 10 | 30 | 保留的旧日志文件数量 |
| `max_age` | 30 天 | 90 天 | 旧日志保留天数 |
| `compress` | false | true | 是否压缩归档文件 |
### 8.4 日志格式规范