「Amazon ECS Container Insights メトリクス」

以下の表は、Container Insights で Amazon ECS に収集されるメトリクスとディメンションを示しています。これらのメトリクスは ECS/ContainerInsights 名前空間にあります。詳細については、「メトリクス」を参照してください。

コンソールに Container Insights メトリクスが表示されない場合は、Container Insights のセットアップが完了していることを確認します。メトリクスは、Container Insights が完全にセットアップされるまで表示されません。詳細については、「Container Insights の設定」を参照してください。

「Amazon ECS での Container Insights のセットアップ」の手順を完了すると、次のメトリクスが利用できるようになります。

メトリクス名	ディメンション	説明
ContainerInstanceCount	ClusterName	クラスターに登録されている Amazon ECS エージェントを実行している EC2 インスタンスの数。 このメトリクスは、クラスターで Amazon ECS タスクが実行されているコンテナインスタンスに対してのみ収集されます。Amazon ECS タスクがない空のコンテナインスタンスについては収集されません。 単位: 数
CpuUtilized	TaskDefinitionFamily, ClusterName ServiceName, ClusterName ClusterName	使用しているディメンションセットによって指定されるリソースのタスクにより使用されている CPU ユニット数。 単位: なし
CpuReserved	TaskDefinitionFamily, ClusterName ServiceName, ClusterName ClusterName	使用しているディメンションセットによって指定されるリソースのタスクにより予約されている CPU ユニット数。 このメトリクスは、タスクまたはすべてのコンテナレベルなど、タスク定義で定義された CPU 予約に基づいて収集されます。タスク定義で指定されていない場合は、インスタンスの CPU 予約が使用されます。 単位: なし
DeploymentCount	ServiceName, ClusterName	Amazon ECS サービスでのデプロイの数。 単位: 数
DesiredTaskCount	ServiceName, ClusterName	Amazon ECS サービスに必要なタスクの数。 単位: 数
EBSFilesystemSize	VolumeName, TaskDefinitionFamily, ClusterName TaskDefinitionFamily, ClusterName ServiceName, ClusterName	使用しているディメンションで指定されたリソースに割り当てられる Amazon EBS ファイルシステムストレージの合計容量 (GB)。 このメトリクスは、プラットフォームバージョン 1.4.0 を使用する Fargate で実行されている Amazon ECS インフラストラクチャ、またはコンテナエージェントバージョン 1.79.0 以降を使用する Amazon EC2 インスタンスで実行されるタスクでのみ使用できます。 単位: ギガバイト (GB)
EBSFilesystemUtilized	VolumeName, TaskDefinitionFamily, ClusterName TaskDefinitionFamily, ClusterName ServiceName, ClusterName	使用しているディメンションで指定されたリソースに使用される Amazon EBS ファイルシステムストレージの合計容量 (GB)。 このメトリクスは、プラットフォームバージョン 1.4.0 を使用する Fargate で実行されている Amazon ECS インフラストラクチャ、またはコンテナエージェントバージョン 1.79.0 以降を使用する Amazon EC2 インスタンスで実行されるタスクでのみ使用できます。 Fargate で実行されるタスクの場合、Fargate は Fargate でのみ使用されるディスク上のスペースを予約します。Fargate が使用するスペースにコストは発生しませんが、df のようなツールで使用されるこの追加ストレージが表示されます。 単位: ギガバイト (GB)
EphemeralStorageReserved 1	TaskDefinitionFamily, ClusterName ServiceName, ClusterName ClusterName	使用しているディメンションによって指定されたリソースのエフェメラルストレージから予約されたバイト数。エフェメラルストレージは、コンテナルートファイルシステム、およびコンテナイメージとタスク定義で定義されているバインドマウントホストボリュームに使用されます。エフェメラルストレージの容量は、実行中のタスクでは変更できません。 このメトリクスは、Fargate Linux プラットフォームのバージョン 1.4.0 以降で実行されるタスクでのみ使用できます。 単位: ギガバイト (GB)
EphemeralStorageUtilized 1	TaskDefinitionFamily, ClusterName ServiceName, ClusterName ClusterName	使用しているディメンションで指定されたリソースのエフェメラルストレージから使用されたバイト数。エフェメラルストレージは、コンテナルートファイルシステム、およびコンテナイメージとタスク定義で定義されているバインドマウントホストボリュームに使用されます。エフェメラルストレージの容量は、実行中のタスクでは変更できません。 このメトリクスは、Fargate Linux プラットフォームのバージョン 1.4.0 以降で実行されるタスクでのみ使用できます。 単位: ギガバイト (GB)
MemoryUtilized	TaskDefinitionFamily, ClusterName ServiceName, ClusterName ClusterName	使用しているディメンションセットによって指定されるリソースのタスクにより使用されているメモリ。 注記 アプリケーションに Java ZGC ガベージコレクタを使用している場合、このメトリクスが不正確である可能性があります。 MemoryUtilized と MemoryReserved は「メガバイト」とマークされますが、実際の単位は MiB (メビバイト) です。 単位: メガバイト
MemoryReserved	TaskDefinitionFamily, ClusterName ServiceName, ClusterName ClusterName	使用しているディメンションセットによって指定されるリソースのタスクにより予約されているメモリ。このメトリクスは、タスクまたはすべてのコンテナレベルなど、タスク定義で定義されたメモリ予約に基づいて収集されます。タスク定義で指定されていない場合は、インスタンスのメモリ予約が使用されます。 単位: メガバイト 注記 MemoryUtilized と MemoryReserved は「メガバイト」とマークされますが、実際の単位は MiB (メビバイト) です。
NetworkRxBytes	TaskDefinitionFamily, ClusterName ServiceName, ClusterName ClusterName	使用しているディメンションによって指定されたリソースにより受信されるバイト数。このメトリクスは、Docker ランタイムから取得されます。 このメトリクスは、awsvpc または bridge ネットワークモードを使用するタスクのコンテナでのみ使用できます。 単位: バイト/秒
NetworkTxBytes	TaskDefinitionFamily, ClusterName ServiceName, ClusterName ClusterName	使用しているディメンションによって指定されたリソースにより送信されるバイト数。このメトリクスは、Docker ランタイムから取得されます。 このメトリクスは、awsvpc または bridge ネットワークモードを使用するタスクのコンテナでのみ使用できます。 単位: バイト/秒
PendingTaskCount	ServiceName, ClusterName	現在、PENDING 状態にあるタスクの数。 単位: 数
RunningTaskCount	ServiceName, ClusterName	現在、RUNNING 状態にあるタスクの数。 単位: 数
RestartCount	ClusterName ClusterName, ServiceName ClusterName, TaskDefinitionFamily	Amazon ECS タスク内のコンテナが再起動された回数。 このメトリクスは、再起動ポリシーが有効になっているコンテナのみを対象として収集されます。 単位: 数
ServiceCount	ClusterName	クラスター内のサービスの数。 単位: 数
StorageReadBytes	TaskDefinitionFamily, ClusterName ServiceName, ClusterName ClusterName	使用しているディメンションによって指定されたリソース内のインスタンスのストレージから読み取られたバイト数。これにはストレージデバイスの読み取りバイト数は含まれません。このメトリクスは、Docker ランタイムから取得されます。 単位: バイト
StorageWriteBytes	TaskDefinitionFamily, ClusterName ServiceName, ClusterName ClusterName	使用しているディメンションによって指定されたリソースのストレージに書き込まれたバイト数。このメトリクスは、Docker ランタイムから取得されます。 単位: バイト
TaskCount	ClusterName	クラスターで実行されているタスクの数。 単位: 数
TaskSetCount	ServiceName, ClusterName	サービス内のタスクセットの数。 単位: 数

