AWS IoT Greengrass ストリームマネージャーの設定 - AWS IoT Greengrass
ストリームマネージャーのパラメータ以下も参照してください。

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

AWS IoT Greengrass ストリームマネージャーの設定

Greengrass コアデバイスでは、ストリームマネージャーは IoT デバイスのデータを保存、処理、およびエクスポートすることができます。ストリームマネージャーは、ランタイム設定の設定に使用するパラメータを提供します。これらの設定は、Greengrass コアデバイスのすべてのストリームに適用されます。コンポーネントをデプロイする際に、AWS IoT Greengrass コンソールまたは API を使用して、ストリームマネージャーの設定を行うことができます。変更は、デプロイを完了した後に有効になります。

ストリームマネージャーのパラメータ

ストリームマネージャーは、コンポーネントをコアデバイスにデプロイする際に設定可能な以下のパラメータを提供します。すべてのパラメータは省略可能です。

[Storage directory] (ストレージディレクトリ)

パラメータ名: STREAM_MANAGER_STORE_ROOT_DIR

ストリームを保存するために使用されるローカルフォルダの絶対パス。この値は、スラッシュ (/data など) で開始する必要があります。

既存のフォルダを指定する必要があります。ストリームマネージャーコンポーネントを実行するシステムユーザーには、このフォルダに対する読み取りと書き込み許可が必要です。例えば、次のコマンドを実行して、ストリームマネージャーのルートフォルダとして指定するフォルダ /var/greengrass/streams を作成および設定できます。これらのコマンドは、デフォルトのシステムユーザーである ggc_user が、このフォルダを読み取りおよび書き込みできるようにします。

sudo mkdir /var/greengrass/streams
sudo chown ggc_user /var/greengrass/streams
sudo chmod 700 /var/greengrass/streams

ストリームデータのセキュリティ保護については、「ローカルデータセキュリティ」を参照してください。

デフォルト: /greengrass/v2/work/aws.greengrass.StreamManager

Server port

パラメータ名: STREAM_MANAGER_SERVER_PORT

ストリームマネージャーとの通信に使用されるローカルポート番号。デフォルトは 8088 です。

0 を指定して、ランダムに利用可能なポートを利用できます。

クライアントを認証する

パラメータ名: STREAM_MANAGER_AUTHENTICATE_CLIENT

ストリームマネージャーと対話するためにクライアントを認証する必要があるかどうかを示します。クライアントとストリームマネージャー間のすべてのやり取りは、ストリームマネージャー SDK によって制御されます。このパラメータは、ストリームを操作するためにストリームマネージャー SDK を呼び出すことができるクライアントを決定します。詳細については、「クライアント承認」を参照してください。

有効な値は true または false です。デフォルトは true (推奨) です。

  • true。Greengrass コンポーネントのみをクライアントとして許可します。コンポーネントは内部 AWS IoT Greengrass Core プロトコルを使用して、ストリームマネージャー SDK で認証します。

  • false。AWS IoT Greengrass Core で実行されるすべてのプロセスをクライアントとして許可します。ビジネスケースで必要とされない限り、値を false に設定しないでください。例えば、コアデバイス上の非コンポーネントプロセスがストリームマネージャーと直接通信する必要がある場合に限って false を使用します。

最大帯域幅

パラメータ名: STREAM_MANAGER_EXPORTER_MAX_BANDWIDTH

データのエクスポートに使用できる平均最大帯域幅 (キロビット/秒)。デフォルトでは、使用可能な帯域幅を無制限に使用することができます。

スレッドプールサイズ

パラメータ名: STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE

データのエクスポートに使用できるアクティブなスレッドの最大数。デフォルトは 5 です。

最適なサイズは、ハードウェア、ストリームボリューム、予定されているエクスポートストリームの数によって異なります。エクスポート速度が遅い場合は、この設定を調整して、ハードウェアとビジネスケースに最適なサイズを見つけることができます。コアデバイスハードウェアの CPU とメモリは、制限要因です。開始するには、この値をデバイスのプロセッサコアの数と同じ値に設定してみてください。

ハードウェアがサポートできるサイズよりも大きいサイズを設定しないように注意してください。各ストリームはハードウェアリソースを消費するため、制約のあるデバイス上ではエクスポートストリームの数を制限する必要があります。

JVM の引数

パラメータ名: JVM_ARGS

起動時にストリームマネージャーに渡すカスタム Java 仮想マシン引数。複数の引数はスペースで区切る必要があります。

このパラメータは、JVM で使用されるデフォルト設定を上書きする必要がある場合にのみ使用します。例えば、大量のストリームをエクスポートする場合は、デフォルトのヒープサイズを大きくする必要があります。

ログ記録レベル

パラメータ名: LOG_LEVEL

コンポーネントのロギングレベル。こちらにレベル順に一覧表示されているログレベルから選択します。

  • TRACE

  • DEBUG

  • INFO

  • WARN

  • ERROR

デフォルト: INFO

マルチパートアップロードの最小サイズ

パラメータ名: STREAM_MANAGER_EXPORTER_S3_DESTINATION_MULTIPART_UPLOAD_MIN_PART_SIZE_BYTES

Amazon S3 へのマルチパートアップロードにおけるパートの最小サイズ (バイト単位)。ストリームマネージャーはこの設定と入力ファイルのサイズを基に、マルチパート PUT リクエストのデータをバッチ処理する方法を決定します。デフォルトの最小値は 5242880 バイト (5 MB) です。

注記

ストリームマネージャーはストリームの sizeThresholdForMultipartUploadBytes プロパティを基に、Amazon S3 へのエクスポートをシングルアップロードで行うか、マルチパートアップロードで行うかを決定します。ユーザー定義の Greengrass コンポーネントが、Amazon S3 にエクスポートするストリームを作成する際にこのしきい値を設定します。デフォルトのしきい値は 5 MB です。

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