SiteWise Edge ゲートウェイのトラブルシューティング

関連するトピックを調べて、 AWS IoT SiteWise 一般的な Edge ゲートウェイの問題をトラブルシューティングします。

SiteWise Edge ゲートウェイによって報告された CloudWatch メトリクスを表示して、接続またはデータストリームに関する問題をトラブルシューティングすることもできます。詳細については、「Amazon CloudWatch メトリクス AWS IoT SiteWise によるモニタリング」を参照してください。

SiteWise Edge ゲートウェイログの設定とアクセス

SiteWise Edge ゲートウェイログを表示する前に、Amazon CloudWatch Logs にログを送信するか、ローカルファイルシステムにログを保存するように SiteWise Edge ゲートウェイを設定する必要があります。

• を使用して SiteWise Edge ゲートウェイのログファイルを表示する場合は AWS Management Console 、 CloudWatch ログを使用します。詳細については、「Amazon CloudWatch Logs の使用」を参照してください。

• コマンドラインまたはローカルソフトウェアを使用して SiteWise Edge ゲートウェイのログファイルを表示する場合は、ローカルファイルシステムログを使用します。詳細については、「サービスログを使用する」を参照してください。

SiteWise Edge ゲートウェイの問題のトラブルシューティング

SiteWise Edge ゲートウェイの問題をトラブルシューティングするには、次の情報を使用します。

問題

• SiteWise Edge ゲートウェイにパックをデプロイできない
• AWS IoT SiteWise OPCUA サーバーからデータを受信しない
• ダッシュボードにデータが表示されない
• /greengrass/v2/logs エラーで aws.iot.SiteWiseEdgePublisher logs に表示される「メインクラスが見つからないかロードされませんでした」
• SESSION「_TAKEN_OVER」または「com.aws.greengrass.mqttclient」と表示されます。MqttClient: スプーラー経由でメッセージを発行できませんでした。再試行します。」 ログ内の
• 「com.aws.greengrass.deployment.IotJobsHelper: デプロイジョブが見つかりません」と表示されます。または「デプロイ結果が既に報告されています」。ログ内の
• 変換されたデータ型は含まれません

SiteWise Edge ゲートウェイにパックをデプロイできない

AWS IoT Greengrass nucleus コンポーネント (aws.greengrass.Nucleus) が古くなっている場合、 SiteWise Edge ゲートウェイにパックをデプロイできない可能性があります。 AWS IoT Greengrass V2 コンソールを使用して AWS IoT Greengrass nucleus コンポーネントをアップグレードできます。

