消息隊列 (MQ) 配置指南
引導您如何配置負責 GIIP 平台與代理之間異步通信的消息隊列（RabbitMQ/Azure Service Bus）。
📋 概述
消息隊列 (MQ) 是將代理收集的海量數據穩定傳輸至後端，並將用戶指令異步發送給代理的核心通道。正確的消息隊列配置是保證系統響應速度和數據完整性的關鍵。
🔍 核心配置項目
1. 連接資訊 (Connection Strings)
- Host Address: 輸入消息隊列伺服器的 IP 或 DNS 地址。
- 身份驗證資訊: 加密保存用戶名、密碼或共享存取金鑰 (Shared Access Key)。
2. 隊列 (Queue) 與主題 (Topic) 管理
- 入站隊列 (Inbound): 接收來自代理傳輸的指標/問題數據的路徑。
- 出站隊列 (Outbound): 向代理傳遞管理員指令 (
) 的路徑。execCommand - 死信隊列 (DLQ): 處理失敗的消息會被隔離至此處，用於故障分析。
3. 消息保留與重試策略
- 生存時間 (TTL): 設置消息在隊列中停留的最長時間。
- 重試次數 (Retry Count): 定義處理失敗時的最大嘗試次數。（預設：3 次）
🛠️ 配置方法
- 進入 GIIP [系統管理] > [MQ 配置] 菜單。
- 點擊 [Edit Configuration] 按鈕並選擇正在使用的消息隊列引擎類型。
- 輸入提供的連接字串，點擊 [Test Connection] 進行連接測試。
- 保存配置後，後端和代理中繼將自動重啟。
💡 使用技巧
- 負載均衡: 在大規模基礎設施環境中，建議分離流量集中的隊列，以防出現瓶頸。
- 整合監控: 建議設置警報，當隊列中的堆積消息數 (Message Depth) 驟增時通知管理員。
API 參考
有關此功能的 API 詳細規格，請參閱單獨的指南。
疑難排解
| 症狀 | 原因 | 解決 |
|---|---|---|
| [Test Connection] 失敗 | Host Address 或身份驗證資訊有誤 | 重新確認連接字串和身份驗證資訊後再次輸入 |
| 隊列中消息持續堆積 (Message Depth 驟增) | 處理延遲或消費瓶頸 | 分離流量集中的隊列並設置監控警報 |
| 處理失敗的消息似乎消失了 | 超過重試次數後移至 DLQ | 在死信隊列 (DLQ) 中查看被隔離的消息以分析故障 |
| 保存配置後通信短暫中斷 | 後端及代理中繼自動重啟 | 等待重啟完成 (屬正常現象) |
版本: 1.0 最後更新: 2026-03-19 源文件:
giipv3/public/help/mq-config.zh-TW.md