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-TW.md