核心功能
- 双向 IoT 消息队列,支持多个服务质量(QoS)级别
- 支持 TLS 加密和客户端证书身份验证,并具备可配置的心跳(Keep-alive)间隔
- 基于主题(Topic)的过滤,支持通配符及遗嘱(Last Will)消息处理
概述
通过 MQTT 端口发送数据会将数据发布到配置的主题,并且在端口订阅的任何主题上接收的消息将放置在交易选项卡中。端口配置
本节包含所有可配置的端口属性。设置选项卡
主机配置
与远程MQTT服务器连接相关的设置。客户端身份验证
与对远程 MQTT 服务器进行身份验证相关的设置。TLS 设置
与通过 TLS 建立安全连接相关的设置。发布
与发布MQTT消息相关的设置。订阅
订阅MQTT消息相关的设置。高级选项卡
TLS 客户端身份验证
与需要双向 TLS 身份验证时的客户端身份验证相关的设置。
| 设置 | 描述 |
|---|---|
| 私有证书 | TLS 客户端身份验证期间提供的私有证书。 |
| 证书密码 | 访问 TLS 客户端证书所需的密码。 |
高级设置
未包含在先前类别中的设置。消息
消息设置确定端口如何搜索消息并在处理后管理它们。
注意:以下设置已弃用,默认处于隐藏状态。只有先前已启用这些设置或将其配置为非默认值的端口才会显示它们。若要保留成功处理的文件副本,请在工作流中右键单击该端口,选择显示成功路径,然后将成功路径连接到 File 端口。
| 设置 | 描述 |
|---|---|
| 保存到已发送文件夹(已弃用) | 将端口处理的文件复制到 Sent 文件夹。默认禁用。保存到 Sent 文件夹中的文件不受静态加密保护。 |
| 已发送文件夹方案(已弃用) | 按所选时间间隔对 Sent 文件夹中的文件进行分组。仅在启用保存到已发送文件夹时适用。 |
日志
用于管理日志创建和存储的设置。
| 设置 | 描述 |
|---|---|
| 日志级别 | 指定要记录在端口日志目录中的信息类型:
|
| 日志文件夹结构 | 指示端口根据选定的时间间隔将日志文件夹中的文件分组。例如,Weekly 选项指示端口每周创建一个新的子文件夹,并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在日志文件夹中。对于处理许多事务的端口,使用子文件夹有助于保持日志的有序性并提高性能。 |
| 保留消息副本 | 指示端口在日志目录中保存最新消息副本的切换。请注意,端口每个子文件夹只保留一个消息,并且端口在再次运行时会覆盖以前保存的消息。 |
其他
特殊设置适用于特定用例。
| 设置 | 描述 |
|---|---|
| 其他设置 | 允许在以分号分隔的列表中配置隐藏的端口设置,例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。 |
自动化选项卡
自动化设置
与端口自动处理文件相关的设置。性能
与端口资源分配相关的设置。
| 设置 | 描述 |
|---|---|
| 最大工作线程数 | 此端口上处理文件时从线程池中消耗的最大工作线程数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。 |
| 最大文件数 | 分配给端口的每个线程发送的最大文件数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。 |
通知选项卡
SLA 选项卡
日志选项卡
日志选项卡列出该端口生成的服务日志。每一行代表一个日志文件,并显示修改日期、文件名、大小和状态。可以使用搜索栏或状态筛选器查找特定日志,点击文件名进行预览或下载,或点击下载全部日志将所有日志下载为一个 zip 文件。
建立连接
至少将设置选项卡上的远程主机设置为MQTT服务器的域名或IP地址。如果使用非标准端口,请设置远程端口。如果需要认证,请设置用户名和密码。 如果需要安全连接,请选中 使用 TLS,并可选择将 TLS 服务器证书 设置为服务器的公共证书,或选择_任何证书_ 接受服务器提供的任何证书。如果该字段使用不当,则会产生安全风险。设置此字段时要格外小心。发布
为了发布数据,将发布部分中的 主题 设置为端口应该发布消息的主题。服务质量(QoS) 取值范围为 0 到 2,含义如下:- 0 - 最多一次 - 发布的消息发送一次,如果没有到达则丢失。
- 1 - 至少一次 - 保证发布的消息到达,但可能有重复。
- 2 - 正好一次 - 保证发布消息到达并且没有重复。
订阅
在设置页面的订阅部分,可以选中 启用 MQTT 订阅 选项以指示端口也应该接收数据。选中时,端口将订阅在后台线程上指定的主题,传入的消息将自动放置在交易选项卡中,根据高级选项卡中 本地文件名格式 中指定的值命名。默认情况下,端口将使用消息的主题和数据包 ID 命名文件,使用%topic%_%packetid%.data 作为 本地文件名格式 的值。
主题过滤 可以设置为端口应订阅的主题过滤器的逗号分隔列表。某些字符在主题过滤器中具有特殊含义:
- / - 主题级别分隔符
- # - 多级通配符(零级或多级)
- + - 单级通配符(正好是一级)
- Leading $ - 表示”系统主题”