This guide provides Alibaba Cloud's RocketMQ MQTT service architecture, high‑risk operations, routine maintenance, troubleshooting, and command references…
The RocketMQ MQTT service is a lightweight messaging middleware for mobile and IoT scenarios, built on Alibaba Cloud's proprietary cloud. It consists of MQTT Connection Server (CS), MQTT Dispatch Server (DS), Dauth permission service, and a backend RocketMQ storage component. The CS handles client long‑connections and message forwarding, while the DS processes downstream messages and offline storage.
The document covers an operations overview, classification of high‑risk operations, preparation steps, routine maintenance procedures, fault handling methods, a set of operational commands, capacity assessment guidelines, log reference locations, and instructions for updating configuration parameters. This manual is written in Chinese.
| MQTT CS Component | Core gateway node handling client long‑connections and message transfer |
|---|---|
| MQTT DS Component | Backend service that forwards downstream messages and generates offline messages |
| Connection Count Monitoring | Execute `ss -s` inside the mq‑mqtt‑cs container |
| TPS Monitoring | Check `/home/admin/logs/onsproxy/commercial_stat.log` for per‑minute TPS summary |
| Log File for Authentication Errors | `/home/admin/logs/onsproxy/authManager.log` |
Operations are classified as G1 (no impact, no change request), G2 (requires change request and product side confirmation), and G3 (requires change request, product and customer confirmation, may impact business).
Log into the MQTT CS container and examine `/home/admin/logs/onsproxy/commercial_stat.log` for the per‑minute TPS field.
The authentication logs are stored in `/home/admin/logs/onsproxy/authManager.log`.
Log into each MQTT CS container and run `curl -s "http://127.0.0.1:9999/csConfig/csUpdateMqttConfig?key={KEY}&value={VALUE}"` with the desired key and value.