セットアップガイド (AWS CLI)

CloudWatch エージェント IAM ロールを作成するには

1. EKS Pod Identity 用の信頼ポリシーを持つロールを作成するには、次のコマンドを実行します。

   aws iam create-role \
     --role-name EKS-CloudWatch-Agent-Role \
     --assume-role-policy-document '{
       "Version": "2012-10-17",
       "Statement": [{
         "Effect": "Allow",
         "Principal": { "Service": "pods.eks.amazonaws.com" },
         "Action": ["sts:AssumeRole", "sts:TagSession"]
       }]
     }'

2. CloudWatchAgentServerPolicy 管理ポリシーをロールにアタッチします。

   aws iam attach-role-policy \
     --role-name EKS-CloudWatch-Agent-Role \
     --policy-arn arn:aws:iam::aws:policy/CloudWatchAgentServerPolicy

Pod Identity の関連付けを作成するには

• 以下のコマンドを実行してください。cluster-name を Amazon EKS クラスターの名前に、account-id を AWS アカウント ID に置き換えます。

  aws eks create-pod-identity-association \
    --cluster-name cluster-name \
    --namespace amazon-cloudwatch \
    --service-account cloudwatch-agent \
    --role-arn arn:aws:iam::account-id:role/EKS-CloudWatch-Agent-Role

アドオンをインストールするには

• 以下のコマンドを実行してください。cluster-name は、自分の Amazon EKS クラスターに置き換えます。

  aws eks create-addon \
    --cluster-name cluster-name \
    --addon-name amazon-cloudwatch-observability \
    --addon-version v5.x.x-eksbuild.x

  v5.x.x-eksbuild.x を利用可能な最新の v5.x バージョンに置き換えます。--addon-version なしでインストールすると、最新バージョン (v6.2.0 以降) がインストールされ、Classic ではなく OTel パイプラインがアクティブ化されます。

アドオンのステータスを確認するには

• 以下のコマンドを実行してください。cluster-name は、自分の Amazon EKS クラスターに置き換えます。

  aws eks describe-addon \
    --cluster-name cluster-name \
    --addon-name amazon-cloudwatch-observability \
    --query "addon.status" \
    --output text

  期待される出力は ACTIVE です。

エージェントポッドが実行されていることを確認するには

• 以下のコマンドを実行してください。

  kubectl get pods -n amazon-cloudwatch -l app.kubernetes.io/name=cloudwatch-agent

  すべてのエージェントポッドが Running ステータスになっている必要があります。

Container Insights データを確認するには

1. CloudWatch コンソールの https://console.aws.amazon.com/cloudwatch/ を開いてください。

2. ナビゲーションペインで、[Container Insights] を選択します。

3. node_cpu_utilization や pod_memory_utilization など、クラスターのメトリクスが表示されることを確認します。