跳转到主要内容
OASIS Message Queuing Telemetry Transport (MQTT) 端口支持发布 MQTT 消息和订阅 MQTT 主题。

核心功能

  • 双向 IoT 消息队列,支持多个服务质量(QoS)级别
  • 支持 TLS 加密和客户端证书身份验证,并具备可配置的心跳(Keep-alive)间隔
  • 基于主题(Topic)的过滤,支持通配符及遗嘱(Last Will)消息处理

概述

通过 MQTT 端口发送数据会将数据发布到配置的主题,并且在端口订阅的任何主题上接收的消息将放置在交易选项卡中。

端口配置

本节包含所有可配置的端口属性。

设置选项卡

主机配置

与远程MQTT服务器连接相关的设置。

客户端身份验证

与对远程 MQTT 服务器进行身份验证相关的设置。

TLS 设置

与通过 TLS 建立安全连接相关的设置。

发布

与发布MQTT消息相关的设置。

订阅

订阅MQTT消息相关的设置。

高级选项卡

TLS 客户端身份验证

与需要双向 TLS 身份验证时的客户端身份验证相关的设置。

设置描述
私有证书TLS 客户端身份验证期间提供的私有证书。
证书密码访问 TLS 客户端证书所需的密码。

高级设置

未包含在先前类别中的设置。

消息

消息设置确定端口如何搜索消息并在处理后管理它们。

设置描述
保存到已发送文件夹选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。
已发送文件夹方案端口根据选定的时间间隔对 已发送 文件夹中的文件进行分组。例如,Weekly 选项指示端口每周创建一个新的子文件夹,并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在 已发送 文件夹中。对于处理许多事务的端口,使用子文件夹可以帮助保持文件有序并提高性能。

日志

用于管理日志创建和存储的设置。

设置描述
日志级别指定要记录在端口日志目录中的信息类型:
  • None - 不创建任何日志。
  • Error - 仅当端口遇到错误时才创建日志。
  • Warning - 仅当端口发出警告时才创建日志。
  • Info - 记录工作流的一般信息,包括任何错误和警告(如果适用)。
  • Debug - 记录成功和失败工作流的详细调试信息。
  • Trace - 记录成功和失败工作流的详细跟踪信息。
请注意:Debug 和 Trace 级别的日志可能会记录敏感信息,包括消息内容和 SSL 证书。尽管连接属性(例如密码)被屏蔽了,但在与您的组织外部共享它们之前,请查看此级别的日志以避免泄漏敏感信息。
日志文件夹结构指示端口根据选定的时间间隔将日志文件夹中的文件分组。例如,Weekly 选项指示端口每周创建一个新的子文件夹,并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在日志文件夹中。对于处理许多事务的端口,使用子文件夹有助于保持日志的有序性并提高性能。
保留消息副本指示端口在日志目录中保存最新消息副本的切换。请注意,端口每个子文件夹只保留一个消息,并且端口在再次运行时会覆盖以前保存的消息。

其他

特殊设置适用于特定用例。

设置描述
其他设置允许在以分号分隔的列表中配置隐藏的端口设置,例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。

自动化选项卡

自动化设置

与端口自动处理文件相关的设置。

性能

与端口资源分配相关的设置。

设置描述
最大工作线程数此端口上处理文件时从线程池中消耗的最大工作线程数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。
最大文件数分配给端口的每个线程发送的最大文件数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。

通知选项卡

SLA 选项卡

建立连接

至少将设置选项卡上的远程主机设置为MQTT服务器的域名或IP地址。如果使用非标准端口,请设置远程端口。如果需要认证,请设置用户名和密码。 如果需要安全连接,请选中 使用 TLS,并可选择将 TLS 服务器证书 设置为服务器的公共证书,或选择_任何证书_ 接受服务器提供的任何证书。如果该字段使用不当,则会产生安全风险。设置此字段时要格外小心。

发布

为了发布数据,将发布部分中的 主题 设置为端口应该发布消息的主题。服务质量(QoS) 取值范围为 0 到 2,含义如下:
  • 0 - 最多一次 - 发布的消息发送一次,如果没有到达则丢失。
  • 1 - 至少一次 - 保证发布的消息到达,但可能有重复。
  • 2 - 正好一次 - 保证发布消息到达并且没有重复。
在高级选项卡的高级设置部分,重新发布间隔 可以设置为端口等待对需要它们的消息的确认的秒数。如果这段时间过去了而没有收到确认,端口将重新发布消息。重新发布的消息重用原始消息中的数据包 ID,并将自动在消息上设置重复标志。为 重新发布间隔 指定值 0 将阻止端口自动重新发布消息。

订阅

在设置页面的订阅部分,可以选中 启用 MQTT 订阅 选项以指示端口也应该接收数据。选中时,端口将订阅在后台线程上指定的主题,传入的消息将自动放置在交易选项卡中,根据高级选项卡中 本地文件名格式 中指定的值命名。默认情况下,端口将使用消息的主题和数据包 ID 命名文件,使用 %topic%_%packetid%.data 作为 本地文件名格式 的值。 主题过滤 可以设置为端口应订阅的主题过滤器的逗号分隔列表。某些字符在主题过滤器中具有特殊含义:
  • / - 主题级别分隔符
  • # - 多级通配符(零级或多级)
  • + - 单级通配符(正好是一级)
  • Leading $ - 表示”系统主题”
在高级选项卡中,遗愿信息 和 遗愿主题 可以分别设置为服务器应该发布的消息,以及它应该发布该消息的主题,以防万一断开。

宏

示例