查看RocketMQ消息

本章节指导您通过查询消息功能查看具体的消息内容，以及确定消息是否生产/消费成功。

分布式消息服务RocketMQ版提供三种消息查询的方法：按Topic查询、按Message ID查询和按Message Key查询。

按Topic查询：查询某时间段内指定Topic下所有的消息。此方法属于范围查询，查询到的消息可能比较多。
按Message ID查询：查询指定Topic下指定Message ID的消息。此方法属于精确查找，可以快速查询到某一条消息。
按Message Key查询：查询指定Topic下指定Message Key的消息。此方法属于精确查找，可以快速查询到某一条消息。

消息清理机制

无论消息是否被消费，RocketMQ的消息默认保留时间为48小时，最长保留时间为720小时，修改保留时间的操作请参见修改RocketMQ消息保留时间。RocketMQ消息存储在CommitLog文件中，CommitLog文件大小为1GB，当一个CommitLog文件写满后，会生成一个新的CommitLog文件。RocketMQ删除消息是删除CommitLog文件，而不是删除一条消息。CommitLog文件为顺序写入，当最后写入的一条消息过期时，表示CommitLog文件过期。满足如下任意一个条件，CommitLog文件将会被清理：

每天凌晨4点会清理过期的文件，部分老实例由于未设置时区，清理时间为每天中午12点。
当磁盘使用率达到70%（针对4.8.0版本）或75%（针对5.x版本）时，会立刻清理过期的文件。
当磁盘使用率达到85%时，会从最早创建的文件开始清理，不管文件是否已过期，直到磁盘空间充足。

前提条件

已创建RocketMQ实例和Topic。
如果通过按Message ID查询，需要提前获取消息所在的Topic名称和消息的Message ID。
Message ID为生产消息后返回的MsgId，如6中返回的内容，也可先通过Topic查询消息，记录Message ID。
如果通过按Message Key查询，需要提前获取消息所在的Topic名称和消息的Message Key。
Message Key为7中配置的消息Key，也可先通过Topic查询消息，记录Message Key。

查询消息内容

登录管理控制台。
在管理控制台左上角单击，选择区域。

请选择RocketMQ实例所在的区域。
在管理控制台左上角单击，选择“应用中间件 > 分布式消息服务RocketMQ版”，进入分布式消息服务RocketMQ专享版页面。
单击RocketMQ实例的名称，进入实例详情页面。
在左侧导航栏，单击“消息查询”，进入“消息查询”页面。
选择以下任意一种方法，查询消息。
- 按Topic查询：“Topic”选择待查询消息的Topic名称，“队列”选择待查询消息的队列（仅RocketMQ实例4.8.0版本需要选择），“存储时间”选择待查询消息的时间段，单击“查询”。
- 按Message ID查询：“Topic”选择待查询消息所在的Topic名称，“Message ID”输入待查询消息的Message ID，单击“查询”。
- 按Message Key查询：“Topic”选择待查询消息所在的Topic名称，“Message Key”输入待查询消息的Message Key，单击“查询”。
在待查询消息所在行，单击“查看详情”，查看消息的具体内容。
消息的具体内容包括消息大小、消息的生成时间以及消息的内容。
图1 查看消息详情
- 消息体大于4096字节时，在控制台无法显示所有的内容，单击“下载消息”，在下载的JSON文件中查看消息体。
- 单击“复制消息”可以复制消息的内容。