日志管理

当你需要“审计操作/排查接口访问/统计 PV/UV”时，从这篇开始。

youlai-django 提供操作日志模块（数据库表 sys_log + 查询接口），并提供请求上下文中间件用于输出结构化日志。

接口说明

日志分页

GET /api/v1/logs

常用参数：

• keywords：关键词
• createTime：创建时间范围 start,end
• pageNum：页码（默认 1）
• pageSize：每页数量（默认 10）

访问趋势

GET /api/v1/logs/views/trend?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD

访问概览

GET /api/v1/logs/views

常见问题

1) 日志统计接口 404

• 确认路径是否为 /api/v1/logs/views 与 /api/v1/logs/views/trend。

2) 日志输出里缺少 requestId/userId

• 确认已启用 RequestContextMiddleware（见 config/settings/base.py 的 MIDDLEWARE）
• 结构化日志过滤器由 core.middleware.request_context.RequestContextFilter 提供

代码位置

• 路由：apps/system/logs/urls.py
• 视图：apps/system/logs/views.py
• 请求上下文中间件：core/middleware/request_context.py（通过 core/middleware.py 导出）