日志管理

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

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

接口说明

日志分页

text

GET /api/v1/logs

常用参数：

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

访问趋势

text

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

访问概览

text

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 导出）