IoT SiteWise プロセッサ - AWS IoT Greengrass
バージョンタイプオペレーティングシステム要件依存関係構成ローカルログファイルライセンス変更ログ以下も参照してください。

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

IoT SiteWise プロセッサ

IoT SiteWise プロセッサコンポーネント (aws.iot.SiteWiseEdgeProcessor) を使用すると、 AWS IoT SiteWise ゲートウェイはエッジでデータを処理できます。

このコンポーネントを使用すると、 AWS IoT SiteWise ゲートウェイはアセットモデルとアセットを使用してゲートウェイデバイスのデータを処理できます。 AWS IoT SiteWise ゲートウェイの詳細については、「 AWS IoT SiteWise ユーザーガイド」の「エッジ AWS IoT SiteWise での の使用」を参照してください。

バージョン

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

  • 3.2.x

  • 3.1.x

  • 3.0.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

タイプ

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

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

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

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

  • Linux

  • Windows

要件

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

  • Greengrass コアデバイスは、次のいずれかのプラットフォームで実行する必要があります。

    • OS: Ubuntu 20.04 または 18.04

      Architecture: x86_64 (AMD64)

    • OS: Red Hat Enterprise Linux (RHEL) 8

      Architecture: x86_64 (AMD64)

    • OS: Amazon Linux 2

      Architecture: x86_64 (AMD64)

    • OS: Windows Server 2019 以降

      アーキテクチャ: x86_64 (AMD64)

  • Greengrass コアデバイスは、ポート 443 のインバウンドトラフィックを許可する必要があります。

  • Greengrass コアデバイスは、ポート 443 と 8883 のアウトバウンドトラフィックを許可する必要があります。

  • 次のポートは、 での使用のために予約されています AWS IoT SiteWise: 80、443、3001、4569、4572、8000、8081、8082、8084、8085、8086、8445、9000、9500、11080、および 50010。トラフィック用の予約ポートを使用すると、接続が切断されることがあります。

    注記

    ポート 8087 が必要になるのは、このコンポーネントのバージョン 2.0.15 以降のみです。

  • Greengrass デバイスロールには、 AWS IoT Greengrass V2 デバイスで AWS IoT SiteWise ゲートウェイを使用できるようにするアクセス許可が必要です。詳細については、「AWS IoT SiteWise ユーザーガイド」の「要件」を参照してください。

エンドポイントおよびポート

このコンポーネントは、基本的な操作に必要なエンドポイントとポートに加えて、次のエンドポイントとポートに対し、アウトバウンドリクエストを実行できる必要があります。詳細については、「プロキシまたはファイアウォールを介したデバイストラフィックを許可する」を参照してください。

エンドポイント [ポート] 必要 説明

model.iotsitewise.region.amazonaws.com

 443 はい

AWS IoT SiteWise アセットとアセットモデルに関する情報を取得します。

edge.iotsitewise.region.amazonaws.com

 443 はい

コアデバイスの AWS IoT SiteWise ゲートウェイ設定に関する情報を取得します。

ecr.region.amazonaws.com

 443 はい

Amazon Elastic Container Registry から AWS IoT SiteWise Edge Gateway Docker イメージをダウンロードします。

iot.region.amazonaws.com

 443 はい

AWS アカウントのデバイスエンドポイントを取得します。

sts.region.amazonaws.com

 443 はい

の ID を取得します AWS アカウント。

monitor.iotsitewise.region.amazonaws.com

 443 いいえ

コアデバイスの AWS IoT SiteWise Monitor ポータルにアクセスする場合に必要です。

依存関係

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

次の表に、このコンポーネントのバージョン 2.0.x から 2.1.x までの依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
トークン交換サービス >=2.0.3 <3.0.0 ハード
ストリームマネージャー >=2.0.10 <3.0.0 ハード
Greengrass CLI >=2.3.0 <3.0.0 ハード

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

構成

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

ローカルログファイル

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

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgeProcessor.log
Windows
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.log
このコンポーネントのログを確認するには

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

    Linux
    sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgeProcessor.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.log -Tail 10 -Wait

ライセンス

このコンポーネントには、次のサードパーティーソフトウェア/ライセンス品が含まれています。

  • Apache-2.0

  • MIT

  • BSD-2-Clause

  • BSD-3-Clause

  • CDDL-1.0

  • CDDL-1.1

  • ISC

  • Zlib

  • GPL-3.0-with-GCC-exception

  • パブリックドメイン

  • Python-2.0

  • Unicode-DFS-2015

  • BSD-1-Clause

  • OpenSSL

  • EPL-1.0

  • EPL-2.0

  • GPL-2.0-with-classpath-exception

  • MPL-2.0

  • CC0-1.0

  • JSON

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

