同期ステータスとエラーを分析する

このトピックでは、同期エラーとステータスを分析する方法についてのガイダンスを提供します。

重要

カスタムワークスペースとデフォルトワークスペースの違いについては、カスタムワークスペースとデフォルトワークスペースの違い「」を参照してください。

ジョブステータスを同期する

同期ジョブは、状態に応じて以下のいずれかのステータスになります。

• 同期ジョブ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 状態のままになります。 ListSyncResources API を使用してエラーのリストを取得することもできます。

現在のソースのリストにあるエラーをすべて表示するには、以下の手順を実行します。

1. AWS IoT TwinMaker コンソールのワークスペースに移動します。

2. エンティティモデル AWS IoT SiteWise ソースモーダルにリストされているソースを選択して、アセット同期の詳細ページを開きます。

   

3. 前のスクリーンショットに示すように、エラーが続くリソースは [エラー] テーブルに一覧表示されます。このテーブルを使用して、特定のリソースに関連するエラーを追跡して修正できます。

次のようなエラーが考えられます。

• AWS IoT SiteWise は重複するアセット名をサポートしますが、 は同じ親エンティティではなく、 ROOT レベルで AWS IoT TwinMaker のみサポートします。の親エンティティの下に同じ名前のアセットが 2 つある場合 AWS IoT SiteWise、そのうちの 1 つが同期に失敗します。このエラーを修正するには、同期 AWS IoT SiteWise する前に、いずれかのアセットを削除するか、 内の別の親アセットに移動してください。

• アセット ID と同じ ID を持つエンティティが AWS IoT SiteWise 既にある場合、そのアセットは既存のエンティティを削除するまで同期に失敗します。