RocketMQ常用命令

转自：http://jameswxx.iteye.com/blog/2091971

1.1. 控制台使用

RocketMQ 提供有控制台及一系列控制台命令，用于管理员对主题，集群，broker 等信息的管理；

登录控制台

首先进入RocketMQ 工程，进入/RocketMQ/bin

在该目录下有个mqadmin 脚本

查看帮助

在mqadmin 下可以查看有哪些命令

sh mqadmin

查看具体命令的使用

sh mqadmin help 命令名称

例如，查看updateTopic 的使用

sh mqadmin help updateTopic

1.2. 详细命令

1.2.1. 创建Topic

指令

updateTopic

类路径

com.alibaba.rocketmq.tools.command.topic.UpdateTopicSubCommand

参数	是否必填	说明
-b	如果-c为空，则必填	broker 地址，表示topic 建在该broker
-c	如果-b为空，则必填	cluster 名称，表示topic 建在该集群（集群可通过clusterList 查询）
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...
-p	否	指定新topic 的权限限制( W|R|WR )
-r	否	可读队列数（默认为8）
-w	否	可写队列数（默认为8）
-t	是	opic 名称（名称只能使用字符 ^[a-zA-Z0-9_-]+$ ）

1.2.2. 删除Topic

指令

deleteTopic

类路径

com.alibaba.rocketmq.tools.command.topic.DeleteTopicSubCommand

参数	是否必填	说明
-c	是	cluster 名称，表示删除某集群下的某个topic （集群可通过clusterList 查询）
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;…
-t	是	topic 名称（名称只能使用字符 ^[a-zA-Z0-9_-]+$ ）

1.2.3. 创建（修订）订阅组

指令

updateSubGroup

类路径

com.alibaba.rocketmq.tools.command.consumer.UpdateSubGroupSubCommand

参数	是否必填	说明
-b	如果 –c 为空，则必填	broker 地址，表示订阅组建在该broker
-c	如果 –b 为空，则必填	cluster名称，表示topic 建在该集群（集群可通过clusterList查询）
-d	否	是否容许广播方式消费
-g	是	订阅组名
-i	否	从哪个broker 开始消费
-m	否	是否容许从队列的最小位置开始消费，默认会设置为false
-q	否	消费失败的消息放到一个重试队列，每个订阅组配置几个重试队列
-r	否	重试消费最大次数，超过则投递到死信队列，不再投递，并报警
-s	否	消费功能是否开启
-w	否	发现消息堆积后，将Consumer 的消费请求重定向到另外一台Slave 机器
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...

1.2.4. 删除订阅组配置

指令

deleteSubGroup

类路径

com.alibaba.rocketmq.tools.command.consumer.DeleteSubscriptionGroupCommand

参数	是否必填	说明
-b	如果–c 为空，则必填	broker 地址，表示订阅组建在该broker
-c	如果–b 为空，则必填	cluster 名称，表示topic建在该集群（集群可通过clusterList查询）
-g	是	订阅组名
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...

1.2.5. 更新Broker 配置文件

指令

updateBrokerConfig

类路径

com.alibaba.rocketmq.tools.command.broker.UpdateBrokerConfigSubCommand

参数	是否必填	说明
-b	如果–c为空，则必填	broker 地址，表示订阅组建在该broker
-c	如果–b 为空，则必填	cluster名称，表示topic 建在该集群（集群可通过clusterList查询）
-k	是	key 值
-v	否	value 值
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...

1.2.6. 查看Topic 列表信息

指令

topicList

类路径

com.alibaba.rocketmq.tools.command.broker.UpdateBrokerConfigSubCommand

参数	是否必填	说明
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...

1.2.7. 查看Topic 路由信息

指令

topicRoute

类路径

com.alibaba.rocketmq.tools.command.topic.TopicRouteSubCommand

参数	是否必填	说明
-t	是	topic 名称
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...

1.2.8. 查看Topic 统计信息

指令

topicStats

类路径

com.alibaba.rocketmq.tools.command.topic.TopicStatsSubCommand

参数	是否必填	说明
-t	是	topic 名称
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...

1.2.9. 查看Broker 统计信息

指令

brokerStats

类路径

com.alibaba.rocketmq.tools.command.broker.BrokerStatsSubCommanD

参数	是否必填	说明
-b	是	broker 地址
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...

1.2.10. 根据消息ID 查询消息

指令

queryMsgById

类路径

com.alibaba.rocketmq.tools.command.message.QueryMsgByIdSubCommand

