RocketMQ 学习之三 —— mqadmin

最新推荐文章于 2025-06-11 11:42:51 发布
最新推荐文章于 2025-06-11 11:42:51 发布
阅读量290 收藏
点赞数
CC 4.0 BY-SA版权
分类专栏： RocketMQ RocketMQ
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/ruanhao1203/article/details/89493863
本文详细介绍RocketMQ提供的控制台及一系列控制台命令，涵盖主题、集群、Broker管理，包括创建、删除Topic，更新订阅组，查询消息等多种操作，帮助管理员有效管理RocketMQ系统。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

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;...

RocketMQ 消息投递解析—— 时序图、调用链、源码级解析
如切如磋，如琢如磨
05-24 2112
在前几篇文章里我曾经也画过消息投递的模型图，这里再来简单复习一下：消息生产者集群从注册中心获取到路由信息（负载均衡），然后将消息发送给Broker集群；注册中心是无状态集群，即每一台服务器都不影响其他的服务器。
RocketMQ（01）——简介
Elim的博客
12-07 1717
RocketMQ简介 笔者使用的是Apache RocketMQ，官网是http://rocketmq.apache.org/。RocketMQ是Alibaba开源的一个分布式消息队列，可以通过http://rocketmq.apache.org/dowloading/releases/下载当前最新的版本。下载后解压缩，然后通过bin/mqnamesrv启动一个Name Server，它默认监听在...
rocketMQ常用命令
11-20
启动 namesrv nohup sh mqnamesrv & 启动broker nohup sh mqbroker -c ../conf/eda_master1.properties &
RocketMQ命令整理
樵夫后院
07-14 1690
原创文章，转载请注明出处：http://jameswxx.iteye.com/blog/2091971   1.1. 控制台使用 RocketMQ 提供有控制台及一系列控制台命令，用于管理员对主题，集群，broker 等信息的管理； 登录控制台 首先进入RocketMQ 工程，进入/RocketMQ/bin 在该目录下有个mqadmin 脚本 查看帮助 在mqadmin 下...
RocketMQ | mqadmin命令增删改查topic
最新发布
Andya_net的博客
06-11 1053
本文介绍了RocketMQ常用的mqadmin命令操作，包括创建/删除Topic、查询Topic信息、消费进度、队列信息、订阅关系等。详细列出了12种常用命令的语法格式及参数说明，其中updateTopic用于创建Topic，deleteTopic用于删除Topic，topicRoute等命令用于查询Topic各类信息。每个命令都需指定NameServer地址，部分命令还需集群名称、Topic名称等参数。这些命令涵盖了Topic管理的核心功能，如消息查询（按ID/key）、消费组/生产者信息查看等，为Roc
RocketMQ常用命令
youyou263的博客
12-02 678
master-slave模式下获取当前master信息。如果在容器内部中，可能需要先执行下面命令。tool.sh工具测试收发消息。
RocketMQ管理命令说明
热门推荐
任何技能都是从模仿开始，逐步升华。
11-09 4万+
1.1.  控制台使用 RocketMQ提供有控制台及一系列控制台命令，用于管理员对主题，集群，broker等信息的管理； l  登录控制台： 首先进入RocketMQ工程，进入/RocketMQ/bin 在该目录下有个mqadmin脚本 l  查看帮助： 在mqadmin下可以查看有哪些命令               shmqadmin l  查看具体命令的使用 sh mqa
RocketMQ实战系列-RocketMQ命令详解
初学者
06-03 2282
导语   之前分析了关于RocketMQ源码的东西，接下来的阶段就是进入到实战的相关系列操作中，在这个系列中也会继续从源码的角度入手，深入的分析，在RocketMQ中的编程思想。下面就来介绍一下在RocketMQ中使用到的相关命令。 文章目录RocketMQ命令详解BrokerclusterList：查看集群updateBrokerConfig：更新Broker 配置文件brokerStatus：查看broker状态TopicupdateTopic：创建TopicdeleteTopic：删除Topict.
RocketMQ学习笔记三（黑马）大神级
2301_81298401的博客
03-13 936
（时长：19.5h）讲解版本：4.5版本（我是以4.8版本实践的）
RocketMQ源码解析——Producer部分之生产者客户端MQClientInstance启动(2)
szhlcy的博客
11-20 1218
文章目录  前面说了消息生产者的启动主要流程，从启动脚本到DefaultMQProducer再到DefaultMQProducerImpl然后到MQClientInstance。都是一步一步委托的。这里之所以把MQClientInstance单独拿出来说，是因为MQClientInstance这个类不仅仅在生产者用到，他还是消费者，RocketMQ的Admin控制台的共用客户端实体类。 ...
RocketMQ基础命令
csdn_l_z的博客
06-09 362
本文简要介绍了RocketMQ的基本操作流程，包括启动NameServer和Broker、查看集群状态、生产/消费消息以及关闭服务的命令步骤。同时提供了处理端口占用问题的方法（通过lsof和kill命令），并介绍了RocketMQ可视化面板的安装与配置过程（修改端口为7000后通过mvn打包运行）。最后展示了如何通过浏览器访问localhost:7000查看可视化监控界面。全文以命令行操作为主，涵盖RocketMQ核心组件的全生命周期管理。
RocketMQ命令介绍及RocketMQ的可视化工具部署
小威的博客
07-29 1万+
上篇文章我们介绍了RocketMQ集群的搭建，但是我们只能通过命令来查看集群情况。所以，这篇文章我们主要介绍RocketMQ的可视化平台。RocketMQ的可视化工具主要用于监控和管理RocketMQ集群，帮助我们更加直观地了解RocketMQ的运行状态和性能指标。
RocketMq命令
只有不断地学习，不断地进步，才能感受到生活的快乐，意义。。。。
08-12 1万+
启动rocketMq命令：  sh mqnamesrv & sh mqbroker -c ../conf/2m-noslave/broker-a.properties & 1. 登录控制台： 首先进入 RocketMQ 工程，进入/RocketMQ/bin   在该目录下有个 mqadmin 脚本 .  查看帮助：   在 mqadmin 下可以查看有哪些命令    a: 查看具
RocketMQ：常用命令汇总（mqadmin、mqnamesrv、mqbroker）
健身变秃，coding变强
10-26 5447
## 查看RocketMQ相关日志 {user}/logs/rocketmqlogs/. cd ~/logs/rocketmqlogs/ # 查看nameServer的日志 tailf namesrv.log # 启动NameServer nohup sh bin/mqnamesrv -n localhost:9876 & # 启动Broker nohup sh bin/mqbroker -n localhost:9876 -c conf/broker.conf & # 进入Roc
rocketMq常用命令
迁柏进阶之路
07-25 264
【代码】rocketMq常用命令。
rocketmq常用命令
wwwwwww31311的博客
07-13 3654
启动rocketmq [root@bogon /]# cd /usr/local/java/rocketmq/bin [root@bogon bin]# nohup sh mqnamesrv & #启动namesrv [root@bogon bin]# tail -f ~/logs/rocketmqlogs/namesrv.log #查看日志 [root@bogon bin]# nohup sh broker - n 公网ip -c conf/broker.conf autoCreateTopic
RocketMQ中常用的命令
学亮编程手记
03-12 2783
该命令将启动RocketMQ的Broker，并将其连接到名为localhost的NameServer。该命令将显示与名为localhost的NameServer连接的Broker的信息，包括运行状态，版本和配置信息等。该命令将创建一个名为example-group的消费者组，并将其订阅到名为example-topic的主题。该命令将启动一个快速入门示例生产者，并将消息发送到名为example-topic的主题中。该命令将启动一个快速入门示例消费者，并从名为example-topic的主题中消费消息。
【RocketMQ】 官方运维管理命令mqadmin使用手册（讲解+实操）
浩瀚宇宙的一粒尘埃
12-29 4万+
内容有点多，左侧有菜单。
Rocketmq 常用命令
Jc0803kevin的专栏
09-10 308
Rocketmq 常用命令 创建主题 D:\softInstall\rocketmq-all-4.2.0-bin-release\bin>mqadmin.cmd updateTopic -n 127.0.0.1:9876 -b 127.0.0.1:10911 -t TopicTestkevin Java HotSpot(TM) 64-Bit Server VM warning: ignori...
rocketmq MQAdminExt
03-30
### RocketMQ 中 MQAdminExt 的功能及使用方法 #### 1. **MQAdminExt 基本概念** `MQAdminExt` 是 Apache RocketMQ 提供的一个管理工具类，主要用于管理和监控 RocketMQ 集群的状态。它提供了丰富的接口来操作 Broker、Topic 和消息队列等功能[^3]。 通过 `MQAdminExt`，可以实现以下核心功能： - 创建和删除 Topic。 - 查询集群状态、Broker 信息以及消费者组订阅关系。 - 调整权限设置（如禁用写入）。 - 查看消息轨迹并追踪消息发送与消费情况。 --- #### 2. **主要功能详解** ##### (1) **创建和删除 Topic** 可以通过 `createTopicInCluster` 方法动态创建一个新的 Topic，并指定分区数量和其他参数。以下是代码示例： ```java // 初始化 Admin 实例 DefaultMQAdminExt admin = new DefaultMQAdminExt(); admin.setNamesrvAddr("localhost:9876"); admin.start(); // 定义 Topic 属性 String topicName = "TestTopic"; int queueNums = 4; int topicSysFlag = 0; // 默认标志位 long perm = Permission.READ | Permission.WRITE; // 权限控制 String topicFilterType = "SINGLE_TAG"; // 过滤类型 // 执行创建 Topic 操作 admin.createTopic(topicName, queueNums, topicSysFlag, perm, topicFilterType); // 关闭连接 admin.shutdown(); ``` 此部分逻辑允许管理员灵活调整系统的主题结构。 --- ##### (2) **查询 Cluster/Broker/Consumer 状态** `MQAdminExt` 支持多种查询功能，用于获取当前 RocketMQ 集群的整体运行状况。例如，查看所有 Broker 列表或者某个特定 Consumer 组的订阅详情。 下面是一个简单的例子展示如何打印整个集群中的 Brokers： ```java Set<String> brokerAddrs = admin.fetchAllBrokerAddr(); for (String addr : brokerAddrs) { System.out.println("Broker Address: " + addr); } ``` 对于消费者的订阅列表，则可通过如下方式完成检索： ```java List<SubscriptionData> subscriptions = admin.examineSubGroupOffset("test-group", null); subscriptions.forEach(sub -> System.out.println(sub.getTopic() + ": " + sub.getExpression())); ``` 这些 API 对于日常运维非常有用，能够帮助快速定位潜在问题所在。 --- ##### (3) **修改 Broker 写权限** 当需要临时停止某些 Broker 接收新数据时，可利用 `wipeWritePermOfBroker` 函数执行该动作。注意这会直接影响到生产者能否成功投递至目标 Queue 上[^2]。 实际应用中可能涉及两种场景——基于命令行脚本触发或是程序内部调用上述提到的方法实现自动化处理流程。 --- #### 3. **注意事项** 尽管 `MQAdminExt` 功能强大，但在实际部署过程中仍需遵循一些最佳实践原则以保障稳定性： - 确保 NameServer 地址配置无误以便正常通信； - 小心对待敏感操作比如更改访问级别以免造成不可逆后果； - 如果是在分布式环境下运作的话记得考虑网络延迟因素影响性能表现[^4]。 --- ### 示例总结代码片段 这里提供一段综合性的 Java 测试案例作为参考模板： ```java public class MqAdminExample { public static void main(String[] args) throws Exception { DefaultMQAdminExt mqAdmin = new DefaultMQAdminExt(); try { mqAdmin.setNamesrvAddr("localhost:9876"); // 设置 Nameserver 地址 mqAdmin.start(); // 启动客户端 String clusterName = "DefaultCluster"; // 获取集群下的所有 Broker 名称 Set<String> brokers = mqAdmin.viewBrokerStatsInfo(clusterName).keySet(); brokers.forEach(brokerName -> System.out.println("Broker Name:" + brokerName)); // 删除测试 Topic mqAdmin.deleteTopicInCluster(clusterName, "TestTopic"); } finally { mqAdmin.shutdown(); // 结束资源释放 } } } ``` 以上展示了基本的操作模式及其灵活性特点。 ---
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值