翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# SiteWise Edge ゲートウェイのトラブルシューティング
関連するトピックを調べて、一般的な AWS IoT SiteWise Edge ゲートウェイの問題をトラブルシューティングします。
SiteWise Edge ゲートウェイによって報告された CloudWatch メトリクスを表示して、接続またはデータストリームに関する問題のトラブルシューティングを行うこともできます。詳細については、「[Amazon CloudWatch メトリクス AWS IoT SiteWise によるモニタリング](monitor-cloudwatch-metrics.md)」を参照してください。
**Topics**
+ [SiteWise Edge ゲートウェイログを設定してアクセスする](#configure-gateway-logs)
+ [SiteWise Edge ゲートウェイの問題のトラブルシューティング](#troubleshoot-gateway-issues)
+ [での AWS IoT SiteWise Edge アプリケーションのトラブルシューティング Siemens Industrial Edge](#troubleshoot-siemens-app)
+ [Edge でのオープンソース統合のトラブルシューティング](#open-source-troubleshooting)
+ [AWS IoT Greengrass 問題のトラブルシューティング](#troubleshoot-greengrass-issues)
## SiteWise Edge ゲートウェイログを設定してアクセスする
SiteWise Edge ゲートウェイログを表示する前に、Amazon CloudWatch Logs にログを送信するか、ローカルファイルシステムにログを保存するように、SiteWise Edge ゲートウェイを設定する必要があります。
+ を使用して SiteWise Edge ゲートウェイのログファイルを表示する場合は AWS マネジメントコンソール 、CloudWatch Logs を使用します。詳細については、「[Amazon CloudWatch Logs を使用](gateway-cloudwatch-logs.md)」を参照してください。
+ コマンドラインまたはローカルソフトウェアを使用して SiteWise Edge ゲートウェイのログファイルを表示する場合は、ローカルファイルシステムログを使用します。詳細については、「[でサービスログを使用する AWS IoT SiteWise](gateway-local-logs.md)」を参照してください。
## SiteWise Edge ゲートウェイの問題のトラブルシューティング
SiteWise Edge ゲートウェイの問題をトラブルシューティングするには、次の情報を使用します。
**Topics**
+ [SiteWise Edge ゲートウェイにパックをデプロイできない](#gateway-issue-ggv2-packs)
+ [AWS IoT SiteWise は OPC UA サーバーからデータを受信しません](#gateway-issue-data-streams)
+ [ダッシュボードにデータが表示されない](#gateway-issue-no-data)
+ [/greengrass/v2/logs にある aws.iot.SiteWiseEdgePublisher のログに「メインクラスが見つかりません、または読み込めませんでした」というエラーが表示される](#troubleshoot-java-issues)
+ [「SESSION\$1TAKEN\$1OVER」または「com.aws.greengrass.mqttclient.MqttClient: Spooler 経由でメッセージを発行できませんでした。再試行します。」 とログに表示されます。](#sa-troubleshoot-multiple-use)
+ [「com.aws.greengrass.deployment.IotJobsHelper: デプロイジョブが見つかりません。」 または「デプロイ結果は既に報告されています。」 とログに表示されます。](#sa-troubleshoot-reuse)
+ [OPC UA データソースのプロパティグループでタイムスタンプ設定を設定しようとすると、「SYNC\$1FAILED」ステータスが表示される](#troubleshoot-gateway-sync-failed-timestamp)
+ [変換されたデータ型が含まれません](#troubleshoot-data-conversion)
+ [トラストストアの問題](#troubleshoot-trust-stores)
+ [プロキシが有効なインストールの問題](#troubleshoot-proxy-during-installation)
### SiteWise Edge ゲートウェイにパックをデプロイできない
AWS IoT Greengrass nucleus コンポーネント (`aws.greengrass.Nucleus`) が古い場合、SiteWise Edge ゲートウェイにパックをデプロイできない可能性があります。 AWS IoT Greengrass V2 コンソールを使用して nucleus AWS IoT Greengrass コンポーネントをアップグレードできます。
**nucleus AWS IoT Greengrass コンポーネントをアップグレードするには (コンソール)**
1. [AWS IoT Greengrass コンソール](https://console.aws.amazon.com/greengrassIntro)に移動します。
1. ナビゲーションペインの **AWS IoT Greengrass** で、[**デプロイ**] を選択します。
1. **デプロイ**のリストで、修正するデプロイを選択します。
1. [**修正**] を選択します。
1. **[Specify target]** (ターゲットの指定) ページで **[Next]** (次へ) を選択します。
1. [**コンポーネントの選択**] ページの [**パブリックコンポーネント**] の検索ボックスに **aws.greengrass.Nucleus** と入力し、**aws.greengrass.Nucleus** を選択します。
1. [**次へ**] を選択します。
1. **[コンポーネントの設定**] ページで、[**次へ**] をクリックします。
1. [**詳細設定の設定**] ページで、[**次へ**] を選択します。
1. [**Review**] ページで、[**デプロイ**] を選択します。
### AWS IoT SiteWise は OPC UA サーバーからデータを受信しません
AWS IoT SiteWise アセットが OPC UA サーバーから送信されたデータを受信していない場合は、SiteWise Edge ゲートウェイのログを検索して問題をトラブルシューティングできます。次のメッセージを含む情報レベルの `swPublisher` ログを探します。
```
Emitting diagnostic name=PublishError.SomeException
```
ログの *SomeException* のタイプに基づいて、次の例外タイプとそれに対応する問題を使用して、SiteWise Edge ゲートウェイのトラブルシューティングを行います。
+ **ResourceNotFoundException** - OPC UA サーバーは、どのアセットのプロパティエイリアスにも一致しないデータを送信しています。この例外は、次の 2 つの場合に発生します。
+ プロパティエイリアスが、定義したソースプレフィックスを含め、OPC UA 変数と正確に一致しません。プロパティエイリアスとソースプレフィックスが正しいことを確認します。
+ OPC UA 変数をアセットプロパティにマッピングしていません。詳細については、「[のデータストリームを管理する AWS IoT SiteWise](manage-data-streams.md)」を参照してください。
必要なすべての OPC UA 変数を既にマッピングしている場合は AWS IoT SiteWise、SiteWise Edge ゲートウェイが送信する OPC UA 変数をフィルタリングできます。詳細については、「[SiteWise Edge で OPC UA ノードフィルターを使用する](opc-ua-node-filters.md)」を参照してください。
+ **InvalidRequestException** - OPC UA 変数のデータ型がアセットプロパティのデータ型に一致しません。例えば、OPC UA 変数が整数データ型の場合、対応するアセットプロパティは整数データ型である必要があります。倍精度型のアセットプロパティが OPC UA 整数値を受け取ることはできません。この問題を解決するには、正しいデータ型で新しいプロパティを定義します。
+ **TimestampOutOfRangeException** – SiteWise Edge ゲートウェイは、 が AWS IoT SiteWise 受け入れる範囲外のデータを送信しています。 は、過去 7 日より前、または今後 5 分より新しいタイムスタンプを持つデータポイント AWS IoT SiteWise を拒否します。SiteWise Edge ゲートウェイの電源または AWS クラウドへの接続が失われた場合は、SiteWise Edge ゲートウェイのキャッシュをクリアする必要がある場合があります。
+ **ThrottlingException** または **LimitExceededException** – リクエストが、取り込まれたデータポイントのレートやアセットプロパティデータ API オペレーションのリクエストレートなどの AWS IoT SiteWise サービスクォータを超えました。設定が [AWS IoT SiteWise クォータ](endpoints-and-quotas.md#quotas) を超えないことを確認します。
### ダッシュボードにデータが表示されない
ダッシュボードにデータが表示されない場合、SiteWise Edge ゲートウェイの **[パブリッシャー設定]** と ** データソース]** が同期していない可能性があります。同期していない場合、データソース名を変更すると、クラウドからエッジへの同期が速まり、非同期エラーが解決される場合があります。
**データソースの名前を更新するには**
1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/)に移動します。
1. ナビゲーションペインで、**[Edge ゲートウェイ]** を選択します。
1. ダッシュボードに接続された SiteWise Edge ゲートウェイを選択します。
1. [**データソース**] で [**編集**] を選択します。
1. 新しいソースの [**名前**] を選択し、[**保存**] を選択して変更を確定します。
1. **データソース**テーブルのデータソース名が更新されて、変更が反映されていることを確認します。
### /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 パブリッシャーパックをバージョン 2.4.1 またはそれ以降に更新する必要があります。Java バージョン 11.0.20.8.1 のみが影響を受けます。他の Java バージョンが使用されている環境では、そのまま古いバージョンの IoT SiteWise Publisher コンポーネントを使用できます。コンポーネントパックの更新の詳細については、「[SiteWise Edge ゲートウェイコンポーネントパックのバージョンを変更する](manage-gateways-ggv2.md#manage-gateway-update-packs)」を参照してください。
### 「SESSION\$1TAKEN\$1OVER」または「com.aws.greengrass.mqttclient.MqttClient: Spooler 経由でメッセージを発行できませんでした。再試行します。」 とログに表示されます。
`/greengrass/v2/logs/greengrass.log` のログに、`SESSION_TAKEN_OVER` を含む警告または `com.aws.greengrass.mqttclient.MqttClient: Failed to publish the message via Spooler and will retry.` を含むエラーが表示された場合は、複数のデバイス上の複数の SiteWise Edge ゲートウェイで同じ設定ファイルを使用しようとしている可能性があります。各 SiteWise Edge ゲートウェイには、 AWS アカウントに接続するための一意の設定ファイルが必要です。
### 「com.aws.greengrass.deployment.IotJobsHelper: デプロイジョブが見つかりません。」 または「デプロイ結果は既に報告されています。」 とログに表示されます。
`/greengrass/v2/logs/greengrass.log` のログに `com.aws.greengrass.deployment.IotJobsHelper: No deployment job found.` または `Deployment result already reported.` が表示される場合は、同じ設定ファイルを再利用しようとしている可能性があります。
以下のように複数の解決策があります。
+ 設定ファイルを再利用する場合は、次のようにします。
1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/)に移動します。
1. ナビゲーションペインで、**[Edge ゲートウェイ]** を選択します。
1. 再利用する SiteWise Edge ゲートウェイを選択します。
1. **[更新]** タブを選択します。
1. 別のパブリッシャーバージョンを選択し、**[デプロイ]** を選択します。
[Siemens Industrial Edge 用のゲートウェイを作成する](sa-create-config.md) のステップに従って、新しい設定ファイルを作成します。
### OPC UA データソースのプロパティグループでタイムスタンプ設定を設定しようとすると、「SYNC\$1FAILED」ステータスが表示される
バージョン 2.5.0 AWS IoT Greengrass で の OPC UA コレクターコンポーネント AWS IoT SiteWise を更新したときに、新しいタイムスタンプ設定オプションが導入されました。デバイスからのタイムスタンプ、またはサーバーからのタイムスタンプを使用できます。OPC UA コレクターコンポーネントの古いバージョンはこのオプションをサポートしておらず、同期に失敗します。
データソースの同期ステータスの失敗を解決するには、2 つの方法があります。推奨される方法は、IoT SiteWise OPC UA コレクターコンポーネントをバージョン 2.5.0 以降にアップグレードすることです。または、タイムスタンプを に設定した場合、古い OPC UA コレクターコンポーネントバージョンを引き続き使用できます`Source`。IoT SiteWise OPC UA コレクターコンポーネントをアップグレードする方法については、「」を参照してください[AWS IoT SiteWise コンポーネントのバージョンを更新する](manage-gateways-ggv2.md#update-component-version)。すべてのコンポーネントの最新バージョンを使用することをお勧めします。
**注記**
データソースの同期ステータスが失敗しても、データの中断はありません。ソースデータは引き続き流れます AWS IoT SiteWise。設定は、単に AWS IoT Greengrass V2 デプロイの IoT SiteWise OPC UA コレクターコンポーネントと同期していません。
**プロパティグループのタイムスタンプ設定を変更するには**
1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/)に移動します。
1. ナビゲーションペインで、**[Edge ゲートウェイ]** を選択します。
1. 編集するゲートウェイを選択します。
1. **データソース**セクションで、失敗した同期ステータスのデータソースを選択し、**編集**を選択します。
1. **詳細設定**を展開し、**グループ設定**を展開します。
1. **タイムスタンプ**で、**ソース**を選択します。**Source** を選択すると、設定から `timestampToReturn`プロパティが削除されます。この設定により、デフォルトでデバイスからのデータソースタイムスタンプの収集が可能になり、データソースは IoT SiteWise OPC UA コレクターコンポーネントと同期できます。
1. **[保存]** を選択します。
### 変換されたデータ型が含まれません
サポートされていない OPC UA データ型を の文字列に変換するときにエラーが表示される場合は AWS IoT SiteWise、いくつかの理由が考えられます。
+ 変換しようとしているデータ型は複雑なデータ型です。複雑なデータ型はサポートされていません。
+ **[送信先]** を **[Amazon S3 を使用してAWS IoT SiteWise バッファリング]**として使用する場合、完全な文字列値は Amazon S3 バケットにプッシュされたファイルに保持されます。後で にデータを取り込むと AWS IoT SiteWise、1024 バイトを超える文字列値はすべて拒否されます。
### トラストストアの問題
SiteWise Edge の信頼ストアに関連する問題が発生した場合は、次のトラブルシューティングステップを検討してください。
+ AWS IoT Greengrass ルート CA 証明書が存在し、適切な信頼ストアに正しくフォーマットされていることを確認します。
+ Java KeyStore パスワードが正しく設定され、SiteWise Edge コンポーネントにアクセスできることを確認します。
+ カスタム証明書 (HTTPS プロキシの場合など) が正しい形式 (通常は PEM) で、信頼ストアに正しくインポートされていることを確認します。
+ 信頼ストアに正しいファイルアクセス許可があり、SiteWise Edge プロセスにアクセスできることを確認します。
+ 信頼ストアの問題を示している可能性がある SSL/TLS 関連のエラーがないか SiteWise Edge ログを確認する
+ などのツールを使用して 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 ドキュメントの「[ログのダウンロード](https://docs.eu1.edge.siemens.cloud/build_a_device/device_building/concepts/howto-download-edge-device-logs.html)」を参照してください。
### データが に表示されない AWS IoT SiteWise
+ Databus ユーザーに問題がなく、**Databus\$1Configuration** のチェックマークアイコンが灰色ではなく緑色であることを確認します。
+ Secure Storage を含むバージョンで Siemens Industrial Edge Management を実行していない可能性があります。Siemens OS のバージョンをアップグレードします。詳細については、「[Siemens Secure Storage と AWS IoT SiteWise Edge アプリケーション](sitewise-edge-on-siemens.md#sa-secure-storage)」を参照してください。
### ログに「Config ファイル欠落 AWS\$1REGION」と表示される
Siemens ログに `Config file missing AWS_REGION` と表示される場合、設定ファイルの JSON が破損しています。新しい設定ファイルを作成する必要があります。[Siemens Industrial Edge 用のゲートウェイを作成する](sa-create-config.md) のステップに従って、新しい設定ファイルを作成します。
### Edge ゲートウェイ設定に「Out of sync」というエラーメッセージが表示される
デプロイの完了後にSiemens Industrial Edgeゲートウェイに`Out of sync`エラーメッセージが表示された場合は、IoT SiteWise パブリッシャーコンポーネントがゲートウェイと同期していないことを意味します。IoT SiteWise パブリッシャーコンポーネントはSiemens Industrial Edge、ゲートウェイでバックグラウンドで動作し、MQTT トピック機能を提供します。`iotsitewise:publisher:3` ではなく 機能名前空間を使用するようにSiemens Industrial Edgeゲートウェイをアップグレードしました`iotsitewise:publisher:2`。パブリッシャーの最新バージョンに更新して、この問題を解決できます。
**IoT SiteWise パブリッシャーの最新バージョンにアップグレードするには**
1. [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/)に移動します。
1. ナビゲーションペインで、**[Edge ゲートウェイ]** を選択します。
1. 編集するSiemens Industrial Edgeゲートウェイを選択します。
1. **Edge 機能**セクションで、**ソフトウェアバージョンの表示**を選択します。
1. パブリッシャードロップダウンメニューで IoT SiteWise **パブリッシャー**の最新バージョンを選択します。
1. **[Done]** (完了) をクリックします。
## Edge でのオープンソース統合のトラブルシューティング
このセクションでは、オープンソースツールを SiteWise Edge と統合するときに発生する可能性がある一般的な問題の解決策を示します。
**注記**
Node-RED®、InfluxDB®、Grafana® は SiteWise Edge のベンダーまたはサプライヤーではありません。
### 接続の問題
Node-RED が MQTT ブローカーに接続できない
指定されたポートで MQTT ブローカーが実行され、アクセス可能であることを確認します。ネットワーク設定を確認し、ブローカーアドレスが正しいことを確認します。
MQTT ブローカーのステータスを確認するには、以下を実行します。
```
docker ps | grep emqx
```
InfluxDB 接続エラー
認証トークンが有効であり、正しい組織名とバケット名を指定していることを確認します。InfluxDB が実行されており、アクセス可能であることを確認します。
InfluxDB のステータスを確認するには、以下を実行します。
```
curl -I http://localhost:8086
```
Grafana が InfluxDB に接続できない
URL、認証トークン、組織、バケットなど、Grafana の InfluxDB データソース設定が正しいことを確認します。
### データフローの問題
にデータが表示されない AWS IoT SiteWise
Node-RED フローのプロパティエイリアスが予想される形式と一致していることを確認します。MQTT トピック構造が正しく、SiteWise Edge ゲートウェイが MQTT ブローカーからデータを受信するように適切に設定されていることを確認します。
InfluxDB に保存されている SiteWise Edge データがない
Node-RED 保持フローが正しく設定され、InfluxDB ライターノードに適切なバケットと測定設定があることを確認します。Node-RED デバッグ出力にエラーがないか確認します。
データフォーマットエラー
データ変換関数が形式間でデータを正しく変換していることを確認します。Node-RED デバッグノードを使用して、フローの各段階でデータを検査します。
### パフォーマンスの問題
CPU またはメモリの使用率が高い
リソースの使用状況を監視し、必要に応じてコンポーネントの設定を調整します。データ収集頻度を減らすか、データフィルタリングを実装して処理負荷を減らすことを検討してください。
リソースの使用状況をモニタリングするには、以下を実行します。
```
docker stats
```
Grafana ダッシュボードのロードが遅い
InfluxDB クエリを最適化し、ダッシュボードパネルに時間範囲の制限を追加することを検討してください。適切な集計関数を使用して、表示されるデータポイントの数を減らします。
### ログ記録と診断
問題をトラブルシューティングするには、各コンポーネントのログを確認します。
Node-RED ログ
Node-RED コンソールでログを表示するか、以下を実行します。
```
docker logs node-red
```
InfluxDB ログ
以下を実行してログにアクセスします。
```
docker logs influxdb
```
Grafana ログ
以下を実行してログを表示します。
```
docker logs grafana
```
SiteWise Edge ログ
SiteWise Edge ゲートウェイログで MQTT 接続とデータ処理の問題を確認します。詳細については、「[SiteWise Edge ゲートウェイのトラブルシューティング](#troubleshooting-gateway)」を参照してください。
## AWS IoT Greengrass 問題のトラブルシューティング
SiteWise Edge ゲートウェイの設定またはデプロイに関する多くの問題の解決策については AWS IoT Greengrass、「 *AWS IoT Greengrass デベロッパーガイド*」の[「トラブルシューティング AWS IoT Greengrass](https://docs.aws.amazon.com/greengrass/v1/developerguide/gg-troubleshooting.html)」を参照してください。