## 文档概述 「消息队列」是 MuuCmf T6 后台管理系统中用于监控与管理异步消息队列运行状态的模块。 本模块以**状态面板 + 表格列表**的形式,集中展示队列服务的运行状态(服务是否启动、队列长度、心跳情况)以及各队列的详细运行数据(队列名称、类型、状态、消息数量、处理中、失败数、工作进程等),并支持**刷新状态**与**发送心跳**操作。它是系统异步任务处理能力的统一监控入口。 **核心用途:** - **监控队列服务状态**:查看队列服务是否正常运行、当前队列积压情况与心跳状态; - **掌握各队列运行数据**:查看每个队列的消息数量、处理中、失败数、工作进程等,判断异步任务处理是否顺畅; - **主动刷新与心跳**:通过「刷新状态」获取最新队列数据,通过「发送心跳」维持/触发队列服务的心跳。 --- ## 1. 功能说明 「消息队列」用于监控系统异步消息队列的运行情况。系统的短信发送、邮件通知、异步任务处理等耗时操作,通常通过消息队列异步执行,以提升响应效率。队列服务运行是否正常、消息是否积压、是否存在失败消息,直接影响这些异步功能能否及时完成。 通过本模块,管理员可以随时查看队列服务的整体状态与各队列的详细数据,及时发现队列积压、处理失败等问题,并通过刷新状态、发送心跳等方式维护队列服务运行。 ## 2. 功能入口 左侧导航:**系统 → 异步任务 → 消息队列** 进入方式:点击顶部「系统」菜单 → 左侧「异步任务」展开 → 选择「消息队列」子项,右侧主区域即显示消息队列监控页面。  ## 3. 页面组成 消息队列页面分为状态栏、列表区和分页区三部分: | 区域 | 内容 | | --- | --- | | 状态栏 | 显示队列服务运行状态(如「队列服务已停止」)、队列长度、上次心跳、心跳间隔;右侧提供「刷新状态」「发送心跳」按钮 | | 列表区 | 以表格形式展示各队列的运行数据,每行对应一个队列 | | 分页区 | 页面底部显示队列总数(如 Total 0)及分页信息 | ## 4. 配置项说明 ### 4.1 状态栏信息说明 | 项目 | 说明 | | --- | --- | | 队列服务状态 | 显示队列服务当前是否运行,如「队列服务已停止」表示服务未启动 | | 队列长度 | 当前队列中待处理消息的数量 | | 上次心跳 | 队列服务最近一次心跳的时间,显示「无」表示尚未收到心跳 | | 心跳间隔 | 队列服务的心跳时间间隔(如 0 秒) | ### 4.2 列表字段说明 消息队列列表包含以下字段: | 字段 | 说明 | | --- | --- | | ID | 队列的唯一标识编号 | | 队列名称 | 队列的名称,用于标识该队列的用途 | | 队列类型 | 队列的类型(如所用队列驱动类型) | | 状态 | 队列的运行状态 | | 消息数量 | 队列中当前的消息总数 | | 处理中 | 正在处理中的消息数量 | | 失败数 | 处理失败的消息数量 | | 工作进程 | 处理该队列的工作进程情况 | | 创建时间 | 队列的创建时间 | | 操作 | 针对当前队列可执行的操作(如启动、停止、清理等,视系统提供而定) | > 说明:当系统暂无队列数据时,列表显示「No Data」,总数为 0;列表中出现的操作项以实际系统提供的按钮为准。 ## 5. 操作方法 ### 5.1 查看队列状态 1. 进入「系统 → 异步任务 → 消息队列」页面; 2. 查看顶部状态栏,了解队列服务是否运行、队列长度、上次心跳与心跳间隔; 3. 在列表中查看各队列的消息数量、处理中、失败数、工作进程等数据。 ### 5.2 刷新状态 点击右上角「刷新状态」按钮,系统重新获取最新的队列运行数据,便于实时查看队列变化。 ### 5.3 发送心跳 点击右上角「发送心跳」按钮,向队列服务发送心跳信号,用于维持或触发队列服务的心跳,确认服务在线。 ### 5.4 分页查看 队列较多时,可通过页面底部的分页区翻页浏览全部队列。 ## 6. 使用建议 1. 「队列服务已停止」时,异步消息(如短信、邮件)可能无法及时处理,请及时排查队列服务是否启动; 2. 关注「队列长度」与「消息数量」,若持续积压,说明处理能力不足或服务异常,需及时处理; 3. 关注「失败数」,出现失败消息时,应结合异步任务日志排查失败原因; 4. 定期点击「刷新状态」查看最新运行数据,发现异常及时联系运维或开发人员; 5. 「发送心跳」用于确认队列服务在线,若发送后仍无心跳或状态未恢复,请检查队列服务进程与配置。 通过以上操作,即可完成对 MuuCmf T6 后台「消息队列」模块的日常监控与维护。