50 lines
1.7 KiB
Markdown
50 lines
1.7 KiB
Markdown
# 6.20 日志管理
|
||
|
||
:::tip 概述
|
||
日志管理涵盖两类审计表：**操作日志**（gin_operation_log，接口调用审计）与**登录日志**（gin_login_log，登录行为审计）。均由系统自动写入，管理页只读检索 + 清理。
|
||
:::
|
||
|
||
## 功能清单
|
||
|
||
两类日志路径前缀与模块名不同（注意拼写）：
|
||
|
||
### 操作日志（/api/oper/log/*，权限码 sys:operLog:*）
|
||
|
||
| 接口 | 说明 |
|
||
|---|---|
|
||
| Page / List / Detail | 检索（操作人/类型/时间/IP） |
|
||
| Delete / BatchDelete | 手动清理（软删除） |
|
||
|
||
### 登录日志（/api/login/log/*，权限码 sys:loginLog:*）
|
||
|
||
| 接口 | 说明 |
|
||
|---|---|
|
||
| Page / List / Detail | 检索（用户/结果/时间/地域） |
|
||
| Delete / BatchDelete | 手动清理 |
|
||
|
||
## 记录来源
|
||
|
||
- 操作日志：OperationLog 中间件按 RouteSpec 声明异步落库（[5.14 操作日志](/zh/core/operation-log.html)）
|
||
- 登录日志：auth 模块在登录链路内写入（[5.15 登录日志](/zh/core/login-log.html)）
|
||
|
||
## 保留策略
|
||
|
||
自动保留：`job.logRetentionDays`（默认 90 天），LogClean 定时任务超期**物理清理**（经 WithPhysicalDelete 放行）。管理页的手动删除是软删除，两者不冲突。
|
||
|
||
## 检索建议
|
||
|
||
| 场景 | 检索方式 |
|
||
|---|---|
|
||
| 追查单次操作 | 响应头 X-Request-Id → 日志文件精确定位（表内按人/时间缩小范围） |
|
||
| 安全审计 | 登录日志按 status=1 聚合看失败来源 |
|
||
| 合规导出 | 操作日志按时间范围导出 |
|
||
|
||
## 管理界面
|
||
|
||
`system/logger`：操作日志与登录日志两个页签。
|
||
|
||
## 相关
|
||
|
||
- [5.14 操作日志](/zh/core/operation-log.html)
|
||
- [5.15 登录日志](/zh/core/login-log.html)
|