

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

# AWS IoT Greengrass ストリームマネージャーの設定
<a name="configure-stream-manager"></a>

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

## ストリームマネージャーのパラメータ
<a name="stream-manager-parameters"></a>

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

**[Storage directory]** (ストレージディレクトリ)  <a name="STREAM_MANAGER_STORE_ROOT_DIR"></a>
パラメータ名: `STREAM_MANAGER_STORE_ROOT_DIR`  
ストリームを保存するために使用されるローカルフォルダの絶対パス。この値は、スラッシュ (`/data` など) で開始する必要があります。  
<a name="stream-manager-store-root-dir-parameter-folder-requirements"></a>既存のフォルダを指定する必要があります。[ストリームマネージャーコンポーネントを実行するシステムユーザー](configure-greengrass-core-v2.md#configure-component-user)には、このフォルダに対する読み取りと書き込み許可が必要です。例えば、次のコマンドを実行して、ストリームマネージャーのルートフォルダとして指定するフォルダ `/var/greengrass/streams` を作成および設定できます。これらのコマンドは、デフォルトのシステムユーザーである `ggc_user` が、このフォルダを読み取りおよび書き込みできるようにします。  

```
sudo mkdir /var/greengrass/streams
sudo chown ggc_user /var/greengrass/streams
sudo chmod 700 /var/greengrass/streams
```
ストリームデータのセキュリティ保護については、「[ローカルデータセキュリティ](manage-data-streams.md#stream-manager-security-stream-data)」を参照してください。  
デフォルト: `/greengrass/v2/work/aws.greengrass.StreamManager`

**[Server port] (サーバーポート**)：  
パラメータ名: `STREAM_MANAGER_SERVER_PORT`  
ストリームマネージャーとの通信に使用されるローカルポート番号。デフォルトは `8088` です。  
`0` を指定して、ランダムに利用可能なポートを利用できます。

**クライアントを認証する**  <a name="STREAM_MANAGER_AUTHENTICATE_CLIENT"></a>
パラメータ名: `STREAM_MANAGER_AUTHENTICATE_CLIENT`  
ストリームマネージャーと対話するためにクライアントを認証する必要があるかどうかを示します。クライアントとストリームマネージャー間のすべてのやり取りは、ストリームマネージャー SDK によって制御されます。このパラメータは、ストリームを操作するためにストリームマネージャー SDK を呼び出すことができるクライアントを決定します。詳細については、「[クライアント承認](manage-data-streams.md#stream-manager-security-client-authentication)」を参照してください。  
有効な値は `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`

**マルチパートアップロードの最小サイズ**  <a name="stream-manager-minimum-part-size"></a>
パラメータ名: `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 です。

## 関連情報
<a name="configure-stream-manager-see-also"></a>
+ [Greengrass コアデバイスでのデータストリームの管理](manage-data-streams.md)
+ [ストリームを操作するために StreamManagerClient を使用する](work-with-streams.md)
+ [サポートされている AWS クラウド 送信先のエクスポート設定](stream-export-configurations.md)