队列监控页面使用指南

页面访问

队列监控页面位于：/views/modules/mm/queue.html

页面功能

1. 概览统计

页面顶部显示四个关键指标：

-活跃队列总数：当前有请求等待的队列数量

-等待请求总数：所有队列中等待执行的请求总数

-执行中请求：当前正在执行的请求数量

-最大队列长度：所有队列中最长的队列长度

2. 自动刷新功能

• 点击”开启自动刷新”按钮启用自动刷新（每5秒刷新一次）
• 点击”停止自动刷新”按钮关闭自动刷新
• 可随时点击”手动刷新”按钮立即更新数据

3. 队列列表

显示所有租户的队列状态，包括：

-租户ID：队列所属的租户标识

-队列长度：当前队列中的请求数量

-当前执行请求：正在执行的请求UUID（显示前16位）

-状态：队列当前状态

• 🟢 空闲：队列为空
• 🟡 执行中：有请求正在执行
• 🔴 异常：队列有请求但没有执行中的请求

-操作：可执行的操作按钮

4. 状态说明

队列状态图标说明

-**绿色标签 (0)**：队列为空，无等待请求

-**黄色标签 (数字)**：队列中有等待的请求

-蓝色标签：当前执行的请求ID

-灰色文字：无执行请求

状态类型

-空闲：队列无任何请求

-执行中：有请求正在执行，可能还有其他请求在等待

-异常：队列中有请求但没有正在执行的请求（可能需要清理）

5. 操作功能

查看详情

• 点击操作列的”详情”按钮或选中行后点击”查看详情”

• 弹出详情窗口显示：

  • 租户ID和队列长度
  • 当前执行请求的完整UUID
  • 队列中所有请求的列表（按执行顺序排列）
  • 第一个请求标记为”执行中”，其余为”等待中”

清空队列

• 只有当队列长度大于0时才显示”清空”按钮
• 点击后会弹出确认对话框
• 确认后将清除队列中所有等待的请求
• ⚠️ 注意：此操作会中断所有等待的请求，请谨慎使用

6. 搜索和筛选

• 可以通过租户ID搜索特定的队列
• 点击”重置”按钮清空搜索条件并显示所有队列

权限说明

页面需要以下权限：

-queueManagement:view - 查看队列状态

-queueManagement:clear - 清空队列

没有相应权限的用户将无法看到对应的操作按钮。

使用场景

1. 日常监控

• 开启自动刷新功能，实时监控队列状态
• 关注”等待请求总数”和”最大队列长度”指标
• 当看到红色异常状态时及时处理

2. 问题排查

• 当业务反馈操作缓慢时，查看对应租户的队列长度
• 通过队列详情查看具体的请求排队情况
• 分析队列积压的原因

3. 紧急处理

• 当队列出现异常积压时，可以使用清空功能
• 清空前建议先查看详情了解具体情况
• 清空后通知相关用户重新提交请求

技术说明

数据刷新机制

• 手动刷新：立即获取最新数据
• 自动刷新：每5秒钟自动获取最新数据
• 页面加载时自动执行一次查询

统计计算规则

-活跃队列：队列长度 > 0 的队列数量

-等待请求：所有队列长度之和 - 执行中请求数

-执行中请求：有 currentExecutingRequest 的队列数量

-最大队列长度：所有队列中长度的最大值

前端技术栈

• Vue.js：数据绑定和组件化
• jQuery jqGrid：表格展示
• Bootstrap：UI框架
• 自定义CSS：样式美化

注意事项

1.性能考虑：队列监控会频繁访问Redis，大量租户时注意性能影响

2.权限控制：确保只有授权用户才能访问监控页面

3.操作审计：清空队列等关键操作会记录系统日志

4.浏览器兼容：建议使用现代浏览器以获得最佳体验

5.移动端适配：页面已优化移动端显示效果

故障处理

常见问题

Q: 页面显示”获取队列状态失败”

A: 检查Redis连接状态和后端服务是否正常

Q: 自动刷新不工作

A: 检查浏览器是否阻止了定时器，或刷新页面重试

Q: 清空队列后仍显示有请求

A: 可能有新请求进入，手动刷新查看最新状态

Q: 队列状态显示异常

A: 可能是Redis数据不一致，可以尝试清空队列解决

联系支持

如遇到技术问题，请联系系统管理员或查看系统日志获取详细错误信息。