系统监控 (monitor)

概述

监控模块是系统的重要组成部分，提供对系统运行状态、用户行为、缓存性能、异常错误等多方面的监控功能。该模块主要包含缓存监控、登录日志监控、操作日志监控、在线用户监控和错误日志监控五大功能模块。

模块结构

plus.ruoyi.system.monitor
├── controller/          # 控制层
│   ├── CacheController.java
│   ├── SysErrorLogController.java
│   ├── SysLoginLogController.java
│   ├── SysOperlogController.java
│   └── SysUserOnlineController.java
├── dao/                 # 数据访问层
│   ├── ISysErrorLogDao.java
│   └── impl/
│       └── SysErrorLogDaoImpl.java
├── domain/              # 领域层
│   ├── bo/              # 业务对象
│   │   ├── SysErrorLogBo.java
│   │   ├── SysLoginLogBo.java
│   │   └── SysOperLogBo.java
│   ├── SysErrorLog.java
│   ├── SysLoginLog.java
│   └── SysOperLog.java
│   └── vo/              # 视图对象
│       ├── CacheMonitorVo.java
│       ├── SysErrorLogVo.java
│       ├── SysLoginLogVo.java
│       └── SysOperLogVo.java
├── mapper/              # 数据访问层
│   ├── SysErrorLogMapper.java
│   ├── SysErrorLogMapper.xml
│   ├── SysLoginLogMapper.java
│   ├── SysLoginLogMapper.xml
│   ├── SysOperLogMapper.java
│   └── SysOperLogMapper.xml
└── service/             # 服务层
    ├── ISysErrorLogService.java
    ├── ISysLoginLogService.java
    ├── ISysOperLogService.java
    └── impl/
        ├── SysErrorLogServiceImpl.java
        ├── SysLoginLogServiceImpl.java
        └── SysOperLogServiceImpl.java

功能模块详解

1. 缓存监控模块

核心组件： CacheController

主要功能：

Redis服务器状态监控
缓存数据库大小统计
命令执行统计分析

核心接口：

获取缓存监控信息

java

@GetMapping("/getCacheInfo")
public R<CacheMonitorVo> getCacheInfo()

功能说明：

获取Redis服务器详细信息（内存、CPU、连接数等）
统计当前数据库键数量
分析各命令执行次数统计
权限要求：monitor:cache:query

返回数据结构：

info: Redis服务器配置和运行状态
dbSize: 数据库键总数
commandStats: 命令执行统计（命令名称和执行次数）

2. 登录日志监控模块

核心组件： SysLoginLogController、SysLoginLogServiceImpl

主要功能：

用户登录行为记录
登录日志查询和管理
登录失败统计和账户锁定管理

核心接口：

分页查询登录日志

java

@GetMapping("/pageLoginLogs")
public R<PageResult<SysLoginLogVo>> pageLoginLogs(SysLoginLogBo loginLog, PageQuery pageQuery)

批量删除登录日志

java

@DeleteMapping("/deleteLoginLogs/{infoIds}")
public R<Void> deleteLoginLogs(@PathVariable Long[] infoIds)

清理登录日志

java

@DeleteMapping("/clearLoginLogs")
public R<Void> clearLoginLogs()

账户解锁

java

@GetMapping("/unlockLoginLog/{userName}")
public R<Void> unlockLoginLog(@PathVariable String userName)

导出登录日志

java

@PostMapping("/exportLoginLogs")
public void exportLoginLogs(SysLoginLogBo loginLogBo, PageQuery pageQuery, HttpServletResponse response)

数据模型：

SysLoginLog 实体字段：

infoId: 访问ID（主键）
tenantId: 租户ID
userId: 用户ID
userName: 用户账号
deviceType: 设备类型
status: 登录状态
ipaddr: 登录IP地址
loginLocation: 登录地点
browser: 浏览器类型
os: 操作系统
msg: 提示消息
loginTime: 访问时间

特殊功能：

支持基于IP、用户名、时间范围的复合查询
支持模糊搜索（用户名、IP、地点、消息等）
自动记录登录事件（通过事件监听器异步处理）
支持账户锁定和解锁机制

