MQE UI 规范指南 (用户用)

引导您如何使用 GIIP 消息队列引擎 (MQE) 的仪表板界面及其操作方法。

🔔 前往消息队列 UI 配置 →

📋 概述

MQE UI 是用于视觉化监控基础设施与后端之间物理消息流动的工具。通过它，您可以直观地掌握代理数据是否正常传输，以及特定区间是否存在瓶颈。

🔍 核心界面构成

1. 实时流量仪表板

• TPS (Transactions Per Second): 通过实时图表显示每秒处理的消息数。
• Queue Depth: 通过柱状图显示当前等待处理的消息数。（超过阈值时以红色强调显示）

2. 消息追踪与搜索 (Message Explorer)

• 按 ID 搜索: 输入特定的消息唯一 ID 追踪传输路径和处理状态。
• 正文自动解析: 以易读的格式显示 JSON 格式的消息正文，并支持根据特定字段值进行过滤。

3. 按节点查看处理状态 (Node Status)

确认各代理节点（Antigravity, Gemini 等）当前是否与 MQ 服务器正常连接，以及最后发送消息的时间点。

🛠️ 使用方法

1. 进入 GIIP [系统管理] > [MQE 监控] 菜单。
2. 在顶部的 [选择频道] 下拉菜单中选择要分析的队列 (Queue)。
3. 启用 [Live Flow] 模式查看实时流入的消息样本。
4. 如有需要，在 [History Search] 选项卡中查询特定时间段的历史消息。

💡 技巧

• 调试: 当代理配置错误导致数据无法上传时，请先在 MQE UI 中确认实际数据包是否已到达服务器。
• 警报设置: 可以设置当特定队列的延迟超过 5 秒时，在 UI 顶部显示警告横幅。

故障排除

症状	原因	解决
仪表板上不显示消息	代理配置错误导致数据包未到达	先在 MQE UI 中确认实际数据包是否到达服务器，再检查代理配置
Queue Depth 柱状图以红色强调显示	待处理消息超过阈值	检查节点连接状态与消费者处理速度
顶部出现延迟警告横幅	特定队列的延迟超过 5 秒	使用 [History Search] 分析该时间段的瓶颈区间
特定节点显示为连接断开	自最后一次发送后未与 MQ 服务器重新连接	在 Node Status 中确认最后发送时间点并重启代理

---

版本: 1.0 最后更新: 2026-03-19 源文件:

giipv3/public/help/mqe-ui-spec.zh-CN.md