Envoy 設定変数

Envoy コンテナをタスクグループに追加する場合は、この環境変数を、タスクグループが表す仮想ノードまたは仮想ゲートウェイの ARN に設定します。例えば、ARN には、次のリストがあります。

App Mesh プレビューチャンネルを使用する場合、ARN は、us-west-2リージョンを使用し、appmesh の代わりに appmesh-previewを使用する必要があります。例えば、App Mesh プレビューチャネル内の仮想ノードの ARN は、次のようになります。arn:aws:appmesh-preview:us-west-2:111122223333:mesh/meshName/virtualNode/virtualNodeName。

Envoy コンテナのログレベルを指定します。

有効な値: trace, debug, info, warn, error, critical, off

デフォルト: info

初期化プロセス中に Envoy が管理サーバーからの最初の設定応答を待機する時間を指定します。

詳細については、Envoy ドキュメントの「Configuration sources」を参照してください。0 に設定すると、タイムアウトは発生しません。

デフォルト: 0

Envoy の起動時の --concurrency コマンドラインオプションを設定します。これはデフォルトで設定されていません。このオプションは Envoy バージョン v1.24.0.0-prod 以上で使用できます。

詳細については、Envoy ドキュメントの「Command line options」を参照してください。

Envoy がリッスンするカスタム管理ポートを指定します。デフォルト: 9901。

Envoy アクセスログを書き込む先のカスタムパスを指定します。デフォルト: /tmp/envoy_admin_access.log。

Envoy の管理インターフェイスを IPv6 トラフィックを受け入れるように切り替えます。これにより、このインターフェイスは IPv4 と IPv6 のトラフィックの両方を受け入れることができます。デフォルトでは、このフラグは false に設定されており、Envoy は IPv4 トラフィックのみを受信します。この変数は、Envoy イメージのバージョン 1.22.0 以降でのみ使用可能です。

実行中のタスクまたはポッド内の Envoy プロキシプロセスが終了した場合に、エージェントがこのプロセスを再起動する回数を指定します。また、エージェントは Envoy が終了するたびに終了ステータスを記録し、トラブルシューティングを容易にします。この変数のデフォルト値は 0 です。デフォルト値が設定されている場合、エージェントはプロセスの再起動を試行しません。

デフォルト: 0

最大: 10

Envoy プロキシのプロセス状態をエージェントがチェックする間隔をミリ秒単位で指定します。デフォルト値は 100 です。

デフォルト: 100

最小: 100

最大: 1000

Envoy プロキシがアクティブな接続が閉じられてからプロセスが終了するまで待機する時間を秒単位で指定します。

デフォルト: 20

最小: 5

最大: 110

エージェントの管理インターフェイスサーバーを起動し、TCP アドレスまたは UNIX ソケットにバインドします。

有効な値: tcp、uds

tcp モードでエージェントの管理インターフェイスバインドするために使用するポートを指定します。uid != 0 の場合、ポートの値が > 1024 であることを確認します。ポートが 65535 より小さいことを確認します。

デフォルト: 9902

uds モードでのエージェントの管理インターフェイスの UNIX ドメインソケットパスを指定します。

デフォルト: /var/run/ecs/appnet_admin.sock

デフォルトのデーモンエンドポイントとして 127.0.0.1:2000 を使用し、X-Ray トレースを有効にします。有効にするには、値を 1 に設定します。デフォルト値は 0 です。

ポート値を指定して、デフォルトの X-Ray デーモンポート2000 を上書きします。

サンプリングレートを指定して、X-Ray トレーサのデフォルトのサンプリングレート 0.05 (5%)を上書きします。1.00 と 0 (100%) の間の小数で値を指定します。XRAY_SAMPLING_RULE_MANIFEST が指定されている場合、この値は上書きされます。この変数は、バージョン v1.19.1.1-prod 以降の Envoy イメージでサポートされています。

Envoy コンテナファイルシステム内のファイルパスを指定して、X-Ray トレーサのローカライズされたカスタムサンプリングルールを設定します。詳しくは、『AWS X-Ray デベロッパーガイド』の「サンプリングルール」をご覧ください。この変数は、バージョン v1.19.1.0-prod 以降の Envoy イメージでサポートされています。

トレースのセグメント名を指定して、デフォルトの X-Ray セグメント名を上書きします。デフォルトでは、この値は mesh/resourceName に設定されます。この変数は、Envoy イメージバージョン v1.23.1.0-prod 以降でサポートされています。

