在bin目录下的mqadmin命令，可以进行创建、修改topic，更新broker的配置信息，查询特定消息等各种操作。
1. 创建Topic
指令 :updateTopic
用法：sh mqadmin updateTopic -n 192.168.1.100:9876
|
参数 |
是否必填 |
说明 |
|
-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_-]+$ ） |
2. 删除Topic
指令 :deleteTopic
|
参数 |
是否必填 |
说明 |
|
-c |
是 |
cluster 名称，表示删除某集群下的某个topic （集群可通过clusterList 查询） |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:port;… |
|
-t |
是 |
topic 名称（名称只能使用字符 ^[a-zA-Z0-9_-]+$ ） |
3. 创建（修订）订阅组
指令 :updateSubGroup
|
参数 |
是否必填 |
说明 |
|
-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;... |
4. 删除订阅组配置
指令: deleteSubGroup
|
参数 |
是否必填 |
说明 |
|
-b |
如果–c 为空，则必填 |
broker 地址，表示订阅组建在该broker |
|
-c |
如果–b 为空，则必填 |
cluster 名称，表示topic建在该集群（集群可通过clusterList查询） |
|
-g |
是 |
订阅组名 |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:port;... |
5. 更新Broker 配置文件
指令 :updateBrokerConfig
|
参数 |
是否必填 |
说明 |
|
-b |
如果–c为空，则必填 |
broker 地址，表示订阅组建在该broker |
|
-c |
如果–b 为空，则必填 |
cluster名称，表示topic 建在该集群（集群可通过clusterList查询） |
|
-k |
是 |
key 值 |
|
-v |
否 |
value 值 |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:port;... |
6. 查看Topic 列表信息
指令 :topicList
|
参数 |
是否必填 |
说明 |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:port;... |
7. 查看Topic 路由信息
指令 :topicRoute
|
参数 |
是否必填 |
说明 |
|
-t |
是 |
topic 名称 |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:port;... |
8. 查看Topic 统计信息
指令 :topicStats
|
参数 |
是否必填 |
说明 |
|
-t |
是 |
topic 名称 |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:port;... |
9. 查看Broker 统计信息
指令 :brokerStats
|
参数 |
是否必填 |
说明 |
|
-b |
是 |
broker 地址 |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:port;... |
10. 根据消息ID 查询消息
指令 :queryMsgById
|
参数 |
是否必填 |
说明 |
|
-i |
是 |
消息id |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:port;... |
11. 根据消息Key 查询消息
指令 :queryMsgByKey
|
参数 |
是否必填 |
说明 |
|
-f |
否 |
被查询消息的截止时间 |
|
-k |
是 |
msgKey |
|
-t |
是 |
topic 名称 |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:port;... |
12. 根据Offset 查询消息
指令 :queryMsgByOffset
|
参数 |
是否必填 |
说明 |
|
-b |
是 |
Broker 名称，表示订阅组建在该broker（这里需要注意填写的是broker 的名称，不是broker 的地址，broker名称可以在clusterList 查到 |
|
-i |
是 |
query 队列id |
|
-o |
是 |
offset 值 |
|
-t |
是 |
topic 名称 |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:port;... |
13. 查询Producer 的网络连接
该命令只打印当前与cluster 连接的producer 网络连接信息
指令 :producerConnection
|
参数 |
是否必填 |
说明 |
|
-g |
是 |
生产者所属组名 |
|
-t |
是 |
topic 名称 |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:port;... |
14. 查询Consumer 的网络连接
该命令只打印当前与cluster 连接的consumer 网络连接信息
指令 :consumerConnection
|
参数 |
是否必填 |
说明 |
|
-g |
是 |
消费者所属组名 |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:port;... |
15. 查看订阅组消费状态
指令 :consumerProgress
|
参数 |
是否必填 |
说明 |
|
-g |
是 |
消费者所属组名 |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:port;... |
16. 查看集群消息
指令 :clusterList
|
参数 |
是否必填 |
说明 |
|
-m |
否 |
打印更多信息 |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:port;... |
17. 添加（更新）KV 配置信息
指令 :updateKvConfig
|
参数 |
是否必填 |
说明 |
|
-k |
是 |
key 值 |
|
-v |
是 |
value 值 |
|
-s |
是 |
Namespace 值 |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:port;... |
18. 删除KV 配置信息
指令 :deleteKvConfig
|
参数 |
是否必填 |
说明 |
|
-k |
是 |
key 值 |
|
-s |
是 |
Namespace 值 |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:port;... |
19. 添加（更新）Project group 配置信息
指令 :updateProjectGroup
|
参数 |
是否必填 |
说明 |
|
-p |
是 |
project group 名 |
|
-i |
否 |
服务器ip |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:port;... |
20. 删除Project group 配置信息
指令 :deleteProjectGroup
|
参数 |
是否必填 |
说明 |
|
-p |
是 |
project group 名 |
|
-i |
否 |
服务器ip |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:port;... |
21. 取得Project group 配置信息
指令 :getProjectGroup
|
参数 |
是否必填 |
说明 |
|
-p |
是 |
project group 名 |
|
-i |
否 |
服务器ip |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:port;... |
22. 设置消费进度
根据时间来设置消费进度，设置之前要关闭这个订阅组的所有consumer，设置完再启动，方可生效
指令 :resetOffsetByTime
|
参数 |
是否必填 |
说明 |
|
-f |
否 |
通过时间戳强制回滚（true|false），默认为true |
|
-s |
是 |
时间戳 |
|
-g |
是 |
消费者所属组名 |
|
-t |
是 |
topic 名称 |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:port;... |
23. 清除特定Broker权限
指令 :wipeWritePerm
|
参数 |
是否必填 |
说明 |
|
-b |
是 |
broker 地址 |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:port;... |
24. 获取Consumer消费进度
该命令只打印当前与cluster 连接的consumer 的消费进度
指令 :getConsumerStatus
|
参数 |
是否必填 |
说明 |
|
-g |
是 |
消费者所属组名 |
|
-t |
是 |
查询主题 |
|
-i |
否 |
Consumer 客户端ip |
|
-h |
否 |
打印帮助 |
|
-n |
是 |
nameserve 服务地址列表，格式ip:port;ip:portt;... |