RocketMQ Admin Tool 全命令指南

RocketMQ Admin Tool 全命令指南
一、Topic管理

1. 创建/更新Topic

./mqadmin updateTopic -n namesrv_ip:9876 -c cluster_name -t topic_name -r 8 -w 8

参数 必填 说明
-n 是 NameServer地址
-t 是 Topic名称（仅允许字母数字下划线）
-r 否 读队列数（默认8）
-w 否 写队列数（默认8）
2. 删除Topic

./mqadmin deleteTopic -n namesrv_ip:9876 -c cluster_name -t topic_name

 

3. 查看Topic路由

./mqadmin topicRoute -n namesrv_ip:9876 -t topic_name

 

二、集群管理
1. 查看集群列表

./mqadmin clusterList -n namesrv_ip:9876 -m

 

参数 作用
-m 显示详细TPS信息
-i 刷新间隔（秒）
2. 集群延迟测试

./mqadmin clusterRT -n namesrv_ip:9876 -c cluster_name -a 1000 -s 4096

参数 说明
-a 测试消息总数
-s 消息大小（字节）
三、Broker管理
1. 查询消息
# 按MsgID查询
./mqadmin queryMsgById -n namesrv_ip:9876 -i "0A9A003F00002A9F0000000000002B7A"

# 按Key查询
./mqadmin queryMsgByKey -n namesrv_ip:9876 -t topic_name -k order_123


2. 发送测试消息

./mqadmin sendMessage -n namesrv_ip:9876 -t test_topic -p "Hello World" -k mykey -c mytag

 

四、消费管理
1. 查看消费进度

./mqadmin consumerProgress -n namesrv_ip:9876 -g consumer_group -s

参数 作用
-s 显示客户端IP

2. 重置消费位点

./mqadmin resetOffsetByTime -n namesrv_ip:9876 -g consumer_group -t topic_name -s 1672531200000

参数 说明
-s 时间戳（毫秒）
-f 强制重置（可前移）

五、连接管理
1. 查看生产者连接

./mqadmin producerConnection -n namesrv_ip:9876 -g producer_group -t topic_name

 

2. 查看消费者连接

./mqadmin consumerConnection -n namesrv_ip:9876 -g consumer_group

 

六、NameServer管理
1. 更新KV配置
./mqadmin updateKvConfig -n namesrv_ip:9876 -s namespace -k config_key -v config_value


2. 获取NameServer配置

./mqadmin getNamesrvConfig -n namesrv_ip:9876

 

七、高级功能
1. 消息轨迹追踪
./mqadmin printMsg -n namesrv_ip:9876 -t topic_name -b "2023-01-01 00:00:00" -e "2023-01-02 00:00:00"


2. 消费者状态诊断
./mqadmin consumerStatus -n namesrv_ip:9876 -g consumer_group -s

注意事项
生产环境操作规范：

修改Topic队列数时需确保消费者已停止
删除Topic前需确认无生产消费流量
重置Offset建议在业务低峰期操作
常见问题排查：

# 查看积压消息
./mqadmin topicStatus -n namesrv_ip:9876 -t topic_name

# 检查消息堆积原因
./mqadmin consumerStatus -n namesrv_ip:9876 -g consumer_group

bash
1
2
3
4
5
性能调优参考：

# 统计所有Topic指标
./mqadmin statsAll -n namesrv_ip:9876 -a

# 测试集群写入性能
./mqadmin checkMsgSendRT -n namesrv_ip:9876 -t test_topic -a 10000 -s 1024


八、最佳实践
1. 安全删除Topic流程
Admin
Broker
NameServer
停止生产消费
执行deleteTopic
移除路由信息
物理删除存储文件
Admin
Broker
NameServer
2. 消费积压处理方案
情况 处理方式 命令参考
消费者宕机 重启消费者 consumerStatus检查
消息处理慢 扩容消费者 updateTopic增加队列
数据格式错误 跳过消息 resetOffsetByTime重置位点
通过合理使用这些管理命令，可以完成RocketMQ集群的全生命周期管理。建议结合监控系统（如Prometheus+RocketMQ Exporter）实现自动化运维。
————————————————

版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

原文链接：https://blog.csdn.net/weixin_47763579/article/details/146148856