RocketMQ运维管理命令mqadmin-Message相关

最新推荐文章于 2025-04-21 16:59:37 发布

原创最新推荐文章于 2025-04-21 16:59:37 发布 · 971 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#运维 #java-rocketmq #rocketmq

本文介绍了RocketMQ管理工具中的关键命令，如发送消息、检查消息状态、查询消息（按key、id、uniquekey、offset和队列）、打印消息详情以及消费消息，这些操作对管理和监控消息队列至关重要。

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

Message相关

sendMessage

作用：发送消息

命令：mqadmin sendMessage [-b ] [-c ] [-h] [-i ] [-k ] [-n ] -p -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-b,–broker	设置发送消息的目标broker
-c,–tags	Message tags
-i,–qid	设置目标queue
-k,–key	消息key
-p,–body	消息体	UTF-8编码，字符串
-t,–topic	topic名称

示例：

1
2
3
4
5
6
7

注意：

这里返回的MsgId，实际上是UniqueKey，通过queryById是查不出来的，但是通过queryMsgByUniqueKey能查到；
Tag的使用：一个应用尽可能用一个Topic，而消息子类型则可以用tags来标识。tags可以由应用自由设置，只有生产者在发送消息设置了tags，消费方在订阅消息时才可以利用tags通过broker做消息过滤：message.setTags(“TagA”)。

sendMsgStatus

作用：发送消息到broker

命令：mqadmin sendMsgStatus -b [-c ] [-h] [-n ] [-s ]

注意：并不是真正发送消息，只是检测消息的发送状态（sendStatus、rt）

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-b,–brokerName	broker名称
-c,–count	发送消息数量	默认：50
-s,–messageSize	消息大小	默认：128

示例：

1
2
3
4
5
6

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
rt:1ms, SendResult=SendResult [sendStatus=SEND_OK, msgId=AC110001F3237EA987AC6F72C5140001, offsetMsgId=AC181EC000002A9F000000014136B4B6, messageQueue=MessageQueue [topic=broker-a, brokerName=broker-a, queueId=0], queueOffset=58]rt:1ms, SendResult=SendResult [sendStatus=SEND_OK, msgId=AC110001F3237EA987AC6F72C5160002, offsetMsgId=AC181EC000002A9F000000014136B597, messageQueue=MessageQueue [topic=broker-a, brokerName=broker-a, queueId=0], queueOffset=59]rt:5ms, SendResult=SendResult [sendStatus=SEND_OK, msgId=AC110001F3237EA987AC6F72C5170003, offsetMsgId=AC181EC000002A9F000000014136B678, messageQueue=MessageQueue [topic=broker-a, brokerName=broker-a, queueId=0], queueOffset=60]
[root@localhost-001 bin]
[root@localhost-001 bin]

queryMsgByKey

作用：根据key查询消息

命令：mqadmin queryMsgByKey [-h] -k [-n ] -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-t,–topic	topic名称
-k,–msgKey	消息key

示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.

AC110001E0BD7EA987AC6F5319D10000                      5                                        0
AC110001E1347EA987AC6F5353DD0000                      7                                        0
AC110001E1727EA987AC6F537C7E0000                      7                                        1
AC110001E2697EA987AC6F55DD160000                      2                                        0
AC110001E5CC7EA987AC6F5AD1B30000                      1                                        0
AC110001DE177EA987AC6F4F1BE30000                      0                                        0
AC110001DE4D7EA987AC6F4F5A730000                      0                                        1
AC110001DE817EA987AC6F4FA88E0000                      3                                        0
AC110001DF467EA987AC6F509C6C0000                      3                                        1
[root@localhost-001 bin]

queryMsgById

作用：根据消息id查询消息

命令： [-d ] [-g ] [-h] -i [-n ] [-s ] [-u ]

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-d,–clientId	消费者客户端id
-g,–consumerGroup	订阅组名称
-i,–msgId	消息id
-s,–sendMessage	resend message
-u,–unitName	unit name

