Amazon ECS タスクメタデータエンドポイントバージョン 4
Amazon ECS コンテナエージェントは、各コンテナに環境変数を注入します。これは、タスクメタデータエンドポイントと呼ばれ、コンテナにさまざまなタスクメタデータと Docker
タスクメタデータとネットワークレートの統計は CloudWatch に送信され、 AWS Management Console で表示できます。詳細については、「Container Insights を使用して Amazon ECS コンテナをモニタリングする」を参照してください。
注記
Amazon ECS は、以前のバージョンのタスクメタデータエンドポイントを提供しています。新しいタスクメタデータエンドポイントバージョンを今後作成する必要がないように、追加のメタデータをバージョン 4 の出力に追加できます。既存のメタデータが削除されたり、メタデータのフィールド名が変更されたりすることはありません。
環境変数は、デフォルトでは、少なくともバージョン 1.39.0 の Amazon ECS コンテナエージェントを実行している Amazon ECS Linux インスタンスで起動された Amazon EC2 タスクのコンテナに挿入されます。awsvpc ネットワークモードを使用するAmazon EC2 Windows インスタンスの場合、Amazon ECS コンテナエージェントは少なくともバージョン 1.54.0 でなければなりません。詳細については、「Amazon ECS Linux コンテナインスタンスの管理」を参照してください。
注記
エージェントを最新バージョンに更新することで、古いバージョンのAmazon ECS コンテナエージェントを使用する Amazon EC2 インスタンスでこの機能のサポートを追加できます。詳細については、「Amazon ECS コンテナエージェントをアップデートする」を参照してください。
タスクメタデータエンドポイントバージョン 4 のパス
次のタスクメタデータエンドポイントパスをコンテナで使用できます。
${ECS_CONTAINER_METADATA_URI_V4}-
このパスはコンテナのメタデータを返します。
${ECS_CONTAINER_METADATA_URI_V4}/task-
このパスはタスクのメタデータを返します。これには、タスクに関連付けられたすべてのコンテナのコンテナ ID および名前のリストが含まれています。このエンドポイントのレスポンスの詳細については、「Amazon ECS タスクメタデータ V4 JSON レスポンス」を参照してください。
${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags-
このパスは、
ListTagsForResourceAPI を使用して取得できるタスクとコンテナインスタンスタグに加えて、/taskエンドポイントに含まれるタスクのメタデータを返します。タグメタデータの取得時に受信したエラーは、レスポンスのErrorsフィールドに含まれます。注記
この
Errorsフィールドは、少なくとも1.50.0バージョンのコンテナエージェントを実行しているAmazon EC2 Linux インスタンスでホストされているタスクの応答にのみ表示されます。awsvpcネットワークモードを使用するAmazon EC2 Windows インスタンスの場合、Amazon ECS コンテナエージェントは少なくともバージョン1.54.0でなければなりません。このエンドポイントには、
ecs.ListTagsForResourceアクセス許可が必要です。 ${ECS_CONTAINER_METADATA_URI_V4}/stats-
このパスは特定のコンテナの Docker 統計を返します。返される各統計の詳細については、Docker API ドキュメントの「ContainerStats
」を参照してください。 少なくともバージョン
1.43.0のコンテナエージェントを実行しているAmazon EC2 Linuxインスタンスでホストされているawsvpcまたはbridgeネットワークモードを使用するAmazon ECS タスクの場合、応答に追加のネットワークレート統計が含まれます。他のすべてのタスクでは、レスポンスには累積ネットワーク統計のみが含まれます。 ${ECS_CONTAINER_METADATA_URI_V4}/task/stats-
このパスはタスクに関連付けられたすべてのコンテナの Docker 統計を返します。これをサイドカーコンテナで使用し、ネットワークメトリクスを抽出できます。返される各統計の詳細については、Docker API ドキュメントの「ContainerStats
」を参照してください。 少なくともバージョン
1.43.0のコンテナエージェントを実行しているAmazon EC2 Linuxインスタンスでホストされているawsvpcまたはbridgeネットワークモードを使用するAmazon ECS タスクの場合、応答に追加のネットワークレート統計が含まれます。他のすべてのタスクでは、レスポンスには累積ネットワーク統計のみが含まれます。
