一、约束与限制
·保留消息(Retain Message)查询仅展示每个 Topic 下的最近一条保留消息,历史保留消息请前往 查询普通消息 检索。
·消息默认保留时长为3天,超过保留时长的消息将被自动清理。
二、查看保留消息
1. 登录 MQTT 控制台。
三、查看保留消息详情
在目标消息行的操作列单击查看详情,右侧抽屉显示该条保留消息的完整信息:
| 字段 | 说明 |
| Topic | 保留消息所属 Topic |
| QoS | 消息服务质量等级 |
| 消息 ID | Broker 为该条消息生成的全局唯一 ID |
| 发送客户端 | 发布该保留消息的客户端 Client ID |
| 客户端地址 | 发布客户端的 IP 与端口 |
| 创建时间 | 该消息的发布时间 |
| 更新时间 | 该消息最近一次被新保留消息覆盖/更新的时间 |
| 过期时间/时长 | 保留消息的过期策略。当前默认为 永不过期,到期后 Broker 将自动清除该保留消息 |
| 用户属性 | 展示 MQTT 5.0 消息中携带的 User Properties,键值对形式。 |
| 消息体 | 默认显示消息的原始 Payload打开右上角的 Base64 解码 开关可对 Payload 进行解码。通过格式下拉框选择 Plain Text 或 JSON 进行展示。 |
四、查看保留消息轨迹
在目标消息行的操作列单击查看消息轨迹,跳转到保留消息的轨迹详情页,展示此条消息的完整生产与消费记录。