示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
OffsetID:            AC181EC100002A9F000000018A727660
Topic:               zhurunhua
Tags:                [测试message]
Keys:                [test-key]
Queue ID:            2
Queue Offset:        0
CommitLog Offset:    6617724512
Reconsume Times:     0
Born Timestamp:      2023-03-01 15:08:31,339
Store Timestamp:     2023-03-01 15:08:31,345
Born Host:           172.24.30.192:25687
Store Host:          172.24.30.193:10911
System Flag:         0
Properties:          {KEYS=test-key, UNIQ_KEY=AC110001EBBC7EA987AC6F6552EB0000, CLUSTER=xdf-test1, WAIT=true, TAGS=测试message}
Message Body Path:   /tmp/rocketmq/msgbodys/AC110001EBBC7EA987AC6F6552EB0000`

queryMsgByUniqueKey

作用：根据唯一key查询消息

命令：mqadmin queryMsgByUniqueKey [-d ] [-g ] [-h] -i [-n ] -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-d,–clientId	消费者客户端id
-g,–consumerGroup	订阅组名称
-i,–msgId	消息id
-t,–topic	topic名称

示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
Topic:               zhurunhua
Tags:                [测试message]
Keys:                [test-key1]
Queue ID:            1
Queue Offset:        0
CommitLog Offset:    5865661490
Reconsume Times:     0
Born Timestamp:      2023-03-01 14:57:02,899
Store Timestamp:     2023-03-01 14:57:02,904
Born Host:           172.24.30.192:56596
Store Host:          172.24.30.194:10911
System Flag:         0
Properties:          {KEYS=test-key1, UNIQ_KEY=AC110001E5CC7EA987AC6F5AD1B30000, CLUSTER=xdf-test1, WAIT=true, TAGS=测试message}
Message Body Path:   /tmp/rocketmq/msgbodys/AC110001E5CC7EA987AC6F5AD1B30000
[root@localhost-001 bin]`

queryMsgByOffset

作用：根据offset查询消息

命令：mqadmin queryMsgByOffset -b [-h] -i [-n ] -o -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-t,–topic	topic名称
-b,–brokerName	broker名称	这里需要注意填写的是broker 的名称，不是broker 的地址，broker名称可以在clusterList 查到
-i,–queueId	队列id	默认是8个，queue id从0到7
-o,–offset	offset 值

