ストリームマネージャー - AWS IoT Greengrass
バージョンタイプオペレーティングシステム要件依存関係構成ローカルログファイル変更ログ

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

ストリームマネージャー

ストリームマネージャーコンポーネント (aws.greengrass.StreamManager) を使用すると、データストリームを処理して AWS クラウド Greengrass コアデバイスから に転送できます。

カスタムコンポーネントでストリームマネージャーを設定して使用する方法の詳細については、「Greengrass コアデバイスでのデータストリームの管理」を参照してください。

バージョン

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

  • 2.1.x

  • 2.0.x

注記

ストリームマネージャーを使用してデータをクラウドにエクスポートする場合、ストリームマネージャーコンポーネントのバージョン 2.0.7 を v2.0.8 と v2.0.11 の間のバージョンにアップグレードすることはできません。ストリームマネージャーを初めてデプロイする場合、ストリームマネージャーコンポーネントの最新バージョンをデプロイすることを強くお勧めします。

タイプ

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

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

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

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

  • Linux

  • Windows

要件

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

  • トークン交換ロールは、ストリームマネージャーで使用する AWS クラウド 送信先へのアクセスを許可する必要があります。詳細については、以下を参照してください。

  • ストリームマネージャーコンポーネントは、 での実行がサポートされていますVPC。このコンポーネントを にデプロイするにはVPC、以下が必要です。

    • ストリームマネージャーコンポーネントには、データを発行する AWS サービスへの接続が必要です。

      • Amazon S3: com.amazonaws.region.s3

      • Amazon Kinesis Data Streams: com.amazonaws.region.kinesis-streams

      • AWS IoT SiteWise: com.amazonaws.region.iotsitewise.data

    • us-east-1 リージョンの Amazon S3 にデータを発行する場合、このコンポーネントはデフォルトで S3 グローバルエンドポイントの使用を試みます。ただし、このエンドポイントは Amazon S3 VPCインターフェイスエンドポイントからは使用できません。詳細については、Amazon S3 の の制限と制限 AWS PrivateLink」を参照してください。これを解決するには、次のオプションから選択できます。

      • で を設定してus-east-1、リージョン内のリージョン S3 エンドポイントを使用するようにストリームマネージャーコンポーネント-Daws.s3UseUsEast1RegionalEndpoint=regionalを設定しますJVM_ARGS。

      • Amazon S3 インターフェイスVPCエンドポイントの代わりに Amazon S3 ゲートウェイVPCエンドポイントを作成します。S3 ゲートウェイエンドポイントは、S3 グローバルエンドポイントへのアクセスをサポートします。詳細については、「ゲートウェイエンドポイントの作成」を参照してください。

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

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

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

iotanalytics.region.amazonaws.com

 443 なし

にデータを発行する場合は必須です AWS IoT Analytics。

kinesis.region.amazonaws.com

 443 なし

Firehose にデータを発行する場合は必須です。

data.iotsitewise.region.amazonaws.com

 443 なし

データを に発行する場合は必須です AWS IoT SiteWise。

*.s3.amazonaws.com

 443 なし

S3 バケットにデータを公開する場合に必要です。

* は、データを公開する各バケットの名前に置き換えることができます。

依存関係

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

2.1.13

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

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.0.0 <2.14.0 ソフト
トークン交換サービス >=0.0.0 ハード
2.1.11 - 2.1.12

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

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.0.0 <2.13.0 ソフト
トークン交換サービス >=0.0.0 ハード
2.1.9 – 2.1.10

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

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.0.0 <2.12.0 ソフト
トークン交換サービス >=0.0.0 ハード
2.1.5 – 2.1.8

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

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.0.0 <2.11.0 ソフト
トークン交換サービス >=0.0.0 ハード
2.1.2 – 2.1.4

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

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.0.0 <2.10.0 ソフト
トークン交換サービス >=0.0.0 ハード
2.1.1

次の表に、このコンポーネントのバージョン 2.1.1 の依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.0.0 <2.9.0 ソフト
トークン交換サービス >=0.0.0 ハード
2.1.0

次の表に、このコンポーネントのバージョン 2.1.0 の依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.0.0 <2.8.0 ソフト
トークン交換サービス >=0.0.0 ハード
2.0.15

次の表に、このコンポーネントのバージョン 2.0.15 の依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.0.0 <2.7.0 ソフト
トークン交換サービス >=0.0.0 ハード
2.0.13 and 2.0.14

次の表に、このコンポーネントのバージョン 2.0.13 および 2.0.14 の依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.0.0 <2.6.0 ソフト
トークン交換サービス >=0.0.0 ハード
2.0.11 and 2.0.12

次の表に、このコンポーネントのバージョン 2.0.11 および 2.0.12 の依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.0.0 <2.5.0 ソフト
トークン交換サービス >=0.0.0 ハード
2.0.10

次の表に、このコンポーネントのバージョン 2.0.10 の依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.0.0 <2.4.0 ソフト
トークン交換サービス >=0.0.0 ハード
2.0.9

次の表に、このコンポーネントのバージョン 2.0.9 の依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.0.0 <2.3.0 ソフト
トークン交換サービス >=0.0.0 ハード
2.0.8

次の表に、このコンポーネントのバージョン 2.0.8 の依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.0.0 <2.2.0 ソフト
トークン交換サービス >=0.0.0 ハード
2.0.7

次の表に、このコンポーネントのバージョン 2.0.7 の依存関係を示します。

依存関係 互換性のあるバージョン 依存関係タイプ
Greengrass nucleus >=2.0.3 <2.1.0 ソフト
トークン交換サービス >=0.0.0 ハード

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

構成

このコンポーネントには、コンポーネントのデプロイ時にカスタマイズできる次の設定パラメータが用意されています。

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

