헬름을 사용하여 OTel Container Insights 배포

헬름 리포지토리 추가

1. 다음 명령을 실행하여 리포지토리를 추가합니다.

   helm repo add aws-observability \
     https://aws-observability.github.io/helm-charts

2. 리포지토리를 업데이트하여 최신 차트 버전을 가져옵니다.

   helm repo update

CloudWatch 에이전트에 대한 IAM 역할 생성

1. 클러스터의 OIDC 발급자 URL을 검색합니다. cluster-name을 Amazon EKS 클러스터의 이름으로 바꿉니다.

   aws eks describe-cluster \
     --name cluster-name \
     --query "cluster.identity.oidc.issuer" \
     --output text

2. IRSA에 대한 신뢰 정책을 사용하여 IAM 역할을 생성합니다. account-id를 AWS 계정 ID로 바꾸고 oidc-id를 이전 단계의 OIDC 공급자 ID로 바꿉니다(https://oidc.eks.region.amazonaws.com/id/ 다음 부분).

   aws iam create-role \
     --role-name EKS-CW-Observability-Role \
     --assume-role-policy-document '{
       "Version": "2012-10-17",
       "Statement": [{
         "Effect": "Allow",
         "Principal": {
           "Federated": "arn:aws:iam::account-id:oidc-provider/oidc.eks.region.amazonaws.com/id/oidc-id"
         },
         "Action": "sts:AssumeRoleWithWebIdentity",
         "Condition": {
           "StringEquals": {
             "oidc.eks.region.amazonaws.com/id/oidc-id:sub": "system:serviceaccount:amazon-cloudwatch:cloudwatch-agent"
           }
         }
       }]
     }'

3. CloudWatchAgentServerPolicy 관리형 정책을 역할에 연결합니다.

   aws iam attach-role-policy \
     --role-name EKS-CW-Observability-Role \
     --policy-arn arn:aws:iam::aws:policy/CloudWatchAgentServerPolicy

헬름 차트 설치

• 다음 명령을 실행합니다. cluster-name을 Amazon EKS 클러스터의 이름으로 바꾸고 리전을 AWS 리전으로 바꾸고 account-id를 AWS 계정 ID로 바꿉니다.

  helm install amazon-cloudwatch-observability \
    aws-observability/amazon-cloudwatch-observability \
    --namespace amazon-cloudwatch \
    --create-namespace \
    --set clusterName=cluster-name \
    --set region=region \
    --set agent.serviceAccount.name=cloudwatch-agent \
    --set "agent.serviceAccount.annotations.eks\\.amazonaws\\.com/role-arn=arn:aws:iam::account-id:role/EKS-CW-Observability-Role" \
    --set otelContainerInsights.enabled=true

  중요

  otelContainerInsights.enabled 파라미터가 필요합니다. OTel Container Insights는 기본적으로 활성화되어 있지 않습니다.

헬름 설치 확인

1. 헬름 릴리스 상태가 deployed로 표시되는지 확인합니다.

   helm list -n amazon-cloudwatch

2. 오퍼레이터 포드가 실행 중인지 확인합니다.

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

3. CloudWatch 에이전트 포드가 모든 노드에서 실행 중인지 확인합니다.

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

   모든 포드에 Running 상태가 표시되어야 합니다.

cert-manager 통합 구성

1. 클러스터에 cert-manager가 설치되어 있는지 확인합니다.

   kubectl get pods -n cert-manager

2. cert-manager가 활성화된 헬름 차트를 설치합니다. cluster-name을 Amazon EKS 클러스터의 이름으로 바꾸고 리전을 AWS 리전으로 바꾸고 account-id를 AWS 계정 ID로 바꿉니다.

   helm install amazon-cloudwatch-observability \
     aws-observability/amazon-cloudwatch-observability \
     --namespace amazon-cloudwatch \
     --create-namespace \
     --set clusterName=cluster-name \
     --set region=region \
     --set agent.serviceAccount.name=cloudwatch-agent \
     --set "agent.serviceAccount.annotations.eks\\.amazonaws\\.com/role-arn=arn:aws:iam::account-id:role/EKS-CW-Observability-Role" \
     --set otelContainerInsights.enabled=true \
     --set admissionWebhooks.certManager.enabled=true

헬름 차트 업그레이드

1. 헬름 리포지토리를 업데이트하여 최신 차트 버전을 가져옵니다.

   helm repo update

2. 원하는 값으로 업그레이드 명령을 실행합니다. cluster-name을 Amazon EKS 클러스터의 이름으로 바꾸고 리전을 AWS 리전으로 바꾸고 account-id를 AWS 계정 ID로 바꿉니다.

   helm upgrade amazon-cloudwatch-observability \
     aws-observability/amazon-cloudwatch-observability \
     --namespace amazon-cloudwatch \
     --set clusterName=cluster-name \
     --set region=region \
     --set agent.serviceAccount.name=cloudwatch-agent \
     --set "agent.serviceAccount.annotations.eks\\.amazonaws\\.com/role-arn=arn:aws:iam::account-id:role/EKS-CW-Observability-Role" \
     --set otelContainerInsights.enabled=true

3. 업그레이드가 성공적으로 완료되었는지 확인합니다.

   helm list -n amazon-cloudwatch

   개정 번호는 증가해야 하고 상태는 deployed로 표시되어야 합니다.

헬름 차트 제거

1. 다음 명령을 실행하여 릴리스를 제거합니다.

   helm uninstall amazon-cloudwatch-observability \
     --namespace amazon-cloudwatch

2. 선택적으로 네임스페이스가 더 이상 필요하지 않은 경우 삭제합니다.

   kubectl delete namespace amazon-cloudwatch

CloudWatch에서 지표 확인

1. https://console.aws.amazon.com/cloudwatch/에서 CloudWatch 콘솔을 엽니다.

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

3. 클러스터가 클러스터 목록에 나타나고 인프라 지표가 채워지고 있는지 확인합니다.