バージョンタイプオペレーティングシステム要件依存関係構成入力データ出力データローカルログファイルトラブルシューティングとデバッグライセンス変更ログ以下も参照してください。

IoT SiteWise OPC-UA コレクター

IoT SiteWise OPC-UA コレクターコンポーネント (aws.iot.SiteWiseEdgeCollectorOpcua) を使用すると、 AWS IoT SiteWise ゲートウェイはローカル OPC-UA サーバーからデータを収集できます。

このコンポーネントを使用すると、 AWS IoT SiteWise ゲートウェイは複数の OPC-UA サーバーに接続できます。 AWS IoT SiteWise ゲートウェイの詳細については、「 AWS IoT SiteWise ユーザーガイド」の「エッジ AWS IoT SiteWise でのの使用」を参照してください。

バージョン

このコンポーネントには、次のバージョンがあります。

2.4.x
2.3.x
2.2.x
2.1.x
2.0.x

タイプ

このコンポーネントはジェネリックコンポーネント (aws.greengrass.generic) です。Greengrass nucleus は、コンポーネントのライフサイクルスクリプトを実行します。

詳細については、「コンポーネントタイプ」を参照してください。

オペレーティングシステム

このコンポーネントは、次のオペレーティングシステムを実行するコアデバイスにインストールできます。

Linux
Windows

要件

このコンポーネントには次の要件があります。

Greengrass コアデバイスは、次のいずれかのプラットフォームで実行する必要があります。
- OS: Ubuntu 18.04 以降
  
  アーキテクチャ: x86_64 (AMD64) または ARMv8 (Aarch64)
- OS: Red Hat Enterprise Linux (RHEL) 8
  
  アーキテクチャ: x86_64 (AMD64) または ARMv8 (Aarch64)
- OS: Amazon Linux 2
  
  アーキテクチャ: x86_64 (AMD64) または ARMv8 (Aarch64)
- OS: Debian 11
  
  アーキテクチャ: x86_64 (AMD64) または ARMv8 (Aarch64)
- OS: Windows Server 2019 以降
  
  アーキテクチャ: x86_64 (AMD64)
Greengrass コアデバイスは、OPC-UA サーバーへのアウトバウンドネットワーク接続を許可する必要があります。

依存関係

コンポーネントをデプロイすると、はその依存関係の互換性のあるバージョン AWS IoT Greengrass もデプロイします。つまり、コンポーネントを正常にデプロイするには、コンポーネントとその依存関係のすべての要件を満たす必要があります。このセクションでは、このコンポーネントのリリースされたバージョンの依存関係と、各依存関係に対するコンポーネントのバージョンを定義するセマンティックバージョン制約をリスト表示しています。コンポーネントの各バージョンの依存関係は、AWS IoT Greengrass コンソールでも確認できます。コンポーネントの詳細ページで [Dependencies] (依存関係) リストを確認します。

次の表では、このコンポーネントのすべてのバージョンの依存関係を一覧表示します。

依存関係	互換性のあるバージョン	依存関係タイプ
Greengrass nucleus	>=2.3.0 <3.0.0	ハード
ストリームマネージャー	>2.0.10<3.0.0	ハード
シークレットマネージャー	>=2.0.8 <3.0.0	ハード

コンポーネントの依存関係の詳細については、「コンポーネント recipe のリファレンス」を参照してください。

構成

このコンポーネントに設定パラメータはありません。

AWS IoT SiteWise コンソールまたは API を使用して IoT OPC-UA IoT SiteWise コレクターコンポーネントを設定できます。詳細については、「AWS IoT SiteWise ユーザーガイド」の「ステップ 4: データソースを追加する - オプション」を参照してください。

入力データ

このコンポーネントは、次の形式のデータのみを受け入れ、それ以外はすべて無視されて破棄されます。次の表は、OPC UA データ型を同等のデータ型にマッピングしています SiteWise。

SiteWise データ型	OPC UA データ型	説明
`STRING`	`String` `Guid` `XmlElement`	最大長 1024 バイトの文字列。
`INTEGER`	`SByte` `Byte` `Int16` `UInt16` `Int32` `UInt32`* `Int64`*	からの範囲の符号付き 32 `-2,147,483,648 to 2,147,483,647` ビット整数。
`DOUBLE`	`UInt32`* `Int64`* `Float` `Double`	の範囲が `–10^100 to 10^100`と`IEEE 754`倍精度の浮動小数点数。
`BOOLEAN`	`Boolean`	`true`-または-`false`

* OPC UA データ型 UInt32およびではInt64、 SiteWise がその値を表すことができるINTEGER場合、その SiteWise データ型はになります。それ以外の場合はになりますDOUBLE。

出力データ

このコンポーネントは、 AWS IoT Greengrass ストリームマネージャーにBatchPutAssetPropertyValueメッセージを書き込みます。詳細については、AWS IoT SiteWise API リファレンスの BatchPutAssetPropertyValue を参照してください。

ローカルログファイル

このコンポーネントは次のログファイルを使用します。

このコンポーネントのログを確認するには

