SiteWise Edge 閘道故障診斷 - AWS IoT SiteWise
設定和存取 SiteWise Edge 閘道日誌SiteWise Edge 閘道問題疑難排解對 上的 AWS IoT SiteWise Edge 應用程式進行故障診斷 Siemens Industrial Edge故障診斷 AWS IoT Greengrass 問題

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

SiteWise Edge 閘道故障診斷

探索相關主題，針對常見的 AWS IoT SiteWise Edge 閘道問題進行故障診斷。

您也可以檢視 SiteWise Edge 閘道報告的 CloudWatch 指標，以疑難排解連線或資料串流的問題。如需詳細資訊，請參閱AWS IoT SiteWise 使用 Amazon CloudWatch 指標進行監控。

設定和存取 SiteWise Edge 閘道日誌

在檢視 SiteWise Edge 閘道日誌之前，您必須設定 SiteWise Edge 閘道將日誌傳送至 Amazon CloudWatch Logs 或在本機檔案系統上存放日誌。

  • 如果您想要使用 檢視 SiteWise Edge 閘道的日誌檔案 AWS Management Console ，請使用 CloudWatch Logs。 SiteWise 如需詳細資訊，請參閱使用 Amazon CloudWatch Logs。

  • 如果您想要使用命令列或本機軟體來檢視 SiteWise Edge 閘道的日誌檔案，請使用本機檔案系統日誌。如需詳細資訊，請參閱在 中使用服務日誌 AWS IoT SiteWise。

SiteWise Edge 閘道問題疑難排解

使用下列資訊對 SiteWise Edge 閘道問題進行故障診斷。

無法將套件部署至 SiteWise Edge 閘道

如果核元件 AWS IoT Greengrass (aws.greengrass.Nucleus) 已過期，則可能無法將套件部署到 SiteWise Edge 閘道。您可以使用 AWS IoT Greengrass V2 主控台來升級 nucleus AWS IoT Greengrass 元件。

升級 nucleus AWS IoT Greengrass 元件 （主控台）

  1. 導覽至 AWS IoT Greengrass 主控台。

  2. 在導覽窗格中的 下AWS IoT Greengrass，選擇部署。

  3. 在部署清單中，選取您要修改的部署。

  4. 選擇修訂。

  5. 在指定目標頁面上，選擇下一步。

  6. 在選取元件頁面的公有元件下，於搜尋方塊中輸入 aws.greengrass.Nucleus，然後選取 aws.greengrass.Nucleus。

  7. 選擇 Next (下一步)。

  8. 在設定元件頁面上，選擇下一步。

  9. 在設定進階設定頁面上，選擇下一步。

  10. 在 Review (檢閱) 頁面，選擇 Deploy (部署)。

AWS IoT SiteWise 不會從 OPC UA 伺服器接收資料

如果您的 AWS IoT SiteWise 資產未接收 OPC UA 伺服器傳送的資料，您可以搜尋 SiteWise Edge 閘道的日誌來疑難排解問題。尋找包含下列訊息的資訊層級swPublisher日誌。

Emitting diagnostic name=PublishError.SomeException

根據日誌中的 SomeException 類型，請使用下列例外狀況類型和對應的問題來疑難排解 SiteWise Edge 閘道：

  • ResourceNotFoundException – OPC UA 伺服器正在傳送不符合任何資產屬性別名的資料。此例外狀況可能會發生在兩種情況下：

    • 您的屬性別名與您的 OPC UA 變數不完全相符，包括您定義的任何來源字首。檢查您的屬性別名和來源前綴是否正確。

    • 您尚未將 OPC UA 變數映射至資產屬性。如需詳細資訊，請參閱管理 的資料串流 AWS IoT SiteWise。

      如果您已映射所有想要的 OPC UA 變數 AWS IoT SiteWise，您可以篩選 SiteWise Edge 閘道傳送的 OPC UA 變數。如需詳細資訊，請參閱在 SiteWise Edge 中使用 OPC UA 節點篩選條件。

  • InvalidRequestException – OPC UA 變數資料類型與您的資產屬性資料類型不相符。例如，如果 OPC UA 變數具有整數資料類型，則對應的資產屬性必須是整數資料類型。雙類型資產屬性無法接收 OPC UA 整數值。若要修正此問題，請使用正確的資料類型定義新的屬性。

  • TimestampOutOfRangeException – 您的 SiteWise Edge 閘道正在傳送超出 AWS IoT SiteWise 接受範圍的資料。 AWS IoT SiteWise 拒絕過去 7 天內或未來 5 分鐘內具有時間戳記的任何資料點。如果您的 SiteWise Edge 閘道失去與 AWS 雲端的電源或連線，您可能需要清除 SiteWise Edge 閘道的快取。

  • ThrottlingException 或 LimitExceededException – 您的請求超過 AWS IoT SiteWise 服務配額，例如擷取資料點的速率或資產屬性資料 API 操作的請求速率。核對您的組態沒有超過 AWS IoT SiteWise 配額。

