You need to enable JavaScript to run this app.
导航
保留消息
最近更新时间:2024.07.18 16:53:22首次发布时间:2024.07.18 16:53:22
我的收藏
有用
有用
无用
无用

当用户发布了一条保留消息时,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 中删除保留消息。在保留消息列表页面中单击删除按钮来删除一条保留消息。

说明

除了直接删除保留消息以外,您还可以在保留消息的设置页面配置保留消息的消息过期间隔。当保留消息过期后,MQTT 会自动删除这条保留消息。
如需修改保留消息的配置,请参见保留消息