邊緣端設備上傳數據至 InsightAPM 後設備顯示離線通用解決方案

jacey_xiao
Thu, 26 Mar 2026 08:46:58 +0000
InsightAPM(TwinBuilder)

一、問題概述

邊緣端設備（如 WebAccess、各類採集終端 / 網關等）向 APM 平台上傳數據後，平台側設備持續顯示離線狀態，此問題核心與數據上傳鏈路中斷相關，以下為通用排查流程，適用於所有邊緣端上傳場景。

二、核心數據上傳路徑

邊緣端設備 → 網路 / 防火牆策略層 → MQTT Broker → APM 平台關鍵邏輯：APM 設備在線狀態完全依賴 MQTT Broker 接收的邊緣端上報數據，Broker 未接收到數據，APM 必顯示離線，並非一定為 APM 平台本身故障。

三、前置準備：從 APM 平台獲取 Broker 配置資訊

排查前需先從 APM 平台提取真實有效的 MQTT Broker 連接配置，確保排查工具與邊緣端設備使用一致配置，獲取路徑如下：

1. 登錄 APM 平台後，進入【IoT 數據接入管理】模塊

2. 找到對應網關, 找到連接資訊模塊

3. 提取核心配置：Broker 的 Host 地址、Port 端口、vhost 虛擬主機、認證用戶名、密碼、指定上報 Topic 格式

4. 重點備註：APM 平台中 Broker 認證用戶名格式為「vhost: 用戶名」，需按此格式完整使用

四、通用排查步驟（按優先級執行）

步驟 1：先確認 WebAccess 主機可正常解析 MQTT Broker 網域

操作位置：WebAccess 節點主機（執行 WebAccess Node 的電腦）
操作方式：開啟 CMD 執行

ping <broker-domain>
nslookup <broker-domain>

步驟 2：確認 1883 / 8883 連線埠可正常連外

操作位置： 一樣在 WebAccess 主機
操作方式：CMD 或 PowerShell 測試連線

telnet <broker-domain> 1883
telnet <broker-domain> 8883

步驟 3：驗證 MQTT Broker 是否接收邊緣端數據

1. 工具：使用 MQTTBox/MQTTX/MQTT Explorer 等第三方 MQTT 測試工具

2. 操作：按步驟 3 提取的APM 平台 Broker 配置，完整填寫至測試工具，建立與 Broker 的連接

3. 驗證：連接成功後（工具顯示 Connected），訂閱 APM 指定的上報 Topic，觀察工具是否能接收到邊緣端的 data 封包

4. 結果判定：

訂閱完全沒有訊息 → 問題在 WebAccess 側

有收到資料訊息 → 問題在 InsightAPM 平台側

五、MQTT Broker 排查工具操作示意（以 MQTTBox 為例）

1. 打開工具新建 MQTT Client，完整填寫從 APM 提取的 Broker 配置（Host/Port/ 帳密等），保存後建立連接；

2. 連接成功後點擊【Add subscriber】，輸入 APM 指定的 Topic 格式（無空格、替換實際憑證 ID 等變量）；
Topic: /wisepaas/scada/{NodeID}/data

3. QoS 按 APM 配置選擇（默認 0 - Almost Once），點擊【Subscribe】訂閱，觀察是否有 data 封包持續上報。

六、總結

邊緣端上傳 APM 後設備離線，90% 以上為前端鏈路問題（設備配置 / 網路防火牆），建議優先按上述流程驗證 Broker 收數狀態，再根據結果定向排查；若確認為 APM 平台側問題，請聯繫研華WISE-IoT團隊處理。

2 posts - 1 participant