3. 操作日志监控模块

核心组件： SysOperlogController、SysOperLogServiceImpl

主要功能：

系统操作行为记录
操作日志查询和分析
操作统计和审计

核心接口：

分页查询操作日志

java

@GetMapping("/pageOperLogs")
public R<PageResult<SysOperLogVo>> pageOperLogs(SysOperLogBo operLog, PageQuery pageQuery)

批量删除操作日志

java

@DeleteMapping("/deleteOperLogs/{operIds}")
public R<Void> deleteOperLogs(@PathVariable Long[] operIds)

清理操作日志

java

@DeleteMapping("/clearOperLogs")
public R<Void> clearOperLogs()

导出操作日志

java

@PostMapping("/exportOperLogs")
public void exportOperLogs(SysOperLogBo bo, PageQuery pageQuery, HttpServletResponse response)

数据模型：

SysOperLog 实体字段：

operId: 日志主键
tenantId: 租户ID
title: 操作模块
operType: 操作类型
method: 请求方法
requestMethod: 请求方式
operatorType: 操作用户类别
operName: 操作人员
deptName: 部门名称
operUrl: 请求URL
operIp: 操作地址
operLocation: 操作地点
operParam: 请求参数
jsonResult: 返回参数
status: 操作结果
errorMsg: 错误消息
operTime: 操作时间
costTime: 消耗时间

特殊功能：

支持按操作类型、状态、操作人员等多维度查询
支持时间范围查询和模糊搜索
自动记录操作事件（通过事件监听器异步处理）
自动获取IP地址对应的地理位置信息

4. 在线用户监控模块

核心组件： SysUserOnlineController

主要功能：

在线用户状态监控
强制用户下线
多设备登录管理

核心接口：

获取在线用户列表

java

@GetMapping("/pageOnlineUsers")
public R<PageResult<SysUserOnlineVo>> pageOnlineUsers(String ipaddr, String userName)

强制用户下线

java

@DeleteMapping("/forceLogout/{tokenId}")
public R<Void> forceLogout(@PathVariable String tokenId)

获取当前用户在线设备

java

@GetMapping("/listCurrentUserOnlines")
public R<List<SysUserOnlineVo>> listCurrentUserOnlines()

移除当前用户指定设备

java

@DeleteMapping("/removeCurrentDevice/{tokenId}")
public R<Void> removeCurrentDevice(@PathVariable String tokenId)

特殊功能：

基于Redis缓存的在线状态管理
支持按IP地址和用户名过滤
自动过滤已过期的token
支持多设备登录管理

5. 错误日志监控模块

核心组件： SysErrorLogController、SysErrorLogServiceImpl、SysErrorLogDaoImpl

主要功能：

系统异常自动捕获和记录
错误日志查询和管理
错误处理状态跟踪
智能去重和统计分析

核心接口：

分页查询错误日志

java

@GetMapping("/pageErrorLogs")
public R<PageResult<SysErrorLogVo>> pageErrorLogs(SysErrorLogBo bo, PageQuery pageQuery)

获取错误日志详情

java

@GetMapping("/getErrorLog/{id}")
public R<SysErrorLogVo> getErrorLog(@PathVariable Long id)

更新错误处理状态

java

@PutMapping("/updateHandleStatus")
public R<Void> updateHandleStatus(@RequestBody SysErrorLogBo bo)

批量删除错误日志

java

@DeleteMapping("/deleteErrorLogs/{ids}")
public R<Void> deleteErrorLogs(@PathVariable Long[] ids)

清空错误日志

java

@DeleteMapping("/clearErrorLogs")
public R<Void> clearErrorLogs()

导出错误日志

java

@PostMapping("/exportErrorLogs")
public void exportErrorLogs(SysErrorLogBo bo, PageQuery pageQuery, HttpServletResponse response)

数据模型：

SysErrorLog 实体字段：