AWS IoT Greengrass nucleus コンポーネントのアップグレード (コンソール）

1. AWS IoT Greengrass コンソールに移動します。

2. ナビゲーションペインの AWS IoT Greengrass で、[デプロイ] を選択します。

3. デプロイのリストで、修正するデプロイを選択します。

4. [修正] を選択します。

5. [Specify target] (ターゲットの指定) ページで [Next] (次へ) を選択します。

6. [コンポーネントの選択] ページの [パブリックコンポーネント] の検索ボックスに aws.greengrass.Nucleus と入力し、aws.greengrass.Nucleus を選択します。

7. [Next (次へ)] を選択します。

8. [コンポーネントの設定] ページで、[次へ] をクリックします。

9. [詳細設定の設定] ページで、[次へ] を選択します。

10. [Review] ページで、[デプロイ] を選択します。

AWS IoT SiteWise OPCUA サーバーからデータを受信しない

AWS IoT SiteWise アセットが OPC UA サーバーから送信されたデータを受信していない場合は、 SiteWise エッジゲートウェイのログを検索して問題をトラブルシューティングできます。次のメッセージを含む情報レベルの swPublisher ログを探します。

Emitting diagnostic name=PublishError.SomeException

のタイプに基づく SomeException ログで、次の例外タイプと対応する問題を使用して SiteWise Edge ゲートウェイのトラブルシューティングを行います。

• ResourceNotFoundException – OPC UA サーバーは、アセットのプロパティエイリアスと一致しないデータを送信しています。この例外は、次の 2 つの場合に発生します。

  • プロパティエイリアスは、定義したソースプレフィックスを含め、OPCUA 変数と完全には一致しません。プロパティエイリアスとソースプレフィックスが正しいことを確認します。

  • OPC UA 変数をアセットプロパティにマッピングしていません。詳細については、「産業データストリームをアセットプロパティにマッピングする」を参照してください。

    で必要なすべての OPC UA 変数を既にマッピングしている場合は AWS IoT SiteWise、 SiteWise エッジゲートウェイが送信する OPC UA 変数をフィルタリングできます。詳細については、「OPC UA ノードフィルターを使用する」を参照してください。

• InvalidRequestException – OPC UA 変数のデータ型がアセットプロパティのデータ型と一致しません。例えば、OPCUA 変数に整数データ型がある場合、対応するアセットプロパティは整数データ型である必要があります。ダブルタイプのアセットプロパティは OPC UA 整数値を受信できません。この問題を解決するには、正しいデータ型で新しいプロパティを定義します。

• TimestampOutOfRangeException – SiteWise Edge ゲートウェイは、 AWS IoT SiteWise Accepts. AWS IoT SiteWise rejects の範囲外のデータを送信しています。タイムスタンプが過去 7 日より前、または今後 5 分より新しいデータポイントを拒否します。 SiteWise Edge ゲートウェイの電源または AWS クラウドへの接続が失われた場合は、 SiteWise Edge ゲートウェイのキャッシュをクリアする必要がある場合があります。

• ThrottlingException または LimitExceededException – リクエストが、取り込まれたデータポイントのレートやアセットプロパティデータAPIオペレーションのリクエストレートなどの AWS IoT SiteWise サービスクォータを超えました。設定が AWS IoT SiteWise クォータ を超えないことを確認します。

ダッシュボードにデータが表示されない

ダッシュボードにデータが表示されない場合、 SiteWise Edge ゲートウェイのパブリッシャー設定とデータソースが同期していない可能性があります。同期されていない場合、データソースの名前を更新すると、クラウドからエッジへの同期が迅速になり、同期停止エラーが修正される可能性があります。

データソースの名前を更新するには

1. AWS IoT SiteWise コンソールに移動します。

2. ナビゲーションペインで、エッジゲートウェイ を選択します。

3. ダッシュボードに接続されている SiteWise Edge ゲートウェイを選択します。

4. [データソース] で [編集] を選択します。

5. 新しいソースの [名前] を選択し、[保存] を選択して変更を確定します。

6. データソーステーブルのデータソース名が更新されて、変更が反映されていることを確認します。

/greengrass/v2/logs エラーで aws.iot.SiteWiseEdgePublisher logs に表示される「メインクラスが見つからないかロードされませんでした」

このエラーが表示された場合は、 SiteWise エッジゲートウェイの 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 Pack をバージョン 2.4.1 以降に更新する必要があります。Java バージョン 11.0.20.8.1 のみが影響を受け、他の Java バージョンを使用する環境では、古いバージョンの IoT SiteWise Publisher コンポーネントを引き続き使用できます。コンポーネントパックの更新の詳細については、「 SiteWise Edge ゲートウェイコンポーネントパックのバージョンを変更する」を参照してください。

SESSION「_TAKEN_OVER」または「com.aws.greengrass.mqttclient」と表示されます。MqttClient: スプーラー経由でメッセージを発行できませんでした。再試行します。」 ログ内の

のログ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. ナビゲーションペインで、[ Gateways] を選択します。

  3. 再利用する SiteWise Edge ゲートウェイを選択します。

  4. [更新] タブを選択します。

  5. 別のパブリッシャーバージョンを選択し、デプロイ を選択します。

のゲートウェイを作成する Siemens Industrial Edge 「」の手順に従って、新しい設定ファイルを作成します。

変換されたデータ型は含まれません

サポートされていない OPC UA データ型を の文字列に変換するときにエラーが表示される場合は AWS IoT SiteWise、いくつかの理由が考えられます。

• 変換しようとしているデータ型は複雑なデータ型です。複雑なデータ型はサポートされていません。

• Amazon S3 を使用してバッファリングとして送信先を使用する場合、完全な文字列値は Amazon S3 バケットにプッシュされたファイルに保持されます。 AWS IoT SiteWise Amazon S3 後で にデータを取り込むと AWS IoT SiteWise、1024 バイトを超える文字列値はすべて拒否されます。

での AWS IoT SiteWise Edge アプリケーションのトラブルシューティング Siemens Industrial Edge

Siemens Industrial Edge デバイス上の AWS IoT SiteWise Edge アプリケーションのトラブルシューティングを行うには、 Siemens Industrial Edge Managementまたは Siemens Industrial Edge Device (IED) ポータルからアプリケーションのログにアクセスできます。詳細については、 ドキュメントの「Downloading Logs」を参照してください。

データが に表示されない AWS IoT SiteWise

• Databus ユーザーに問題がなく、Databus_Configuration のチェックマークアイコンが灰色ではなく緑色であることを確認します。

• を含むバージョンSiemens Industrial Edge Managementでは を実行していない可能性がありますSecure Storage。 OS のバージョンをアップグレードします。詳細については、「Siemens Secure Storage と AWS IoT SiteWise Edge アプリケーション」を参照してください。

ログに「Config ファイル欠落 AWS_REGION」が表示されます。

ログConfig file missing AWS_REGIONに が表示された場合、設定ファイルの JSON が破損しています。新しい設定ファイルを作成する必要があります。のゲートウェイを作成する Siemens Industrial Edge 「」の手順に従って、新しい設定ファイルを作成します。

AWS IoT Greengrass 問題のトラブルシューティング

で SiteWise Edge ゲートウェイを設定またはデプロイする際の多くの問題の解決策を見つけるには AWS IoT Greengrass、「 AWS IoT Greengrass デベロッパーガイド」の「トラブルシューティング AWS IoT Greengrass」を参照してください。