注記

EphemeralStorageReserved および EphemeralStorageUtilized メトリクスは、Fargate Linux プラットフォームのバージョン 1.4.0 以降で実行されるタスクでの使用できます。

Fargate はディスク上のスペースを予約します。スペースは Fargate によってのみ使用されます。これには課金されることはありません。これらのメトリクスには表示されません。ただし、この追加ストレージは、df などの他のツールでも確認できます。

「Amazon ECS で EC2 インスタンスレベルのメトリクスを収集するための CloudWatch エージェントのデプロイ」のステップを完了すると、以下のメトリクスが使用できるようになります

メトリクス名	ディメンション	説明
instance_cpu_limit	ClusterName	このクラスター内の単一の EC2 インスタンスに割り当てることができる CPU ユニットの最大数。 単位: なし
instance_cpu_reserved_capacity	ClusterName InstanceId, ContainerInstanceId, ClusterName	クラスター内の単一の EC2 インスタンスで現在予約されている CPU の割合。 単位: パーセント
instance_cpu_usage_total	ClusterName	クラスター内の単一 EC2 インスタンスで使用されている CPU ユニットの数。 単位: なし
instance_cpu_utilization	ClusterName InstanceId, ContainerInstanceId, ClusterName	クラスター内の単一の EC2 インスタンスで使用されている CPU ユニットの合計割合。 単位: パーセント
instance_filesystem_utilization	ClusterName InstanceId, ContainerInstanceId, ClusterName	クラスター内の単一の EC2 インスタンスで使用されているファイルシステム容量の合計割合。 単位: パーセント
instance_memory_limit	ClusterName	このクラスター内の単一の EC2 インスタンスに割り当てることができるメモリの最大量（バイト単位）。 単位: バイト
instance_memory_reserved_capacity	ClusterName InstanceId, ContainerInstanceId, ClusterName	クラスター内の単一の EC2 インスタンスで現在予約されているメモリの割合。 単位: パーセント
instance_memory_utilization	ClusterName InstanceId, ContainerInstanceId, ClusterName	クラスター内の単一の EC2 インスタンスで使用されているメモリの合計割合。 注記 アプリケーションに Java ZGC ガベージコレクタを使用している場合、このメトリクスが不正確である可能性があります。 単位: パーセント
instance_memory_working_set	ClusterName	クラスター内の単一の EC2 インスタンスで使用されているメモリの量（バイト単位）。 注記 アプリケーションに Java ZGC ガベージコレクタを使用している場合、このメトリクスが不正確である可能性があります。 単位: バイト
instance_network_total_bytes	ClusterName	クラスター内の単一の EC2 インスタンスでネットワーク上で送受信された 1 秒あたりの合計バイト数。 単位: バイト/秒
instance_number_of_running_tasks	ClusterName	クラスター内の単一の EC2 インスタンスで実行中のタスクの数。 単位: 数