id: 主键ID
tenantId: 租户ID
errorLevel: 严重级别（ERROR/WARN/FATAL）
errorType: 异常类名
errorCode: 业务错误码
errorMessage: 错误消息
errorStack: 异常堆栈
requestUri: 请求URI
requestMethod: 请求方法
requestParams: 请求参数
requestIp: 请求IP
userAgent: User-Agent
userId: 用户ID
userName: 用户名
deptId: 部门ID
clientType: 平台类型（PC/WECHAT/ANDROID/IOS/H5）
clientVersion: 客户端版本
moduleName: 模块名称
businessType: 业务类型
businessKey: 业务关键字
traceId: 链路追踪ID
serverName: 服务器名称
serverIp: 服务器IP
appVersion: 应用版本
sqlStatement: SQL语句
sqlParams: SQL参数
sqlDuration: SQL耗时(ms)
occurrenceCount: 发生次数
firstTime: 首次发生时间
lastTime: 最后发生时间
handleStatus: 处理状态（0待处理/1已处理/2已忽略）
handleBy: 处理人
handleTime: 处理时间
handleRemark: 处理备注
createTime: 创建时间
remark: 备注

特殊功能：

异步记录机制：使用 @Async 注解异步记录所有后端异常，不影响主业务流程性能
智能去重机制：基于 Redis 实现 1 分钟窗口去重，相同错误（异常类型+URI+消息）只记录一次，重复时自动增加 occurrence_count 计数
全面信息采集：记录异常堆栈、请求信息（URI/方法/参数/IP）、用户信息（ID/姓名/部门/租户）、服务器环境（主机名/IP/版本）等完整上下文
双场景支持：通过 resolveToken() 方法同时支持 OpenAPI 请求（从 JUST_CREATED 属性获取 token）和普通请求（从请求头获取 token）的用户信息解析
完整管理功能：提供分页查询、详情查看、处理状态更新、批量删除、清空日志等完整的错误日志管理能力
支持按严重级别、异常类型、用户名、平台类型、处理状态等多维度查询
支持时间范围查询和模糊搜索
自动获取IP地址对应的地理位置信息
支持错误统计和趋势分析

权限配置

功能模块	所需权限	说明
缓存监控	`monitor:cache:query`	查看缓存监控信息
登录日志查询	`monitor:loginLog:query`	查询登录日志
登录日志删除	`monitor:loginLog:delete`	删除和清理登录日志
登录日志导出	`monitor:loginLog:export`	导出登录日志
账户解锁	`monitor:loginLog:unlock`	解锁被锁定的账户
操作日志查询	`monitor:operLog:query`	查询操作日志
操作日志删除	`monitor:operLog:delete`	删除和清理操作日志
操作日志导出	`monitor:operLog:export`	导出操作日志
在线用户查询	`monitor:online:query`	查看在线用户
强制下线	`monitor:online:forceLogout`	强制用户下线
错误日志查询	`monitor:errorLog:query`	查询错误日志
错误日志更新	`monitor:errorLog:update`	更新错误处理状态
错误日志删除	`monitor:errorLog:delete`	删除和清理错误日志
错误日志导出	`monitor:errorLog:export`	导出错误日志

技术特性

1. 异步事件处理

使用@EventListener和@Async注解实现日志异步记录
避免日志记录影响主业务流程性能
支持自定义事件监听器

2. 分页查询支持

基于MyBatis-Plus的分页查询机制
支持动态条件查询和模糊搜索
提供统一的分页参数和返回格式

3. 数据导出功能

基于EasyExcel的数据导出功能
支持自定义导出字段和格式
支持字典数据转换

4. 缓存集成

基于Redis的数据缓存
支持Redisson连接池
提供缓存监控和统计功能

5. IP地理位置解析

自动解析IP地址对应的地理位置
支持登录和操作日志的位置记录

配置说明

1. 数据库配置

确保以下数据表存在：

sys_login_log: 登录日志表
sys_oper_log: 操作日志表
sys_error_log: 错误日志表

2. Redis配置

确保Redis服务正常运行，并配置Redisson连接工厂。

3. 权限配置

在权限管理系统中配置相应的监控权限。

使用示例

