分析同步狀態和錯誤 - AWS IoT TwinMaker
同步工作狀態

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

分析同步狀態和錯誤

本主題提供如何分析同步錯誤和狀態的指引。

重要

自訂和預設工作區之間的差異如需有關自訂工作區和預設工作區之間差異的資訊，請參閱。

同步工作狀態

根據同步工作的狀態，同步工作會有下列其中一種狀態。

  • 同步工作CREATING狀態表示工作正在檢查權限並從中載入資料 AWS IoT SiteWise 以準備同步。

  • 同步工作INITIALIZING狀態表示中的所有現有資源 AWS IoT SiteWise 都已同步到 AWS IoT TwinMaker。如果使用者中有大量資產和資產模型，則此步驟可能需要更長的時間才能完成 AWS IoT SiteWise。您可以透過檢查AWS IoT TwinMaker 主控台中的同步工作或呼叫 ListSyncResources API 來監視已同步的資源數量。

  • 同步工作ACTIVE狀態表示初始化步驟已完成。工作現在已準備就緒，可以從中同步任何新的更新 AWS IoT SiteWise。

  • 同步工作ERROR狀態會指出前述任何狀態的錯誤。檢閱錯誤訊息。IAM 角色設定可能有問題。如果您想要使用新的 IAM 角色，請刪除發生錯誤的同步工作，然後使用新角色建立新的同步工作。

同步錯誤會出現在模型來源頁面中，該頁面可從工作區中的「實體」模型來源表格存取。模型來源頁面會顯示無法同步的資源清單。同步工作會自動重試大多數錯誤，但如果資源需要動作，則會維持狀ERROR態。您也可以使用 ListSyncResourcesAPI 取得錯誤清單。

若要查看目前來源的所有列出錯誤，請使用下列程序。

  1. 導覽至AWS IoT TwinMaker 主控台中的工作區。

  2. 選取「實體」模型來 AWS IoT SiteWise 源模式中列出的來源，以開啟資產同步詳細資訊頁面。

    AWS IoT SiteWise 來源頁面會顯示資產同步詳細資訊，包括錯誤。

  3. 如前面的螢幕擷取畫面所示，任何具有持續性錯誤的資源都會列在「錯誤」表格中。您可以使用此表格追蹤並修正與特定資源相關的錯誤。

可能的錯誤包括以下內容：

  • 雖然 AWS IoT SiteWise 支援重複的資產名稱，但 AWS IoT TwinMaker 僅在ROOT層級支援它們，而不支援相同的父實體下。如果在中的父實體下有兩個名稱相同的資產 AWS IoT SiteWise，其中一個資產無法同步。若要修正此錯誤，請先刪除其中一個資產，或在同步 AWS IoT SiteWise 之前將其中一個資產移至其他上層資產下方。

  • 如果您已經擁有與 AWS IoT SiteWise 資產 ID 相同 ID 的實體，則該資產無法同步，直到您刪除現有實體為止。