Amazon ECS タスクとコンテナインスタンスを監視するために CloudWatch Container Insights を設定する方法を教えてください。

解決策

注: AWS コマンドラインインターフェイス (AWS CLI) コマンドの実行中にエラーが発生した場合は、「AWS CLI で発生したエラーのトラブルシューティング」を参照してください。また、AWS CLI の最新バージョンを使用していることを確認してください。

Container Insights は、クラスターとサービスのメトリクスを集計します。タスクとコンテナインスタンスの正常性とパフォーマンスに関する詳細なメトリクスを取得するには、オブザーバビリティ拡張 Container Insights を使用することがベストプラクティスです。Container Insights および オブザーバビリティ拡張 Container Insights は、AWS アカウント全体または特定のクラスターに対して有効にできます。

アカウントレベルで Container Insights を有効にする

注: アカウントレベルで Container Insights を有効にすると、すべての新しいクラスターで自動的に Container Insights が有効化されるため、時間を節約できます。

Amazon ECS コンソールまたは AWS CLI を使用して Container Insights を有効化するか、拡張オブザーバビリティ Container Insights を有効化します。なお、個々の AWS Identity and Access Management (IAM) ユーザーに対して、デフォルトの AWS アカウント設定で Container Insights を有効化することができます。そのためには、root ユーザーアカウントでログインする必要があります。

すべてのユーザーのアカウント設定を変更するには、次の put-account-setting-default を実行します。

aws ecs put-account-setting-default --name containerInsights --value enabled --region REGION_NAME

注: REGION_NAME は、お使いの AWS リージョンに置き換えます。AWS CLI コマンドで行った変更は、IAM ユーザーまたはロールがこれらの設定を明示的に上書きしない限り、アカウント全体に適用されます。アカウントのすべての IAM ユーザーまたはロールでデフォルトアカウント設定を無効にするには、enabled を disabled に置き換えます。クラスターで CloudWatch Application Insights が有効になっている場合は、Container Insights の削除時に削除するか、アプリケーションコンポーネントに対する監視を無効にする必要があります。

クラスターレベルで Container Insights を有効にする

Amazon ECS コンソールを使用して Container Insights が有効な新しいクラスターを作成するには、次の手順を実行します。

1. Amazon ECS コンソールを開きます。
2. ナビゲーションバーで AWS リージョンを選択し、[クラスター] を選択します。
3. [クラスターの作成] を選択します。
4. クラスター設定を構成します。
5. [モニタリング] を展開し、[Container Insights を使用する] または [拡張オブザーバビリティ Container Insights を使用する] を選択します。
6. [作成] を選択します。

AWS CLI を使用して Container Insights が有効な新しいクラスターを作成するには、次の create-cluster コマンドを実行します。

aws ecs create-cluster --cluster-name CLUSTER_NAME --settings name=containerInsights,value=enabled --region REGION_NAME

注: お使いのものでそれぞれ、CLUSTER_NAME をクラスター名に、REGION_NAME をリージョン名に置き換えます。拡張オブザーバビリティを有効にするには、value=enabled を value=enhanced に置き換えます。

Amazon ECS コンソールを使用して既存のクラスターでContainer Insights を有効化します。または、AWS CLI を使用する場合は、次の update-cluster-settings コマンドを実行します。

aws ecs update-cluster-settings --cluster CLUSTER_NAME --settings name=containerInsights,value=enabled --region REGION_NAME

注: お使いのものでそれぞれ、CLUSTER_NAME をクラスター名に、REGION_NAME をリージョン名に置き換えます。Container Insights を無効にするには、value=enabled を value=disabled に置き換えます。拡張オブザーバビリティを使用する場合は、value=enabled を value=enhanced に置き換えます。

Container Insights のオプションをレビューする

Amazon Elastic Compute Cloud (Amazon EC2) 起動タイプを使用する場合は、タスクレベルまたはコンテナレベルで CPU パラメータを定義することで、Amazon ECS タスクの CPU 使用量に関するメトリクスを確認できます。

AWS Fargate で実行されるすべてのタスクと、ブリッジネットワークモードを使用する Amazon EC2 インスタンス上のタスクのネットワークメトリクスを確認できます。Amazon Virtual Private Cloud (Amazon VPC) ネットワークモードを使用するタスクに関するメトリクスも使用できます。

EC2 インスタンスでホストされている Amazon ECS クラスターからインスタンスレベルのメトリクスを収集するには、CloudWatch エージェントをデプロイします。

関連情報

Amazon ECS Container Insights のメトリクス

Amazon ECS 拡張オブザーバビリティ Container Insights のメトリクス

Container Insights メトリクスを確認する

例 12-Amazon ECS 用の Container Insights (拡張オブザーバビリティあり/なし)