変更ログ

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

バージョン

変更

3.2.1
バグ修正と機能向上

  • AWS IoT SiteWise API コールが SiteWise Edge と同期的にページ分割されない問題を修正しました。

  • MessageRemaining.SiteWise_Edge_Stream メトリクスを公開しないように問題を修正しました。

  • MQTT ブローカーとの接続をモニタリングするために、次の CloudWatch メトリクスを追加しました。

    • IoTSiteWiseProcessor.IsConnectedToMqttBroker

    • IoTSiteWiseProcessor.NumberOfSubscriptionsToMqttBroker

    • IoTSiteWiseProcessor.NumberOfUniqueMqttTopicsReceived

    • IoTSiteWiseProcessor.MqttMessageReceivedSuccessCount

    • IoTSiteWiseProcessor.MqttReceivedSuccessBytes

    これらのメトリクスの詳細については、AWS IoT Greengrass Version 2 「ゲートウェイメトリクス」を参照してください。

3.2.0
フォーマンスの改善

  • API サービスを最適化してメモリフットプリントを小さくし、インストールに必要なディスク容量を少なくする

    • これにより、コンポーネント全体の初期メモリ使用量が 2 GB 削減され (現在は起動時に 7.5 GB のメモリを使用していますが、16 GB が推奨されます）、ダウンロードサイズが 500 MB 削減されます (現在は 1.4 GB のダウンロードが必要です）。

新機能

  • GetAssetPropertyValueAggregates API は、エッジで 15 分間の集約ウィンドウをサポートするようになりました。

  • ポート 8081 および 8082 は、このコンポーネントを正しく実行するために使用できなくなりました。

    注記

    などの AWS IoT SiteWise データプレーン APIsローカルエンドポイントが get-asset-property-valueから に変更されていますhttp://localhost:8081http://localhost:11080/data。などの AWS IoT SiteWise コントロールプレーン APIs のローカルエンドポイントはlist-asset-models、 から http://localhost:11080 に変更されていますhttp://localhost:11080/control。 AWS 常に、 SiteWise エッジゲートウェイの HTTPS エンドポイントを使用することをお勧めします。これらのエンドポイントは変更されていません。

バグ修正と機能向上

  • からの同期は AWS IoT SiteWise 、以前の同期が中断された場合にリソースを有効な状態に移行するようになりました。これにより、強制再起動後に一部のリソースが破損する問題が修正されます。

  • 同期中にリソースが変更されると、エッジでリソースが破損するまれな状態を修正しました。この条件が検出されると同期が失敗し、リソースは次の同期で再試行されます。

  • APIsから呼び出せる問題を修正しました。HTTPS のみを使用して、ローカルループバックアドレスの外部で APIsを呼び出すことができます。

  • ListAssets API は、エッジに保存されているアセットのアセット階層を表示するようになりました。

  • Data Processing Pack が Windows で再起動、アップグレード、またはダウングレードに失敗する問題を修正しました。

  • お客様が認証情報を使用して MQTT ブローカーに接続できない Windows OS 用 Data Processing Pack のバグを修正しました。

3.1.3
バグ修正と機能向上

  • 一部のリソースが実際に失敗したときに、Data Processing Pack が同期の成功を誤って報告する問題を修正しました。

  • 親が同じでない限り、複数のアセットに同じ名前を付けることができます。

3.1.1
バグ修正と機能向上

  • タイムゾーンの不一致により SigV4 リクエストが失敗する問題を修正しました。

  • 再起動後に属性に依存すると、変換プロパティとメトリクスプロパティが計算を停止する問題を修正しました。

  • カスタム Stream Manager ポート設定のサポートを有効にします。

  • エッジに同期されたプロパティの更新が停止する場合がある問題を修正しました。

3.1.0
バグ修正と機能向上

  • ListAssetModels API が次のトークンを生成できない問題を修正しました。

3.0.0
新機能

  • MQTT ブローカーからのデータ取り込みのサポートを有効にします。

2.2.1
バグ修正と機能向上

  • コントロールプレーンのデータストレージとクラウドの運用方法の一貫性を高めるために、同期プロセスを調整します。これはアップグレードに若干影響します。

    注記

    バージョン 2.2.1 以降で同期されたコントロールプレーンデータは、以前のバージョンと互換性がありません。以前のバージョンにダウングレードするには、新規インストールを完了する必要があります。これはアップグレードには影響しません。以前のバージョンで同期されたデータはバージョン 2.2.1 で動作します。

  • AWS 認証情報チェーンに追加の変更を加え、 AWS IoT Greengrass V2 認証情報に優先順位を付けます。

2.1.37
バグ修正と機能向上

  • dependency-routing-service プロセスを非推奨にし、その機能を property-state-service プロセスに移動して、通信するプロセスからのリソース使用量を減らします。

  • API の結果の上限を 20,000 get-asset-property-value-historyに引き上げて、 で使用される制限に一致させます AWS IoT SiteWise。

  • 結果の上限が指定されていない場合、ページ分割された結果で get-asset-property-value-history API のトークンが提供されない問題を修正しました。

2.1.35
バグ修正と機能向上

  • AWS 認証情報チェーンを変更して、認証情報に優先順位 AWS IoT Greengrass を付けます。

  • AWS IoT  Thing グループの一部としてデプロイするときのアカウント検出の問題を修正しました。

2.1.34
バグ修正と機能向上

  • Linux でマルチスレッドを使用するようにメトリック/トランスフォームの計算を調整しました。Windows では、互換性の観点から、引き続きシングルスレッドの計算を実行します。

  • 一部の計算ウィンドウでメトリック計算が欠落する問題を修正しました。

2.1.33
バグ修正と機能向上

  • Greengrass コンソールへのエラー状態のレポートに関する問題を修正しました。

2.1.32
バグ修正と機能向上

  • カスタマイズされたユーザー名とグループのサポートを追加します。

2.1.31
バグ修正と機能向上

  • AWS IoT SiteWiseでモデル化されたデータについて、時間加重平均と時間加重標準偏差を計算するためのサポートを追加しました。

2.1.29
バグ修正と機能向上

  • エッジ機能でアセットをフィルタリングするためのサポートを追加します。

2.1.28
バグ修正と機能向上

  • リソースの同期を最適化して、多数のアセットを からエッジ AWS クラウド に同期できるようにします。

2.1.24
バグ修正と機能向上

  • 2 回目の同期時にダッシュボードが非表示になる問題を修正しました。

2.1.23
バグ修正と機能向上

  • インターネット接続が遅い場合にインストールが失敗しないように、aws.iot.SiteWiseEdgeProcessor インストールプロセスのタイムアウトを追加しました。

  • クラウドとエッジ間の同期効率を向上させるためにリソース同期を最適化しました。

2.1.21
警告

2.0.x から 2.1.x にアップグレードすると、ローカルデータが失われます。

新機能

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

  • Linux ベースのオペレーティングシステムの Docker を削除。

2.0.16

このバージョンには、バグ修正と機能向上が含まれています。

2.0.15
バグ修正と機能向上

  • このコンポーネントがリソース同期 API オペレーションに使用するポートを 8085 から 8087 に変更。その結果、このコンポーネントではポート 8087 を利用可能にする必要があります。このコンポーネントには、ポート 8085 が利用可能であることも依然として必要です。

  • AWS OpsHub 認証を更新して、ユーザーが API オペレーションを呼び出そうとするのではなく、ログイン中に権限のないユーザーを拒否します。

2.0.14

このバージョンには、バグ修正と機能向上が含まれています。

2.0.13
バグ修正と機能向上

  • このコンポーネントが Amazon CloudWatch メトリクスにデータをレポートするときに、どのデータがモデル化されていないかが正しく示されるように問題を修正しました。

2.0.9
バグ修正と機能向上

  • コアデバイスで AWS IoT SiteWise リソースを作成および更新する信頼性が向上しました。

  • コアデバイスにインストールされているコンポーネント、各コンポーネントのバージョン、および各コンポーネントのステータスを監視するために使用できるローカル API オペレーションを追加します。この情報は、コアデバイスの AWS OpsHub アプリケーションの AWS IoT SiteWise の設定タブで確認できます。

  • このコンポーネントが実行する Docker コンテナのヘルスステータスを追加します。docker ps コマンドを実行すると、コンテナのヘルスステータスを表示できます。

2.0.7
バグ修正と機能向上

  • コアデバイスで AWS IoT SiteWise Monitor ポータルを表示するためのサポートを修正しました。

2.0.6
バグ修正と機能向上

  • このコンポーネントがコアデバイスで計算する AWS IoT SiteWise statetime()、earliest()、および latest()関数を修正しました。

2.0.5
バグ修正と機能向上

  • このコンポーネントが AWS IoT SiteWise pretrigger()コアデバイスで計算する変換で 関数のサポートが追加されました。

  • このコンポーネントが認証用の LDAP (ライトウェイトディレクトリアクセスプロトコル) 設定を格納するパスを変更します。

2.0.2

当初のバージョン

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