儀表板中未顯示任何資料

如果您的儀表板中沒有顯示任何資料，則 SiteWise Edge 閘道的發佈者組態和資料來源可能會不同步。如果不同步，更新資料來源的名稱可能會加快從雲端到邊緣的同步，修正不同步錯誤。

更新資料來源的名稱

  1. 導覽至 AWS IoT SiteWise 主控台。

  2. 在導覽窗格中，選擇 Edge 閘道。

  3. 選取連線至儀表板的 SiteWise Edge 閘道。

  4. 在資料來源下，選取編輯。

  5. 選取新的來源名稱，然後選取儲存以確認您的變更。

  6. 確認資料來源資料表中的資料來源名稱已更新，以驗證您的變更。

出現於 /greengrass/v2/logs 錯誤的 aws.iot.SiteWiseEdgePublisher 日誌中的「找不到或載入主類別」

如果您看到此錯誤，您可能需要更新 SiteWise Edge 閘道的 Java 版本。

  • 從終端機執行下列命令：

    java -version

    您的 SiteWise Edge 閘道執行的 java 版本會顯示在 下OpenJDK Runtime Environment。您將看到如下所示的回應：

    openjdk version "11.0.20" 2023-07-18 LTS
OpenJDK Runtime Environment Corretto011.0.20.8.1 (build 11.0.20+8-LTS
OpenJDK 64-Bit Server VM Corretto-11.0.20.8.1 (build 11.0.20+8-LTS, mixed node)

如果您執行的是 Java 11.0.20.8.1 版，則必須將 IoT SiteWise Publisher 套件更新至 2.4.1 版或更新版本。只有 java 11.0.20.8.1 版受到影響，具有其他 java 版本的環境可以繼續使用舊版 IoT SiteWise Publisher 元件。如需更新元件套件的詳細資訊，請參閱變更 SiteWise Edge 閘道元件套件的版本。

我看到 'SESSION_TAKEN_OVER' 或 'com.aws.greengrass.mqtclient.MqttClient：無法透過 Spooler 發佈訊息，並會重試。' 日誌中

如果您在 的日誌com.aws.greengrass.mqttclient.MqttClient: Failed to publish the message via Spooler and will retry.中看到包含 的警告SESSION_TAKEN_OVER或包含 的錯誤/greengrass/v2/logs/greengrass.log，則您可能嘗試在多個裝置上將相同的組態檔案用於多個 SiteWise Edge 閘道。每個 SiteWise Edge 閘道都需要唯一的組態檔案，才能連線至 AWS 您的帳戶。

我看到 'com.aws.greengrass.deployment.IotJobsHelper：找不到部署任務。' 或 '部署結果已報告。' 日誌中

如果您在 的日誌Deployment result already reported.中看到 com.aws.greengrass.deployment.IotJobsHelper: No deployment job found.或 /greengrass/v2/logs/greengrass.log，則可能嘗試重複使用相同的組態檔案。

有多個解決方案：

  • 如果您想要重複使用組態檔案，請執行下列動作：

    1. 導覽至 AWS IoT SiteWise 主控台。

    2. 在導覽窗格中，選擇 Edge 閘道。

    3. 選擇您要重複使用的 SiteWise Edge 閘道。

    4. 選擇更新索引標籤。

    5. 選取不同的發佈者版本，然後選擇部署。

請依照 中的步驟建立 的閘道 Siemens Industrial Edge建立新的組態檔案。

在 OPC UA 資料來源上嘗試在屬性群組中設定時間戳記設定時，我看到「SYNC_FAILED」狀態

在 2.5.0 版 AWS IoT Greengrass 中 AWS IoT SiteWise 更新 的 OPC UA 收集器元件時，我們推出了新的時間戳記組態選項。您可以使用來自您裝置的時間戳記，或是來自伺服器的時間戳記。OPC UA 收集器元件的較舊版本不支援此選項，且無法同步。

有兩種方法可以解決失敗的資料來源同步狀態。建議的方式是將 IoT SiteWise OPC UA 收集器元件升級至 2.5.0 版或更新版本。或者，如果您將時間戳記設定為 ，則可以繼續使用較舊的 OPC UA 收集器元件版本Source。若要了解如何升級 IoT SiteWise OPC UA 收集器元件，請參閱 更新元件 AWS IoT SiteWise 的版本。我們建議使用所有元件的最新版本。

注意

當資料來源同步狀態失敗時，不會中斷資料。來源資料會繼續流入 AWS IoT SiteWise。組態不會與 AWS IoT Greengrass V2 部署上的 IoT SiteWise OPC UA 收集器元件同步。

變更屬性群組的時間戳記組態

  1. 導覽至 AWS IoT SiteWise 主控台。

  2. 在導覽窗格中，選擇 Edge 閘道。

  3. 選取要編輯的閘道。

  4. 在資料來源區段中，選取具有失敗同步狀態的資料來源，然後選擇編輯。

  5. 展開進階組態，然後展開群組設定。

  6. 在時間戳記中，選取來源。選取來源會從組態中移除 timestampToReturn 屬性。此設定預設會從您的裝置收集資料來源時間戳記，允許資料來源與 IoT SiteWise OPC UA 收集器元件同步。

  7. 選擇 Save (儲存)。

不包含轉換的資料類型

如果您在將不支援的 OPC UA 資料類型轉換為字串時看到錯誤 AWS IoT SiteWise，可能的原因有幾個：

  • 您嘗試轉換的資料類型是複雜的資料類型。不支援複雜的資料類型。

  • 當使用 Amazon S3 將目的地AWS IoT SiteWise 做為緩衝區使用Amazon S3時，完整的字串值會保留在推送至 Amazon S3 儲存貯體的檔案中。當您稍後擷取資料到 時 AWS IoT SiteWise，會拒絕超過 1024 個位元組的完整字串值。

信任存放區問題

如果您遇到與 SiteWise Edge 中的信任存放區相關的問題，請考慮下列疑難排解步驟：

  • 驗證 AWS IoT Greengrass 根 CA 憑證是否存在，並在適當的信任存放區中正確格式化

  • 確定 Java KeyStore 密碼已正確設定，且 SiteWise Edge 元件可存取

  • 檢查任何自訂憑證 （例如 HTTPS 代理） 的格式是否正確 （通常是 PEM)，並正確匯入信任存放區

  • 確認信任存放區具有正確的檔案許可，且可供 SiteWise Edge 程序存取

  • 檢閱 SiteWise Edge 日誌是否有任何 SSL/TLS 相關錯誤，這可能表示信任存放區問題

  • 使用 等工具獨立測試 SSL/TLS 連線openssl，以驗證信任存放區功能

