# 系统日志

系统日志通过右上角用户菜单 →「系统日志」进入，包含三个标签页：**访问日志**、**登录日志**、**运行日志**。页头右上角可选择日志保留时长（30 天 / 90 天 / 180 天 / 永久保留）。

## 访问日志

![访问日志](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/logs-http.png)

记录每一次接口访问：

- 筛选：关键字（路径/参数/IP）、请求方法、状态码。
- 表格列：时间、方法、路径、参数、状态码、耗时、用户、IP。
- 支持分页与刷新。

## 登录日志

![登录日志](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/logs-login.png)

记录每次登录尝试（成功与失败）：

- 筛选：关键字（用户名等）、结果（成功/失败）。
- 表格列：时间、用户名、结果、说明、IP、User-Agent。

## 运行日志

![运行日志](https://adcarac.oss-cn-beijing.aliyuncs.com/finance-app-docs/screenshots/logs-app.png)

在线查看后端运行日志：

- 筛选：日期、时间范围（最近 1/6/24 小时或全部）、级别（ERROR/WARN/INFO/DEBUG）、关键字、行数。
- 开启「实时」后通过 SSE 订阅新增日志，先回放最近内容再增量推送。
- 页面显示当前日志文件名与命中行数。

## 日志清理

访问日志与登录日志会按配置的保留天数自动清理（默认 30 天，设为永久保留则不清理），无需手动维护。

::: tip 排查问题
接口报错时，可先在「访问日志」定位失败请求（状态码 4xx/5xx），再到「运行日志」按时间与关键字查看异常堆栈。
:::