系统日志
系统日志
项目提供 2 类 4 种系统日志：
- 审计日志：用户的操作日志、登录日志
- API 日志：RESTful API 的访问日志、错误日志
#1. 操作日志
操作日志，记录「谁」在「什么时间」对「什么对象」做了「什么事情」。
打开 [系统管理 -> 审计日志 -> 操作日志] 菜单，可以看到对应的列表，如下图所示：
操作日志的记录，由 yudao-spring-boot-starter-biz-operatelog (opens new window)技术组件实现，OperateLogAspect (opens new window)通过 Spring AOP 拦声明了 @OperateLog (opens new window)注解的方法，异步记录日志。使用示例如下：
操作日志的存储，由 yudao-module-system 的 OperateLog (opens new window)模块实现，记录到数据库的 system_operate_log (opens new window)表。
#1.1 @OperateLog 注解
@OperateLog 注解，一共有 6 个属性，如下图所示：
module属性：操作模块，例如说：用户、岗位、部门等等。为空时，默认会读取类上的 Swagger@Tag注解的name属性。name属性：操作名，例如说：新增用户、修改用户等等。为空时，默认会读取方法的 Swagger@Operation注解的summary属性。type属性：操作类型，在 OperateTypeEnum (opens new window)枚举。目前有GET查询、CREATE新增、UPDATE修改、DELETE删除、EXPORT导出、IMPORT导入、OTHER其它，可进行自定义。
#1.2 自动记录
操作日志往往记录的是针对某个对象的写操作，所以针对 POST、PUT、DELETE 等写请求，yudao-spring-boot-starter-biz-operatelog 组件会自动记录操作日志。
- 基于请求方法，转换出对应的
type操作方法：POST 对应CREATE类型，PUT 对应UPDATE类型，DELETE 对应DELETE类型，其它对应OTHER类型。 - 基于 Swagger 注解，转换出对应的
module操作模块、name操作名。
因此，绝大多数 RESTful API 对应的方法，无需添加 @OperateLog 注解。例如说：
一般来说，只有两种场景需要添加 @OperateLog 注解。
① 场景一：需要自定义 @OperateLog 注解的属性。例如说：
② 场景二：不想自动记录操作日志。例如说：
#1.3 后续优化
yudao-spring-boot-starter-biz-operatelog 组件目前提供的是轻量级的操作日志的解决方案，暂时未提供很好的记录操作对应、操作明细、拓展字段的能力。例如说：
- 【新增】2021-09-16 10:00 订单创建，订单号：NO.11089999，其中涉及变量订单号 “NO.11089999”
- 【修改】2021-09-16 10:00 用户小明修改了订单的配送地址：从 “金灿灿小区” 修改到 “银盏盏小区”
未来，艿艿会引入老友开源的 https://github.com/mouzt/mzt-biz-log (opens new window)操作日志组件，优化项目的操作日志功能。大家记得给个 Star 哟！
目前，如果要记录具体的操作明细、拓展字段，可以调用 OperateLogUtils (opens new window)的静态方法，代码如下：
#2. 登录日志
登录日志，记录用户的登录、登出行为，包括成功的、失败的。
打开 [系统管理 -> 审计日志 -> 登录日志] 菜单，可以看对应的列表，如下图所示：
登录日志的存储，由 yudao-module-system 的 LoginLog (opens new window)模块实现，记录到数据库的 system_login_log (opens new window)表。
登录类型通过 LoginLogTypeEnum (opens new window)枚举，登录结果通过 LoginResultEnum (opens new window)枚举，都可以自定义。代码如下：
#3. API 访问日志
API 访问日志，记录 API 的每次调用，包括 HTTP 请求、用户、开始时间、时长等等信息。
打开 [基础设施 -> API 日志 -> 访问日志] 菜单，可以看对应的列表，如下图所示：
访问日志的记录，由 yudao-spring-boot-starter-web (opens new window)技术组件实现，通过 ApiAccessLogFilter (opens new window)过滤 RESTful API 请求，异步记录日志。
访问日志的存储，由 yudao-module-infra 的 AccessLog (opens new window)模块实现，记录到数据库的 infra_api_access_log (opens new window)表。
#4. API 错误日志
API 错误日志，记录每次 API 的异常调用，包括 HTTP 请求、用户、异常的堆栈等等信息。
打开 [基础设施 -> API 日志 -> 错误日志] 菜单，可以看对应的列表，如下图所示：
错误日志的记录，由 yudao-spring-boot-starter-web (opens new window)技术组件实现，通过 GlobalExceptionHandler (opens new window)拦截每次 RESTful API 的系统异常，异步记录日志。
错误日志的存储，由 yudao-module-infra 的 ErrorLog (opens new window)模块实现，记录到数据库的 infra_api_error_log (opens new window)表。
