跳轉到主要內容
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 用戶端憑證所需的密碼。

進階設定

未包含在先前類別中的設定。

訊息

訊息設定確定端口如何搜尋訊息並在處理後管理它們。

注意:以下設定已棄用,預設處於隱藏狀態。只有先前已啟用這些設定或將其配置為非預設值的端口才會顯示它們。若要保留成功處理的檔案副本,請在工作流程中右鍵單擊該端口,選擇顯示成功路徑,然後將成功路徑連線到 File 端口。

設定描述
儲存到已傳送資料夾(已棄用)將端口處理的檔案複製到 Sent 資料夾。預設停用。儲存到 Sent 資料夾中的檔案不受靜態加密保護。
已傳送資料夾方案(已棄用)按所選時間間隔對 Sent 資料夾中的檔案進行分組。僅在啟用儲存到已傳送資料夾時適用。

日誌

用於管理日誌建立和儲存的設定。

設定描述
日誌級別指定要記錄在端口日誌目錄中的資訊型別:
  • None - 不建立任何日誌。
  • Error - 僅當端口遇到錯誤時才建立日誌。
  • Warning - 僅當端口發出警告時才建立日誌。
  • Info - 記錄工作流程的一般資訊,包括任何錯誤和警告(如果適用)。
  • Debug - 記錄成功和失敗工作流程的詳細偵錯資訊。
  • Trace - 記錄成功和失敗工作流程的詳細跟蹤資訊。
請注意:Debug 和 Trace 級別的日誌可能會記錄敏感資訊,包括訊息內容和 SSL 憑證。儘管連線屬性(例如密碼)被遮蔽了,但在與您的組織外部共享它們之前,請檢視此級別的日誌以避免洩漏敏感資訊。
日誌資料夾結構指示端口根據選定的時間間隔將日誌資料夾中的檔案分組。例如,Weekly 選項指示端口每週建立一個新的子資料夾,並將該周的所有日誌儲存在該資料夾中。空白設定告訴端口將所有日誌直接儲存在日誌資料夾中。對於處理許多交易的端口,使用子資料夾有助於保持日誌的有序性並提高效能。
保留訊息副本指示端口在日誌目錄中儲存最新訊息副本的切換。請注意,端口每個子資料夾只保留一個訊息,並且端口在再次執行時會覆蓋以前儲存的訊息。

其他

特殊設定適用於特定用例。

設定描述
其他設定允許在以分號分隔的清單中配置隱藏的端口設定,例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用這些設定。

自動化索引標籤

自動化設定

與端口自動處理檔案相關的設定。

效能

與端口資源分配相關的設定。

設定描述
最大工作執行緒數此端口上處理檔案時從執行緒池中消耗的最大工作執行緒數。如果設定,則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。
最大檔案數分配給端口的每個執行緒傳送的最大檔案數。如果設定,則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。

通知索引標籤

SLA 索引標籤

日誌索引標籤

日誌索引標籤列出該端口生成的服務日誌。每一行代表一個日誌檔案,並顯示修改日期、檔名、大小和狀態。可以使用搜尋欄或狀態篩選器查詢特定日誌,點選檔名進行預覽或下載,或點選下載全部日誌將所有日誌下載為一個 zip 檔案。

建立連線

至少將設定索引標籤上的遠端主機設定為MQTT伺服器的域名或IP地址。如果使用非標準端口,請設定遠端端口。如果需要認證,請設定使用者名稱和密碼。 如果需要安全連線,請選中 使用 TLS,並可選擇將 TLS 伺服器憑證 設定為伺服器的公共憑證,或選擇_任何憑證_ 接受伺服器提供的任何憑證。如果該欄位使用不當,則會產生安全風險。設定此欄位時要格外小心。

釋出

為了釋出資料,將釋出部分中的 主題 設定為端口應該釋出訊息的主題。服務質量(QoS) 取值範圍為 0 到 2,含義如下:
  • 0 - 最多一次 - 釋出的訊息傳送一次,如果沒有到達則丟失。
  • 1 - 至少一次 - 保證釋出的訊息到達,但可能有重複。
  • 2 - 正好一次 - 保證釋出訊息到達並且沒有重複。
在進階選項卡的進階設定部分,重新發布間隔 可以設定為端口等待對需要它們的訊息的確認的秒數。如果這段時間過去了而沒有收到確認,端口將重新發布訊息。重新發布的訊息重用原始訊息中的資料包 ID,並將自動在訊息上設定重複標誌。為 重新發布間隔 指定值 0 將阻止端口自動重新發布訊息。

訂閱

在設定頁面的訂閱部分,可以選中 啟用 MQTT 訂閱 選項以指示端口也應該接收資料。選中時,端口將訂閱在後臺執行緒上指定的主題,傳入的訊息將自動放置在交易索引標籤中,根據進階選項卡中 本地檔名格式 中指定的值命名。預設情況下,端口將使用訊息的主題和資料包 ID 命名檔案,使用 %topic%_%packetid%.data 作為 本地檔名格式 的值。 主題過濾 可以設定為端口應訂閱的主題過濾器的逗號分隔清單。某些字元在主題過濾器中具有特殊含義:
  • / - 主題級別分隔符號
  • # - 多級萬用字元(零級或多級)
  • + - 單級萬用字元(正好是一級)
  • Leading $ - 表示”系統主題”
在進階選項卡中,遺願資訊 和 遺願主題 可以分別設定為伺服器應該釋出的訊息,以及它應該釋出該訊息的主題,以防萬一斷開。

宏

範例