IoT SiteWise OPC UA コレクター - AWS IoT Greengrass

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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.5.x

  • 2.4.x

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

Type

このコンポーネントはジェネリックコンポーネント (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 コアデバイスは、OPCUA サーバーへのアウトバウンドネットワーク接続を許可する必要があります。

依存関係

コンポーネントをデプロイすると、 はその依存関係の互換性のあるバージョン 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 IoT SiteWise OPC UA コレクターコンポーネントを設定できます。詳細については、「AWS IoT SiteWise  ユーザーガイド」の「ステップ 4: データソースを追加する - オプション」を参照してください。

入力データ

このコンポーネントは、次の形式のデータのみを受け入れ、他のすべてのデータは無視され、破棄されます。次の表は、OPCUA データ型を SiteWise 同等のデータ型にマッピングしたものです。

SiteWise データ型

OPC UA データ型

説明

STRING

String

Guid

XmlElement

最大長 1024 バイトの文字列。

INTEGER

SByte

Byte

Int16

UInt16

Int32

UInt32*

Int64*

-2,147,483,648 to 2,147,483,647 からの範囲の符号付き 32 ビット整数。

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」を参照してください。

ローカルログファイル

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

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

    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 または を AWS IoT Greengrass ルートフォルダへのパスC:\greengrass\v2に置き換えます。

Linux
/greengrass/v2/work/aws.iot.SiteWiseEdgeCollectorOpcua/logs/IotSiteWiseOpcUaCollectorEvents.log
Windows
C:\greengrass\v2\work\aws.iot.SiteWiseEdgeCollectorOpcua\logs\IotSiteWiseOpcUaCollectorEvents.log

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

  • 重要度レベル

  • Timestamp

  • イベント固有の追加情報

例 ログの例
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.5.1
バグ修正と機能向上
  • スナップショットタスクの実行中にエラーが発生した場合に、今後のスナップショットタスクがキャンセルされるバグを修正しました。

  • データソースの OPC UA OPCサーバーへの接続が失われた場合に、UA コレクターを再起動するまでデータソース設定の更新が保持されないバグを修正しました。

2.5.0
新機能
  • 単純な配列と DateTime 値を文字列に変換するデータソースオプションを追加します。

  • OPC UA サーバーからデータを収集するときに、ソースまたはサーバーのタイムスタンプを選択するプロパティグループオプションを追加します。

バグ修正と機能向上
  • ソースタイムスタンプを使用するようにデフォルトのポーリング設定がリセットされました。

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プロキシ設定のサポートを追加しました。

バグ修正と機能向上

2.2.0

新機能
  • Linux ARMv8アーキテクチャに Data Collection Pack をインストールするためのサポートを追加しました。

  • Linux の最小要件ARMv8:

    • メモリ: 4 GB

    • CPU: ARM Cortex-A72 または同等の仕様

バグ修正と機能向上
  • ノード検出プロセスにおけるメトリクスのログ記録を改善します。

  • サポートされていないデータ型の処理を改善します。

  • データストリームエラーのログ記録を改善します。

2.1.3

新機能
  • Windows Server 2019 以降のサポートを追加。

バグ修正と機能向上
  • サポートされていないデバイスにこのコンポーネントをデプロイするときのエラーメッセージが改善。

2.1.1

新機能
  • 以下のサブスクリプションプロパティの設定のサポートが追加されました。

    • DataChangeTrigger ‐ データ変更アラートを開始する条件を定義できます。

    • QueueSize ‐ モニタリング対象項目の通知がキューに入れられる特定のメトリクスの OPC‐UA サーバー上のキューの深さ。

    • PublishingIntervalMilliseconds - サブスクリプションの作成時に指定された発行サイクルの間隔 (ミリ秒単位)。

    • SnapshotFrequencyMilliseconds ‐ Edge が安定したデータストリームを取り AWS IoT SiteWise 込むように、スナップショット頻度タイムアウト設定を構成できます。

  • このバージョンは BAD 品質データの取り込みをサポートし、以下のデータ品質に基づいてデータをフィルタリングします。

    • UNCERTAIN 品質データ

    • BAD 品質データ

バグ修正と機能向上
  • 顧客メトリクスの改善。

  • 暗号化を有効にしてサーバーに接続するときに問題が発生することがあるセキュリティエンコーディングを修正しました。

  • プロパティグループの更新に失敗する問題を修正しました。

2.0.3

バグ修正と機能向上。

2.0.2

エッジとのアセット優先度同期のバグ修正と機能向上。

2.0.1

当初のバージョン

関連情報