帮你快速理解、总结文档立即下载

查询保留消息

最近更新时间:2026-08-06 11:10:01
我的收藏

约束与限制

保留消息(Retain Message)查询仅展示每个 Topic 下的最近一条保留消息,历史保留消息请前往 查询普通消息 检索。
消息默认保留时长为3天,超过保留时长的消息将被自动清理。

查看保留消息

1. 登录 MQTT 控制台
2. 在左侧导航栏单击保留消息查询,在下拉框中选择需要查询的保留消息所在的地域与集群。
3. 列表中会展示所有查询到的结果并分页展示,支持通过 Topic 关键字搜索。


查看保留消息详情

在目标消息行的操作列单击查看详情,右侧抽屉显示该条保留消息的完整信息:

字段
说明
Topic
保留消息所属 Topic
QoS
消息服务质量等级
消息 ID
Broker 为该条消息生成的全局唯一 ID
发送客户端
发布该保留消息的客户端 Client ID
客户端地址
发布客户端的 IP 与端口
创建时间
该消息的发布时间
更新时间
该消息最近一次被新保留消息覆盖/更新的时间
过期时间/时长
保留消息的过期策略。当前默认为 永不过期,到期后 Broker 将自动清除该保留消息
用户属性
展示 MQTT 5.0 消息中携带的 User Properties,键值对形式。
消息体
默认显示消息的原始 Payload
打开右上角的 Base64 解码 开关可对 Payload 进行解码。
通过格式下拉框选择 Plain Text 或 JSON 进行展示。

查看保留消息轨迹

在目标消息行的操作列单击查看消息轨迹,跳转到保留消息的轨迹详情页,展示此条消息的完整生产与消费记录。