설정 안내서(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 없이 설치하면 Classic 대신 OTel 파이프라인을 활성화하는 최신 버전(v6.2.0 이상)이 설치됩니다.

추가 기능 상태 확인

• 다음 명령을 실행합니다. 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. https://console.aws.amazon.com/cloudwatch/에서 CloudWatch 콘솔을 엽니다.

2. 탐색 창에서 Contributor Insights를 선택합니다.

3. 클러스터에 node_cpu_utilization 및 pod_memory_utilization과 같은 지표가 나타나는지 확인합니다.