消息队列 (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-CN.md