参数	是否必填	说明
-i	是	消息id
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...

1.2.11. 根据消息Key 查询消息

指令

queryMsgByKey

类路径

com.alibaba.rocketmq.tools.command.message.QueryMsgByKeySubCommand

参数	是否必填	说明
-f	否	被查询消息的截止时间
-k	是	msgKey
-t	是	topic 名称
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...

1.2.12. 根据Offset 查询消息

指令

queryMsgByOffset

类路径

com.alibaba.rocketmq.tools.command.message.QueryMsgByOffsetSubCommand

参数	是否必填	说明
-b	是	Broker 名称，表示订阅组建在该broker（这里需要注意填写的是broker 的名称，不是broker 的地址，broker名称可以在clusterList 查到
-i	是	query 队列id
-o	是	offset 值
-t	是	topic 名称
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...

1.2.13. 查询Producer 的网络连接

该命令只打印当前与cluster 连接的producer 网络连接信息

指令

producerConnection

类路径

com.alibaba.rocketmq.tools.command.connection.ProducerConnectionSubCommand

参数	是否必填	说明
-g	是	生产者所属组名
-t	是	topic 名称
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...

1.2.14. 查询Consumer 的网络连接

该命令只打印当前与cluster 连接的consumer 网络连接信息

指令

consumerConnection

类路径

com.alibaba.rocketmq.tools.command.connection.ConsumerConnectionSubCommand

参数	是否必填	说明
-g	是	消费者所属组名
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...

1.2.15. 查看订阅组消费状态

指令

consumerProgress

类路径

com.alibaba.rocketmq.tools.command.consumer.ConsumerProgressSubCommand

参数	是否必填	说明
-g	是	消费者所属组名
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...

1.2.16. 查看集群消息

指令

clusterList

类路径

com.alibaba.rocketmq.tools.command.cluster.ClusterListSubCommand

参数	是否必填	说明
-m	否	打印更多信息
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...

1.2.17. 添加（更新）KV 配置信息

指令

updateKvConfig

类路径

com.alibaba.rocketmq.tools.command.namesrv.UpdateKvConfigCommand

参数	是否必填	说明
-k	是	key 值
-v	是	value 值
-s	是	Namespace 值
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...

1.2.18. 删除KV 配置信息

指令

deleteKvConfig

类路径

com.alibaba.rocketmq.tools.command.namesrv.DeleteKvConfigCommand

参数	是否必填	说明
-k	是	key 值
-s	是	Namespace 值
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...

1.2.19. 添加（更新）Project group 配置信息

指令 updateProjectGroup

类路径 com.alibaba.rocketmq.tools.command.namesrv.UpdateProjectGroupCommand

参数	是否必填	说明
-p	是	project group 名
-i	否	服务器ip
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...

1.2.20. 删除Project group 配置信息

指令

deleteProjectGroup

类路径

com.alibaba.rocketmq.tools.command.namesrv.DeleteProjectGroupCommand

参数	是否必填	说明
-p	是	project group 名
-i	否	服务器ip
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...

1.2.21. 取得Project group 配置信息

指令

getProjectGroup

类路径

com.alibaba.rocketmq.tools.command.namesrv.GetProjectGroupCommand

参数	是否必填	说明
-p	是	project group 名
-i	否	服务器ip
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...

1.2.22. 设置消费进度

根据时间来设置消费进度，设置之前要关闭这个订阅组的所有consumer，设置完再启动，方可生效

指令

resetOffsetByTime

类路径

com.alibaba.rocketmq.tools.command.offset.ResetOffsetByTimeSubCommand

参数	是否必填	说明
-f	否	通过时间戳强制回滚（true|false），默认为true
-s	是	时间戳
-g	是	消费者所属组名
-t	是	topic 名称
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...

1.2.23. 清除特定Broker权限

指令

wipeWritePerm

类路径

com.alibaba.rocketmq.tools.command.namesrv.WipeWritePermSubCommand

参数	是否必填	说明
-b	是	broker 地址
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...

1.2.24. 获取Consumer消费进度

该命令只打印当前与cluster 连接的consumer 的消费进度

指令

getConsumerStatus

类路径

com.alibaba.rocketmq.tools.command.offset.GetConsumerStatusCommand

参数	是否必填	说明
-g	是	消费者所属组名
-t	是	查询主题
-i	否	Consumer 客户端ip
-h	否	打印帮助
-n	是	nameserve 服务地址列表，格式ip:port;ip:port;...