127.0.0.1:8126 をデフォルトの Datadog エージェントエンドポイントとして使用し、Datadog トレース収集を有効にします。有効にするには、値を 1 (デフォルト値は 0 )に設定します。

ポート値を指定して、デフォルトの Datadog エージェントポート 8126 を上書きします。

IP アドレスを指定して、デフォルトの Datadog エージェントアドレス： 127.0.0.1 を上書きします。

トレースのサービス名を指定して、デフォルトの Datadog サービス名: envoy-meshName/virtualNodeName を上書きします。この変数は、バージョン v1.18.3.0-prod 以降の Envoy イメージでサポートされています。

127.0.0.1:9411 をデフォルトの Jaeger エンドポイントとして使用して、 Jaeger トレース収集を有効にします。有効にするには、値を 1 (デフォルト値は 0 )に設定します。

ポート値を指定して、デフォルトの Jaeger ポート 9411.を上書きします。

IP アドレスを指定して、デフォルトの Jaeger アドレス： 127.0.0.1 を上書きします。

コレクターが JSON と PROTO のいずれのエンコード形式のトレースを必要としているのかを指定します。デフォルトでは、この値は PROTO に設定されます。この変数は、Envoy イメージバージョン v1.23.1.0-prod 以降でサポートされています。

Envoy コンテナファイルシステム内のファイルパスを指定します。ポリシーの詳細については、Envoy ドキュメントの「 config.trace.v3.Tracing 」を参照してください。

127.0.0.1:8125 をデフォルトのデーモンエンドポイントとして使用して、DogStatsD 統計を有効にします。有効にするには、値を 1 に設定します。

ポート値を指定して、デフォルトの DogStatsD デーモンポートを上書きします。

IP アドレス値を指定して、デフォルトの DogStatsD デーモン IP アドレスを上書きします。デフォルト: 127.0.0.1。この変数は、Envoy イメージのバージョン 1.15.0 以降でのみ使用可能です。

DogStatsD デーモンの UNIX ドメインソケットを指定します。この変数を指定せずに、DogStatsD が有効な場合、この値はデフォルトで DogStatsD デーモンの IP アドレスポート 127.0.0.1:8125 になります。統計シンク設定を含む ENVOY_STATS_SINKS_CFG_FILE 変数が指定されている場合、すべての DogStatsD 変数を上書きします。この変数は、Envoy イメージバージョン v1.19.1.0-prod 以降でサポートされています。

値を 1 に設定して、App Mesh プレビューチャネルエンドポイントに接続します。App Mesh プレビューチャネルの使用の詳細については、「 App Mesh プレビューチャネル 」を参照してください。

デフォルトでは、App Mesh は、Envoy によってメトリクスとトレースでそれ自体が参照されるとき、APPMESH_RESOURCE_ARN で指定したリソースの名前を使用します。APPMESH_RESOURCE_CLUSTER 環境変数に独自の名前を設定することで、この動作を上書きできます。この変数は、Envoy イメージのバージョン 1.15.0 以降でのみ使用可能です。

値を 1 に設定して、AppMeshメトリック拡張機能を有効にします。App Mesh メトリクス拡張機能の使用方法の詳細については、「 App Mesh のメトリクス拡張機能 」を参照してください。

値を 1 に設定して、App Mesh Dual Stack エンドポイントに接続します。このフラグを設定すると、Envoy はデュアルスタック対応ドメインを使用します。デフォルトでは、このフラグは false に設定されており、IPv4 ドメインにのみ接続します。この変数は、Envoy イメージのバージョン 1.22.0 以降でのみ使用可能です。

App Mesh 定義タグ appmesh.mesh と appmesh.virtual_node の使用を有効にします。詳細については、Envoy ドキュメントの「config.metrics.v3.TagSpecifier」を参照してください。有効にするには、値を 1 に設定します。

Envoy コンテナファイルシステム内のファイルパスを指定して、デフォルトの Stats タグ設定ファイルを独自の設定ファイルで上書きします。詳細については、「config.metrics.v3.StatsConfig」を参照してください。。

Envoy コンテナファイルシステム内のファイルパスを指定して、デフォルト設定を独自の設定で上書きします。詳細については、Envoy ドキュメントの「config.metrics.v3.StatsSink」を参照してください。