1. 查询登录日志

java

// 构建查询条件
SysLoginLogBo loginLogBo = new SysLoginLogBo();
loginLogBo.setUserName("admin");
loginLogBo.setStatus("0"); // 成功登录
loginLogBo.setIpaddr("192.168.1.1");

// 分页参数
PageQuery pageQuery = new PageQuery();
pageQuery.setPageNum(1);
pageQuery.setPageSize(10);

// 执行查询
R<PageResult<SysLoginLogVo>> result = loginLogController.pageLoginLogs(loginLogBo, pageQuery);

2. 获取缓存监控信息

java

R<CacheMonitorVo> result = cacheController.getCacheInfo();
CacheMonitorVo cacheInfo = result.getData();

// 获取Redis信息
Properties info = cacheInfo.getInfo();
// 获取数据库大小
Long dbSize = cacheInfo.getDbSize();
// 获取命令统计
List<Map<String, String>> commandStats = cacheInfo.getCommandStats();

3. 强制用户下线

java

// 获取在线用户
R<PageResult<SysUserOnlineVo>> onlineUsers = userOnlineController.pageOnlineUsers("", "admin");

// 强制下线指定token
String tokenId = "your-token-id";
R<Void> result = userOnlineController.forceLogout(tokenId);

注意事项

权限控制：所有监控接口都需要相应的权限验证，确保只有授权用户才能访问敏感信息。
性能考虑：日志记录采用异步方式，避免影响主业务性能。大量数据查询时建议使用分页和筛选条件。
数据清理：定期清理历史日志数据，避免数据库存储压力过大。
安全性：登录日志包含敏感信息（IP地址、用户信息），需要严格控制访问权限。
监控告警：建议结合监控系统，对异常登录、频繁操作等行为进行告警。

系统监控 (monitor) ​

概述 ​

模块结构 ​

功能模块详解 ​

1. 缓存监控模块 ​

获取缓存监控信息 ​

2. 登录日志监控模块 ​

分页查询登录日志 ​

批量删除登录日志 ​

清理登录日志 ​

账户解锁 ​

导出登录日志 ​

3. 操作日志监控模块 ​

分页查询操作日志 ​

批量删除操作日志 ​

清理操作日志 ​

导出操作日志 ​

4. 在线用户监控模块 ​

获取在线用户列表 ​

强制用户下线 ​

获取当前用户在线设备 ​

移除当前用户指定设备 ​

5. 错误日志监控模块 ​

分页查询错误日志 ​

获取错误日志详情 ​

更新错误处理状态 ​

批量删除错误日志 ​

清空错误日志 ​

导出错误日志 ​

权限配置 ​

技术特性 ​

1. 异步事件处理 ​

2. 分页查询支持 ​

3. 数据导出功能 ​

4. 缓存集成 ​

5. IP地理位置解析 ​

配置说明 ​

1. 数据库配置 ​

2. Redis配置 ​

3. 权限配置 ​

使用示例 ​

1. 查询登录日志 ​

2. 获取缓存监控信息 ​

3. 强制用户下线 ​

注意事项 ​

系统监控 (monitor)

概述

模块结构

功能模块详解

1. 缓存监控模块

获取缓存监控信息

2. 登录日志监控模块

分页查询登录日志

批量删除登录日志

清理登录日志

账户解锁

导出登录日志

3. 操作日志监控模块

分页查询操作日志

批量删除操作日志

清理操作日志

导出操作日志

4. 在线用户监控模块

获取在线用户列表

强制用户下线

获取当前用户在线设备

移除当前用户指定设备

5. 错误日志监控模块

分页查询错误日志

获取错误日志详情

更新错误处理状态

批量删除错误日志

清空错误日志

导出错误日志

权限配置

技术特性

1. 异步事件处理

2. 分页查询支持

3. 数据导出功能

4. 缓存集成

5. IP地理位置解析

配置说明

1. 数据库配置

2. Redis配置

3. 权限配置

使用示例

1. 查询登录日志

2. 获取缓存监控信息

3. 强制用户下线

注意事项