クラスターおよびサービスレベルの Amazon ECS でメトリクスの Container Insights の設定 - Amazon CloudWatch

クラスターおよびサービスレベルの Amazon ECS でメトリクスの Container Insights の設定

新規および既存の Amazon ECS クラスターで Container Insights を有効にできます。Container Insights は、クラスター、タスク、およびサービスレベルでメトリクスを収集します。Amazon ECS コンソールまたは AWS CLI のいずれかを使用して Container Insights を有効にすることができます。

Amazon EC2 インスタンスで Amazon ECS を使用している場合、Container Insights からネットワークおよびストレージメトリクスを収集するには、Amazon ECS エージェントバージョン 1.29 を含む AMI を使用してインスタンスを起動します。エージェントのバージョンを更新する方法については、「Amazon ECS コンテナエージェントの更新」を参照してください。

AWS CLI を使用して、アカウントレベルの許可を設定し、アカウント内に作成された新しい Amazon ECS クラスターに対して Container Insights を有効にすることができます。これを行うには、次のコマンドを入力します。

aws ecs put-account-setting --name "containerInsights" --value "enabled"
注記

Amazon ECS Container Insights メトリクスに使用するカスタマーマネージド AWS KMS キーが CloudWatch と連携するように設定されていない場合は、CloudWatch Logs で暗号化されたログを許可するようにキーポリシーを更新する必要があります。また、独自の AWS KMS キーを /aws/ecs/containerinsights/ClusterName/performance のロググループに関連付ける必要があります。詳細については、「Encrypt log data in CloudWatch Logs using AWS Key Management Service」を参照してください。

既存の Amazon ECS クラスターでの Container Insights のセットアップ

既存の Amazon ECS クラスターで Container Insights を有効にするには、次のコマンドを入力します。次のコマンドを使用するには、AWS CLI のバージョン 1.16.200 以降を実行している必要があります。

aws ecs update-cluster-settings --cluster myCICluster --settings name=containerInsights,value=enabled

新しい Amazon ECS クラスターでの Container Insights のセットアップ

新しい Amazon ECS クラスターで Container Insights を有効化する方法は 2 つあります。すべての新しいクラスターがデフォルトで Container Insights に対して有効になるように Amazon ECS を設定できます。それ以外の場合は、作成時に新しいクラスターを有効にすることができます。

AWS Management Console の使用

Container Insights は、デフォルトですべての新しいクラスターでオンにすることも、作成時に個々のクラスターでオンにすることもできます。

新しいクラスターで Container Insights をデフォルトでオンにするには
  1. コンソールをhttps://console.aws.amazon.com/ecs/v2で開きます。

  2. ナビゲーションペインで [Account Settings] (アカウント設定) を選択します。

  3. [Update] (更新) を選択します。

  4. クラスターで CloudWatch Container Insights をデフォルトで使用するには、[CloudWatch Container Insights] で、[CloudWatch Container Insights] を選択またはクリアします。

  5. [Save changes] (変更の保存) をクリックします。

前述の手順を使用して、すべての新しいクラスターでデフォルトで Container Insights を有効にしていない場合は、次の手順を使用して、Container Insights が有効になっているクラスターを作成することができます。

Container Insights をオンにしてクラスターを作成するには
  1. コンソール (https://console.aws.amazon.com/ecs/v2) を開きます。

  2. ナビゲーションペインで [Clusters] (クラスター) を選択します。

  3. [Clusters] (クラスター) ページで、[Create Cluster] (クラスターの作成) を選択します。

  4. [Cluster configuration] (クラスター設定) で、[Cluster name] (クラスター名) に一意の名前を入力します。

    名前には、最大 255 文字 (大文字と小文字)、数字、およびハイフンを含めることができます。

  5. Container Insights をオンにするには、[モニタリング] を展開し、[Container Insights の使用] をオンにします。

タスク定義を作成し、タスクを実行して、クラスター内でサービスを起動できるようになりました。詳細については、以下を参照してください。

AWS CLI を使用した新しい Amazon ECS クラスターでの Container Insights の設定

新しいクラスターでデフォルトで Container Insights を有効にするには、次のコマンドを入力します。

aws ecs put-account-setting --name "containerInsights" --value "enabled"

前述の手順を使用して、すべての新しいクラスターでデフォルトで Container Insights を有効にしない場合は、次のコマンドを入力して、Container Insights が有効になっている新しいクラスターを作成することができます。次のコマンドを使用するには、AWS CLI のバージョン 1.16.200 以降を実行している必要があります。

aws ecs create-cluster --cluster-name myCICluster --settings "name=containerInsights,value=enabled"

Amazon ECS クラスターでの Container Insights の無効化

既存の Amazon ECS クラスターで Container Insights を無効にするには、次のコマンドを入力します。

aws ecs update-cluster-settings --cluster myCICluster --settings name=containerInsights,value=disabled