STREAM_MANAGER_SERVER_PORT

(オプション) ストリームマネージャーとの通信に使用するローカルポート番号。

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

デフォルト: 8088

STREAM_MANAGER_AUTHENTICATE_CLIENT

(オプション) クライアントがストリームマネージャーとやり取りする前に、クライアントの認証を必須にできます。ストリームマネージャーは、クライアントとストリームマネージャー間のインタラクションSDKを制御します。このパラメータは、ストリームを操作するSDKためにストリームマネージャーを呼び出すことができるクライアントを決定します。詳細については、「ストリームマネージャークライアント認証」を参照してください。

を指定するとtrue、ストリームマネージャーは Greengrass コンポーネントのみをクライアントとしてSDK許可します。

を指定するとfalse、ストリームマネージャーはコアデバイス上のすべてのプロセスをクライアントにSDK許可します。

デフォルト: true

STREAM_MANAGER_EXPORTER_MAX_BANDWIDTH

(オプション) ストリームマネージャーがデータのエクスポートに使用できる平均最大帯域幅 (KB/s) 。

デフォルト: 無制限

STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE

(オプション) ストリームマネージャーがデータのエクスポートに使用できるアクティブなスレッドの最大数。

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

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

デフォルト: 5 スレッド

STREAM_MANAGER_EXPORTER_S3_DESTINATION_MULTIPART_UPLOAD_MIN_PART_SIZE_BYTES

(オプション) Amazon S3 にマルチパートアップロードのパートの最小サイズ (バイト単位)。ストリームマネージャーは、この設定と入力ファイルのサイズを使用して、マルチパートPUTリクエストでデータをバッチ処理する方法を決定します。

注記

ストリームマネージャーは、ストリーム sizeThresholdForMultipartUploadBytes プロパティを使用して、Amazon S3 にシングルまたはマルチパートのアップロードとしてエクスポートするかどうかを決定します。 AWS IoT Greengrass コンポーネントは、Amazon S3 にエクスポートするストリームを作成するときに、このしきい値を設定できます。

デフォルト: 5242880 (5 MB)。これも最小値です。

LOG_LEVEL

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

  • TRACE

  • DEBUG

  • INFO

  • WARN

  • ERROR

デフォルト: INFO

JVM_ARGS

(オプション) 起動時にストリームマネージャーに渡すカスタム Java 仮想マシン引数。複数の引数はスペースで区切ります。

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

例: 設定マージの更新

次の設定例では、デフォルト以外のポートを使用するように指定しています。

{
  "STREAM_MANAGER_SERVER_PORT": "18088"
}

ローカルログファイル

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

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

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

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

変更ログ

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

バージョン

変更

2.1.13
バグ修正と機能向上

のFIPSエンドポイントをサポート AWS IoT SiteWise

2.1.12
バグ修正と機能向上

Greengrass 認証情報が AWS サービスリクエストに優先されるように、認証情報が使用される順序を更新します。

2.1.11

 Greengrass nucleus バージョン 2.12.0 リリース用にバージョンが更新されました。

2.1.10
バグ修正と機能向上

HTTPS プロキシ設定が Greengrass 認証局 (CA) 証明書チェーンを信頼しない問題を修正しました。

2.1.9

 Greengrass nucleus バージョン 2.11.0 のリリース用にバージョンが更新されました。

2.1.8
バグ修正と機能向上

ストリームマネージャーが で失敗した SiteWise エクスポートを無限に再試行する問題を修正しましたInvalidRequestException。

2.1.7
バグ修正と機能向上

ストリームマネージャーがプロキシ構成を正しく読み取れない問題を修正しました。

2.1.6
バグ修正と機能向上

Jetson Nano を含む特定のARMv8プロセッサで起動時にクラッシュする問題を修正しました。

2.1.5

 Greengrass nucleus バージョン 2.10.0 のリリース用にバージョンが更新されました。

2.1.4
バグ修正と機能向上

  • 1 つのバッチ内で同じタイムスタンプを持つ同じプロパティアセットのエントリが ConflictingOperationExceptionから戻り、ストリームマネージャーが継続的に再試行 SiteWise APIする問題を修正しました。

  • デフォルトの接続タイムアウトを 3 秒から 1 分に更新しました。

2.1.3
バグ修正と機能向上

SYSTEM ユーザーとして実行している場合の Windows OS のスタートアップの問題を修正しました。

2.1.2
バグ修正と機能向上

  • 英語以外の言語を使用する Windows OS における問題を修正しました。

  • Greengrass nucleus バージョン 2.9.0 のリリース用にバージョンが更新されました。

2.1.1

 Greengrass nucleus バージョン 2.8.0 のリリース用にバージョンが更新されました。

2.1.0
新機能

2.0.15

Greengrass nucleus バージョン 2.6.0 のリリース用にバージョンが更新されました。

2.0.14

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

2.0.13

Greengrass nucleus バージョン 2.5.0 のリリース用にバージョンが更新されました。
2.0.12
バグ修正と機能向上

ストリームマネージャー v2.0.7 を v2.0.8 と v2.0.11 の間のバージョンにアップグレードできない問題を修正しました。ストリームマネージャーを使用してデータをクラウドにエクスポートする場合、v2.0.12 にアップグレードできるようになりました。

2.0.11

Greengrass nucleus バージョン 2.4.0 のリリース用にバージョンが更新されました。

2.0.10

Greengrass nucleus バージョン 2.3.0 のリリース用にバージョンが更新されました。

2.0.9

Greengrass nucleus バージョン 2.2.0 のリリース用にバージョンが更新されました。

2.0.8

Greengrass nucleus バージョン 2.1.0 のリリース用にバージョンが更新されました。

2.0.7

当初のバージョン