docs: 同步更新日志系统文档(文件轮转 + 分级存储)
- system-architecture.md: 更新环境日志策略表,新增文件输出和轮转策略说明 - phase1 实施计划: 更新 LogConfig 结构体定义,补充 LogFileConfig Made-with: Cursor
This commit is contained in:
@@ -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 日志格式规范
|
||||
|
||||
|
||||
Reference in New Issue
Block a user