示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
OffsetID:            AC181EC100002A9F000000018A6399BE
Topic:               zhurunhua
Tags:                [null]
Keys:                [test-key]
Queue ID:            6
Queue Offset:        0
CommitLog Offset:    6616750526
Reconsume Times:     0
Born Timestamp:      2023-03-01 14:42:15,770
Store Timestamp:     2023-03-01 14:42:15,775
Born Host:           172.24.30.192:26838
Store Host:          172.24.30.193:10911
System Flag:         0
Properties:          {MIN_OFFSET=0, MAX_OFFSET=1, KEYS=test-key, UNIQ_KEY=AC110001DD437EA987AC6F4D48590000, CLUSTER=xdf-test1, WAIT=true}
Message Body Path:   /tmp/rocketmq/msgbodys/AC110001DD437EA987AC6F4D48590000`

printMsg

作用：打印消息详情

命令：mqadmin printMsg [-b ] [-c ] [-d ] [-e ] [-h] [-n ] [-s ] -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-t,–topic	topic名称
-b,–beginTimestamp	开始时间戳	时间戳或 yyyy-MM-dd#HH:mm:ss:SSS格式的时间
-c,–charsetName	字符编码名称	例如：UTF-8,GBK
-d,–printBody	是否打印消息体	true 、false
-e,–endTimestamp	结束时间戳
-s,–subExpression	Subscribe Expression

示例：

1
2
3
4
5
6

[root@localhost-001 bin]
RocketMQLog:WARN No appenders could be found for logger (io.netty.util.internal.PlatformDependent0).
RocketMQLog:WARN Please initialize the logger system properly.
minOffset=0, maxOffset=0, MessageQueue [topic=zhurunhua, brokerName=broker-c, queueId=7]minOffset=0, maxOffset=0, MessageQueue [topic=zhurunhua, brokerName=broker-b, queueId=6]minOffset=0, maxOffset=0, MessageQueue [topic=zhurunhua, brokerName=broker-a, queueId=5]minOffset=0, maxOffset=0, MessageQueue [topic=zhurunhua, brokerName=broker-b, queueId=7]minOffset=0, maxOffset=0, MessageQueue [topic=zhurunhua, brokerName=broker-a, queueId=6]minOffset=0, maxOffset=0, MessageQueue [topic=zhurunhua, brokerName=broker-a, queueId=7]minOffset=0, maxOffset=0, MessageQueue [topic=zhurunhua, brokerName=broker-c, queueId=0]minOffset=0, maxOffset=0, MessageQueue [topic=zhurunhua, brokerName=broker-c, queueId=1]minOffset=0, maxOffset=1, MessageQueue [topic=zhurunhua, brokerName=broker-b, queueId=0]MSGID: AC110001DE177EA987AC6F4F1BE30000 MessageExt [brokerName=broker-b, queueId=0, storeSize=195, queueOffset=0, sysFlag=0, bornTimestamp=1600757055459, bornHost=/172.24.30.192:34188, storeTimestamp=1600757055464, storeHost=/172.24.30.193:10911, msgId=AC181EC100002A9F000000018A64C05D, commitLogOffset=6616825949, bodyCRC=1801232349, reconsumeTimes=0, preparedTransactionOffset=0, toString()=Message{topic='zhurunhua', flag=0, properties={MIN_OFFSET=0, MAX_OFFSET=2, KEYS=test-key1, UNIQ_KEY=AC110001DE177EA987AC6F4F1BE30000, CLUSTER=xdf-test1, WAIT=true}, body=[116, 101, 115, 116, 45, 98, 111, 100, 121, 49], transactionId='null'}] BODY: test-body1
MSGID: AC110001DE4D7EA987AC6F4F5A730000 MessageExt [brokerName=broker-b, queueId=0, storeSize=195, queueOffset=1, sysFlag=0, bornTimestamp=1600757071475, bornHost=/172.24.30.192:39631, storeTimestamp=1600757071480, storeHost=/172.24.30.193:10911, msgId=AC181EC100002A9F000000018A6543C4, commitLogOffset=6616859588, bodyCRC=1801232349, reconsumeTimes=0, preparedTransactionOffset=0, toString()=Message{topic='zhurunhua', flag=0, properties={MIN_OFFSET=0, MAX_OFFSET=2, KEYS=test-key1, UNIQ_KEY=AC110001DE4D7EA987AC6F4F5A730000, CLUSTER=xdf-test1, WAIT=true}, body=[116, 101, 115, 116, 45, 98, 111, 100, 121, 49], transactionId='null'}]
[root@localhost-001 bin]

printMsgByQueue

作用：通过queue id查询消息详情

命令： -a [-b ] [-c ] [-d ] [-e ] [-f ] [-h] -i [-n ] [-p ] [-s ] -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-a,–brokerName	broker名称
-b,–beginTimestamp	开始时间戳	时间戳或 yyyy-MM-dd#HH:mm:ss:SSS
-e,–endTimestamp	结束时间戳
-c,–charsetName	字符编码名称	例如：UTF-8,GBK
-d,–printBody	print body
-f,–calculate	calculate by tag	true｜false(default)
-i,–queueId	队列id
-p,–print msg	是否打印消息	true｜false(default)
-s,–subExpression	Subscribe Expression
-t,–topic	topic名称

示例：

1	./mqadmin printMsgByQueue -n 172.24.30.192:9876 -a broker-b -t zhurunhua -i 0 -c UTF-8

consumeMessage

作用：消费消息

命令：mqadmin consumeMessage [-b ] [-c ] [-e ] [-g ] [-h] [-i ] [-n ] [-o ] [-s ] -t

参数	含义	备注
-h,–help	打印help信息
-n,–namesrvAddr	nameserver服务地址列表
-b,–brokerName	broker名称
-c,–MessageNumber	消费消息数量
-s,–beginTimestamp	开始时间	currentTimeMillis或yyyy-MM-dd#HH:mm:ss:SSS格式表示的时间
-e,–endTimestamp	结束时间
-g,–consumerGroup	消费者组名称
-i,–queueId	queue id
-o,–offset	queue offset
-t,–topic	topic名称

示例：

1	./mqadmin consumeMessage -n 172.24.30.192:9876 -t zhurunhua -b broker-a -c 3 -g zhurunhua