SiteWise 邊緣閘道疑難排解 - AWS IoT SiteWise
設定和存取 SiteWise Edge 閘道記錄檔疑難排解 SiteWise Edge 閘道問題疑難排 AWS IoT Greengrass 解

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

SiteWise 邊緣閘道疑難排解

AWS IoT SiteWise 邊緣閘道會執行一組 AWS IoT Greengrass 元件。您可以設定 SiteWise Edge 閘道，將事件記錄到 Amazon CloudWatch 和 SiteWise 邊緣閘道的本機檔案系統。然後，您可以檢視記錄檔以對 SiteWise Edge 閘道進行疑難排解。

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

設定和存取 SiteWise Edge 閘道記錄檔

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

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

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

疑難排解 SiteWise Edge 閘道問題

請使用下列資訊來疑難排解 SiteWise Edge 閘道問題。

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

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

升級 AWS IoT Greengrass 核組件（控制台）

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

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

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

  4. 選擇「修訂」。

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

  6. 在 [選取元件] 頁面的 [公用元件] 下，在搜尋方塊中輸入aws.greengrass.Nucleus，然後選取 AWS. GREGrass.Nucleus。

  7. 選擇下一步。

  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 變數映射到資產屬性。如需詳細資訊，請參閱 將工業資料串流對應到資產屬性。

      如果您已對應所需的所有 OPC-UA 變數 AWS IoT SiteWise，您可以篩選邊緣閘道傳送的 OPC-UA 變數 SiteWise 。如需詳細資訊，請參閱 使用 OPC-UA 節點篩選條件。

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

  • TimestampOutOfRangeException— 您的 SiteWise Edge 閘道正在傳送超出 AWS IoT SiteWise 接受範圍的資料。 AWS IoT SiteWise 拒絕任何時間戳記早於過去 7 天或 future 5 分鐘以上的資料點。如果 SiteWise Edge 閘道中斷電源或與 AWS 雲端的連線，您可能需要清除 SiteWise Edge 閘道的快取。

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

儀表板中未顯示任何資料

如果儀表板中沒有顯示任何資料，則 SiteWise Edge 閘道的發行者設定和資料來源可能不同步。如果資料來源不同步，更新資料來源的名稱可能會加速從雲端到邊緣的同步，進而修正「不同步」錯誤。

更新資料來源名稱的步驟

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

  2. 在瀏覽窗格中，選擇 [邊緣閘道]。

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

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

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

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

「無法找到或加載主類」出現在 aws.iot 中。 SiteWiseEdgePublisher 日誌在/綠色/v2 /日誌錯誤

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

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

    java -version

    您的 SiteWise 邊緣網關正在運行的 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 發行者套件更新為 2.4.1 或更新版本。只有 Java 版本 11.0.20.8.1 受到影響，具有其他 Java 版本的環境可以繼續使用舊版的 IoT SiteWise 發行者元件。如需更新元件套件的詳細資訊，請參閱變更 SiteWise Edge 閘道元件套件的版本。

疑難排 AWS IoT Greengrass 解

若要尋找設定或部署 SiteWise Edge 閘道許多問題的解決方案 AWS IoT Greengrass，請參閱AWS IoT Greengrass 開發人員指南 AWS IoT Greengrass中的疑難排解。