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

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

[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. broker-b                          6     SEND_OK                 AC110001DD437EA987AC6F4D48590000 [root@localhost-001 bin]

注意：

• 这里 返回的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