バージョン Type オペレーティングシステム要件依存関係設定ローカルログファイルライセンス変更ログ関連情報

IoT SiteWise プロセッサ

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

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

バージョン

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

3.5.x
3.4.x
3.3.x
3.2.x
3.1.x
3.0.x
2.2.x
2.1.x
2.0.x

Type

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

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

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

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

Linux
Windows

要件

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

Greengrass コアデバイスは、次のいずれかのプラットフォームで実行する必要があります。
- os: Ubuntu 20.04 または 18.04
  
  アーキテクチャ: x86_64 (AMD64）
- os: Red Hat Enterprise Linux (RHEL) 8
  
  アーキテクチャ: x86_64 (AMD64）
- os: Amazon Linux 2
  
  アーキテクチャ: 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 のリファレンス」を参照してください。

設定

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

ローカルログファイル

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

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

コアデバイスに次のコマンドを実行して、このコンポーネントのログファイルをリアルタイムに確認します。/greengrass/v2 またはを AWS IoT Greengrass ルートフォルダへのパスC:\greengrass\v2に置き換えます。
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.0GCC-例外あり
パブリックドメイン
Python-2.0
Unicode-DFS2015
BSD-1-Clause
SSL を開きます。
EPL-1.0
EPL-2.0
GPL-2.0-with-classpath-exception
MPL-2.0
CC0-1.0
JSON

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

変更ログ

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

バージョン	変更
3.5.1	バグ修正と機能向上潜在的なセキュリティの脆弱性に対応するために依存関係を更新しました。
3.4.0	新機能カスタム証明書を必要とするHTTPSプロキシサーバーを介したゲートウェイ通信を可能にするオプションの HTTPおよびプロキシサポートが追加されました。 AWS IoT Greengrass コアの HTTPプロキシの設定の詳細については、「」を参照してくださいポート 443 での接続またはネットワークプロキシを通じた接続。 SiteWise Edge に固有のプロキシサポートの詳細については、「 AWS IoT SiteWise ユーザーガイド」のAWS IoT SiteWise 「 Edge プロキシサポートの信頼ストアの管理」を参照してください。 AWS OpsHub および SiteWise Edge の非アクティブ期間を管理するための設定可能なセッションタイムアウト設定を追加しましたAPIs。詳細については、「 AWS IoT SiteWise ユーザーガイド」のAWS IoT SiteWise 「 Edge のセッションタイムアウトを設定する」を参照してください。フォーマンスの向上受信データがエッジデバイスストレージに到達する時間を 5 秒から 1 秒未満に短縮しました。データアップロードのレイテンシーは AWS IoT SiteWise 変更されません。
3.3.1	新機能 SiteWise Edge にオプションCORSのサポートを追加しAPIs、クロスオリジンリソース共有機能を強化しました。この機能により、とやり取りするウェブアプリケーションの柔軟性が向上しますAPIs。
3.3.0	フォーマンスの向上新しいアセットまたは更新されたアセットのエントリのみを更新することで、 AWS IoT SiteWise アセット同期間の I/O 使用量を減らすようにキャッシュ更新メカニズムを最適化しました。多数の同期アセットプロパティを持つキャッシュを維持するためのメモリフットプリントを削減しました。バグ修正と機能向上インジェストエラーがない場合に個々のプロパティ値を取り込むログが抑制されるため、取り込みレートが高いときのログノイズが軽減されます。特定のログエントリに人間が読み取り可能なフォーマットを使用することで、ログの読みやすさが向上しました。 Java 17 以降のサポートを追加しました。
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 は、このコンポーネントが正しく実行されるために使用できなくなりました。注記 APIsなどの AWS IoT SiteWise データプレーンのローカルエンドポイントが `get-asset-property-value`からに変更されています`http://localhost:8081http://localhost:11080/data`。APIsなどの AWS IoT SiteWise コントロールプレーンのローカルエンドポイントは`list-asset-models`、から `http://localhost:11080` に変更されています`http://localhost:11080/control`。 AWS 常に、 SiteWise Edge ゲートウェイHTTPSエンドポイントを使用することをお勧めします。これらのエンドポイントは変更されていません。バグ修正と機能向上からの同期 AWS IoT SiteWise は、前回の同期が中断された場合にリソースを有効な状態に移行するようになりました。これにより、強制再起動後に一部のリソースが破損する問題が修正されました。同期中にリソースが変更された場合、エッジでリソースが破損するまれな状態を修正しました。この条件が検出されると同期が失敗し、リソースは次の同期で再試行されます。のHTTPエンドポイントを外部APIsから呼び出すことを許可していた可能性がある問題を修正しました。ローカルループバックアドレスのAPIs外部でを呼び出すためにのみHTTPS使用できます。 `ListAssets` API エッジに保存されているアセットのアセット階層が表示されるようになりました。 Data Processing Pack が Windows での再起動、アップグレード、またはダウングレードに失敗した問題を修正しました。お客様が認証情報を使用して MQTT ブローカーに接続できない Windows OS 用データ処理パックのバグを修正しました。
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その機能をプロセスに移動して、通信するプロセスからのリソース使用量を減らします。の最大結果制限を 20,000 `get-asset-property-value-history`APIに引き上げて、が使用する制限に一致させます 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()`コアデバイスで計算する変換で関数のサポートを追加します。このコンポーネントが認証のために Lightweight Directory Access Protocol (LDAP) 設定を保存するパスを変更します。
2.0.2	当初のバージョン