コアデバイスに次のコマンドを実行して、このコンポーネントのログファイルをリアルタイムに確認します。/greengrass/v2 または C:\greengrass\v2 を AWS IoT Greengrass ルートフォルダへのパスに置き換えます。
Linux
```
sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgeCollectorOpcua.log
```
Windows (PowerShell)
```
Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeCollectorOpcua.log -Tail 10 -Wait
```

トラブルシューティングとデバッグ

このコンポーネントには、お客様が問題を特定して解決するのに役立つ新しいイベントログが含まれています。ログファイルはローカルログファイルとは別のもので、次の場所にあります。/greengrass/v2 または C:\greengrass\v2 を AWS IoT Greengrass ルートフォルダへのパスに置き換えます。

このログには、詳細情報とトラブルシューティングの手順が含まれています。トラブルシューティングに関する情報は診断結果とともに提供され、問題の解決方法の説明と、場合によっては詳細情報へのリンクが含まれます。診断情報には次のものが含まれます。

重要度レベル
タイムスタンプ
イベント固有の追加情報

例ログの例


dataSourceConnectionSuccess:
  Summary: Successfully connected to OpcUa server
  Level: INFO
  Timestamp: '2023-06-15T21:04:16.303Z'
  Description: Successfully connected to the data source.
  AssociatedMetrics:
  - Name: FetchedDataStreams
    Description: The number of fetched data streams for this data source
    Value: 1.0
    Namespace: IoTSiteWise
    Dimensions:
    - Name: SourceName
      Value: SourceName{value=OPC-UA Server}
    - Name: ThingName
      Value: test-core
  AssociatedData:
  - Name: DataSourceTrace
    Description: Name of the data source
    Data:
    - OPC-UA Server
  - Name: EndpointUri
    Description: The endpoint to which the connection was attempted.
    Data:
    - '"opc.tcp://10.0.0.1:1234"'

ライセンス

このコンポーネントは、Greengrass Core ソフトウェアライセンス契約に従ってリリースされています。

変更ログ

次の表は、コンポーネントの各バージョンにおける変更を示します。

バージョン	変更
2.4.2	バグ修正と機能向上 OPC UA サーバーの検出中にノードが複数回検出される可能性がある問題を修正しました。スナップショットデータポイントごとにタイムスタンプが新しくなるようにスナップショット機能を修正しました。
2.4.1	バグ修正と機能向上プロキシサポートに関連する問題を修正しました。スレッドのクリーンアップが失敗し、データブロックが発生する問題を修正しました。
2.4.0	新機能イベントログを追加して、問題の特定と修正を容易にしています。バグ修正と機能向上 OPC-UA の仕様のバージョン 1.05 を使用する OPC-UA サーバーに接続する際に証明書エラーを引き起こす OPC-UA クライアントの問題を修正します。
2.3.0	新機能 Linux での Greengrass nucleus の HTTP プロキシ設定サポートを追加します。バグ修正と機能向上セキュリティ上の問題を修正します (CVE-2019-19135)。
2.2.0	新機能 Linux ARMv8 アーキテクチャにデータコレクションパックをインストールするためのサポートを追加します。 Linux ARMv8 の最小要件: メモリ: 4 GB CPU: ARM Cortex-A72 または同等の仕様バグ修正と機能向上ノード検出プロセスにおけるメトリクスのログ記録を改善します。サポートされていないデータ型の処理を改善します。データストリームエラーのログ記録を改善します。
2.1.3	新機能 Windows Server 2019 以降のサポートを追加。バグ修正と機能向上サポートされていないデバイスにこのコンポーネントをデプロイするときのエラーメッセージが改善。
2.1.1	新機能次のサブスクリプションプロパティの設定のサポートが追加されました。 DataChangeTrigger ‐ データ変更アラートを開始する条件を定義できます。 QueueSize - モニタリング対象アイテムの通知がキューに入れられる特定のメトリクスの OPC‐UA サーバー上のキューの深さ。 PublishingIntervalMilliseconds ‐ サブスクリプションの作成時に指定された発行サイクルの間隔 (ミリ秒単位）。 SnapshotFrequencyMilliseconds ‐ AWS IoT SiteWise エッジが安定したデータストリームを取り込むように、スナップショットの頻度タイムアウト設定を構成できます。このバージョンは `BAD` 品質データの取り込みをサポートし、以下のデータ品質に基づいてデータをフィルタリングします。 `UNCERTAIN` 品質データ `BAD` 品質データバグ修正と機能向上顧客メトリクスの改善。暗号化を有効にしてサーバーに接続するときに問題が発生することがあるセキュリティエンコーディングを修正しました。プロパティグループの更新に失敗する問題を修正しました。
2.0.3	バグ修正と機能向上。
2.0.2	エッジとのアセット優先度同期のバグ修正と機能向上。
2.0.1	当初のバージョン

以下も参照してください。

「ユーザーガイド」の「 AWS IoT SiteWiseとは」。 AWS IoT SiteWise

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

トークン交換サービス

IoT SiteWise OPC-UA データソースシミュレーター