啟用代理的安裝問題

如果您在代理組態程序期間遇到問題，請考慮下列疑難排解步驟：

  • 確認代理 URL 已正確格式化，並包含適當的結構描述 (http:// 或 https://)

  • 如果代理登入資料包含特殊字元，請確保其為 URL 編碼

  • 確認無代理清單包含所有必要的本機地址 AWS 和服務端點

  • 對於 HTTPS 代理，請確認提供的 CA 憑證為 PEM 格式

  • 檢閱安裝日誌，了解可能指出問題來源的特定錯誤訊息

  • 獨立測試代理連線，以確保其正常運作

對 上的 AWS IoT SiteWise Edge 應用程式進行故障診斷 Siemens Industrial Edge

若要對Siemens Industrial Edge裝置上的 AWS IoT SiteWise Edge 應用程式進行故障診斷，您可以透過 Siemens Industrial Edge Management或 Siemens Industrial Edge Device (IED) 入口網站存取應用程式的日誌。如需詳細資訊，請參閱 Siemens 文件中的下載日誌。

我的資料不會顯示在 中 AWS IoT SiteWise

  • 確保您的Databus使用者沒有問題，且 Databus_Configuration 的核取記號圖示為綠色而非灰色。

  • 您可能未在包含 的版本Siemens Industrial Edge Management上執行Secure Storage。升級您的 Siemens 作業系統版本。如需詳細資訊，請參閱Siemens Secure Storage 和 AWS IoT SiteWise Edge 應用程式。

我在日誌中看到「Config 檔案缺少 AWS_REGION」。

如果您在 Siemens 日誌Config file missing AWS_REGION中看到 ，表示組態檔案的 JSON 已損毀。您需要建立新的組態檔案。請依照 中的步驟建立 的閘道 Siemens Industrial Edge建立新的組態檔案。

故障診斷 AWS IoT Greengrass 問題

若要尋找設定或部署 SiteWise Edge 閘道時許多問題的解決方案 AWS IoT Greengrass，請參閱《 AWS IoT Greengrass 開發人員指南》中的故障診斷 AWS IoT Greengrass。