云原生消息引擎
云原生消息引擎
文档指南
请输入
- 文档首页
云原生消息引擎MQTT 实例用户指南Dashboard指南监控保留消息
复制全文
下载 pdf保留消息
文档反馈
问问助手当用户发布了一条保留消息时，MQTT 会将这条消息保存在系统中，用户可以在保留消息列表页面查看到这条消息。
当用户订阅了这条保留消息的主题时，MQTT 会将这条消息发送给用户。保留消息的有效期默认为永不过期，除非用户手动删除这条消息。
查看保留消息
在监控 > 保留消息页面中，系统以列表形式呈现当前系统中所有的保留消息。
列表中包含了保留消息的主题、质量等级 QoS、客户端 ID 和消息发布时间。
在列表中，您还可以执行以下操作：
- 单击查看 Payload，查看保留消息的 Payload。
- 单击删除，删除一条保留消息。
- 单击列表右上角的刷新按钮，可以刷新当前保留消息列表。
- 单击列表右上角的设置按钮，可以跳转到保留消息的设置页面。您可以设置保留消息启停状态，以及存储类型、最大保留消息数、最大消息负载大小、消息过期间隔、消息清理间隔等详细配置，具体请参见保留消息。
说明
MQTT 默认将保存三类系统主题的保留消息，如果是集群环境，将根据不同的节点名称保存不同系统主题下的保留消息。
- $SYS/brokers/+/sysdescr：节点的描述。
- $SYS/brokers/+/version ：节点的版本号。
- $SYS/brokers：集群所有的节点数量及名称。
查看 Payload
如果您需要查看保留消息的 Payload，可以在保留消息的列表页中单击查看 Payload 按钮来查看保留消息的 Payload。
在 Payload 弹窗中，可以查看保留消息的具体的 Payload 内容。
- 在弹窗的右下角，可以单击复制按钮来快速复制保留消息的 Payload。
- 在左下角的下拉框中还可以对 Payload 进行格式化输出。对于一些特殊的 Payload 格式，如 JSON 或 Hex 格式的，可以更加直观的查看。
删除保留消息
如果您需要删除保留消息，有以下两种方式：
- 通常情况下，您可以在客户端中删除保留消息，方法是向保留消息的主题发布一条空消息。
- 您也可以在 Dashboard 中删除保留消息。在保留消息列表页面中单击删除按钮来删除一条保留消息。
最近更新时间：2025.08.04 17:30:03
这个页面对您有帮助吗？
有用
有用
无用
无用