翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# IoT SiteWise プロセッサ
IoT SiteWise プロセッサコンポーネント (`aws.iot.SiteWiseEdgeProcessor`) を使用すると、 AWS IoT SiteWise Classic ストリーム、V2 ゲートウェイがエッジでデータを処理できます。
このコンポーネントを使用すると、 AWS IoT SiteWise ゲートウェイはアセットモデルとアセットを使用してゲートウェイデバイスのデータを処理できます。 AWS IoT SiteWise ゲートウェイの詳細については、「 *AWS IoT SiteWise ユーザーガイド*」の[「エッジ AWS IoT SiteWise での の使用](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways-ggv2.html)」を参照してください。
**注記**
データ処理パック (DPP) 機能は、2025 年 11 月 7 日以降、新規のお客様には提供されなくなります。DPP を使用する場合は、その日付より前にサインアップします。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「*AWS IoT SiteWise ユーザーガイド*」の「[AWS IoT SiteWise Monitor 可用性の変更](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-dpp-availability-change.html)」を参照してください。
**Topics**
+ [バージョン](#iotsitewise-processor-component-versions)
+ [タイプ](#iotsitewise-processor-component-type)
+ [オペレーティングシステム](#iotsitewise-processor-component-os-support)
+ [要件](#iotsitewise-processor-component-requirements)
+ [依存関係](#iotsitewise-processor-component-dependencies)
+ [設定](#iotsitewise-processor-component-configuration)
+ [ローカルログファイル](#iotsitewise-processor-component-log-file)
+ [ライセンス](#iotsitewise-processor-component-licenses)
+ [変更ログ](#iotsitewise-processor-component-changelog)
+ [関連情報](#iotsitewise-processor-component-see-also)
## バージョン
このコンポーネントには、次のバージョンがあります。
+ 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
## タイプ
このコンポーネントはジェネリックコンポーネント (`aws.greengrass.generic`) です。[Greengrass nucleus](greengrass-nucleus-component.md) は、コンポーネントのライフサイクルスクリプトを実行します。
詳細については、「[コンポーネントタイプ](develop-greengrass-components.md#component-types)」を参照してください。
## オペレーティングシステム
このコンポーネントは、次のオペレーティングシステムを実行するコアデバイスにインストールできます。
+ Linux
+ Windows
## 要件
このコンポーネントには次の要件があります。
+ Greengrass コアデバイスは、次のいずれかのプラットフォームで実行する必要があります。
+ OS: Ubuntu 20.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)
+ OS: Debian 11 (Bullseye) 以降
アーキテクチャ: 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 デバイスロール](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-service-role.html)には、 AWS IoT Greengrass V2 デバイスで AWS IoT SiteWise ゲートウェイを使用できるようにするアクセス許可が必要です。詳細については、「*AWS IoT SiteWise ユーザーガイド*」の「[Requirements](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-gateway-ggv2.html#gateway-requirements)」を参照してください。
### エンドポイントおよびポート
このコンポーネントは、基本的な操作に必要なエンドポイントとポートに加えて、次のエンドポイントとポートに対し、アウトバウンドリクエストを実行できる必要があります。詳細については、「[プロキシまたはファイアウォールを介したデバイストラフィックを許可する](allow-device-traffic.md)」を参照してください。
| Endpoint | ポート | 必要 | 説明 |
| --- | --- | --- | --- |
| `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 ゲートウェイの 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 もデプロイします。つまり、コンポーネントを正常にデプロイするには、コンポーネントとその依存関係のすべての要件を満たす必要があります。このセクションでは、このコンポーネントの[リリースされたバージョン](#iotsitewise-processor-component-changelog)の依存関係と、各依存関係に対するコンポーネントのバージョンを定義するセマンティックバージョン制約をリスト表示しています。コンポーネントの各バージョンの依存関係は、[AWS IoT Greengrass コンソール](https://console.aws.amazon.com/greengrass)でも確認できます。コンポーネントの詳細ページで **[Dependencies]** (依存関係) リストを確認します。
次の表に、このコンポーネントのバージョン 2.0.x から 2.1.x までの依存関係を示します。
| 依存関係 | 互換性のあるバージョン | 依存関係タイプ |
| --- | --- | --- |
| [トークン交換サービス](token-exchange-service-component.md) | >=2.0.3 <3.0.0 | ハード |
| [ストリームマネージャー](stream-manager-component.md) | >=2.0.10 <3.0.0 | ハード |
| [Greengrass CLI](greengrass-cli-component.md) | >=2.3.0 <3.0.0 | ハード |
コンポーネントの依存関係の詳細については、「[コンポーネント recipe のリファレンス](component-recipe-reference.md#recipe-reference-component-dependencies)」を参照してください。
## 設定
このコンポーネントに設定パラメータはありません。
## ローカルログファイル
このコンポーネントは次のログファイルを使用します。
------
#### [ 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 ソフトウェアライセンス契約](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf)に従ってリリースされています。
## 変更ログ
次の表は、コンポーネントの各バージョンにおける変更を示します。
| **バージョン** | **変更** |
| --- | --- |
| 3.5.1 | **新機能**
AWS IoT SiteWiseで取り込みが有効になっている場合の Null 値と NaN 値の取り込みのサポートが追加されました。で Null および NaN 設定を表示または変更するには AWS IoT SiteWise、[DescribeStorageConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeStorageConfiguration.html) API と [PutStorageConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutStorageConfiguration.html) APIsを参照してください。
**バグ修正と機能向上**
潜在的なセキュリティの脆弱性に対処するために依存関係を更新しました。 |
| 3.4.0 | **新機能**
オプションの HTTP および HTTPS プロキシのサポートを追加し、カスタム証明書を必要とするプロキシサーバーを介したゲートウェイ通信が可能になりました。 AWS IoT Greengrass コアの HTTP プロキシの設定の詳細については、「」を参照してください[ポート 443 での接続またはネットワークプロキシを通じた接続](configure-greengrass-core-v2.md#configure-alpn-network-proxy)。SiteWise Edge に固有のプロキシサポートの詳細については、*AWS IoT SiteWise 「 ユーザーガイド*」の[AWS IoT SiteWise 「 Edge プロキシサポートの信頼ストアの管理](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/edge-apis-manage-trust-stores-proxy.html)」を参照してください。 AWS OpsHub および SiteWise Edge APIs。詳細については、「 *AWS IoT SiteWise ユーザーガイド*」の[AWS IoT SiteWise 「 Edge のセッションタイムアウトを設定する](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/edge-apis-session-timeout.html)」を参照してください。
**フォーマンスの向上**
受信データがエッジデバイスストレージに到達するまでの時間を 5 秒から 1 秒未満に短縮しました。へのデータアップロードのレイテンシー AWS IoT SiteWise は変更されません。 |
| 3.3.1 | ** 機能を追加**
SiteWise Edge API、CORS オリジンリソース共有機能を強化するオプションの CORS サポートが追加されました。この機能は、API とやり取りするウェブアプリケーションの柔軟性を向上させます。 |
| 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 ゲートウェイメトリクス](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateway-metrics-ggv2.html)」を参照してください。 |
| 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:8081` に変更されています`http://localhost:11080/data`。などの AWS IoT SiteWise コントロールプレーン APIs のローカルエンドポイントが `list-asset-models`から `http://localhost:11080` に変更されています`http://localhost:11080/control`。 AWS 常に SiteWise Edge ゲートウェイ HTTPS エンドポイントを使用することをお勧めします。これらのエンドポイントは変更されていません。
**バグ修正と機能向上**
からの同期では AWS IoT SiteWise 、前の同期が中断された場合にリソースが有効な状態に移行されるようになりました。これにより、強制再起動後に一部のリソースが破損する問題が修正されました。 同期中にリソースが変更された場合、エッジでリソースが破損するまれな状態を修正しました。この条件が検出されると同期が失敗し、リソースは次の同期で再試行されます。 API 呼び出しに HTTP エンドポイントを使用できる問題を修正しました。現在、ローカルループバックアドレスの外部で API を呼び出すために使用できるのは 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 プロセスに移しました。 `get-asset-property-value-history` API の最大結果制限を 20,000 に引き上げて、 が使用する制限に一致させます 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 | 当初のバージョン |
## 関連情報
+ [とは AWS IoT SiteWise](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) *AWS IoT SiteWise ユーザーガイド*の「」を参照してください。