Amazon EKS의 OTel Container Insights에 대한 고급 구성

다음 명령을 실행하여 로그 필터 구성으로 추가 기능을 업데이트합니다. cluster-name을 Amazon EKS 클러스터의 이름으로 바꿉니다.

aws eks update-addon \
  --cluster-name cluster-name \
  --addon-name amazon-cloudwatch-observability \
  --configuration-values '{
    "otelContainerInsights": {
      "enabled": true
    },
    "agent": {
      "config": {
        "logs": {
          "metrics_collected": {
            "kubernetes": {
              "enhanced_container_insights": true
            }
          },
          "exclude_filters": [
            {
              "type": "log_level_filter",
              "log_level": "DEBUG"
            }
          ]
        }
      }
    }
  }' \
  --resolve-conflicts OVERWRITE

업데이트 후 추가 기능 상태가 ACTIVE인지 확인합니다.

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

중앙 모니터링 계정에서 워크로드 계정이 이를 가정하도록 허용하는 신뢰 정책을 사용하여 IAM 역할을 생성합니다. workload-account-id를 워크로드 계정의 AWS 계정 ID로 바꿉니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::workload-account-id:root"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

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

워크로드 계정에서 추가 기능을 업데이트하여 교차 계정 역할을 가정합니다. cluster-name을 Amazon EKS 클러스터의 이름으로 바꾸고 monitoring-account-id를 중앙 모니터링 계정의 AWS 계정 ID로 바꿉니다.

aws eks update-addon \
  --cluster-name cluster-name \
  --addon-name amazon-cloudwatch-observability \
  --configuration-values '{
    "otelContainerInsights": {
      "enabled": true
    },
    "agent": {
      "config": {
        "credentials": {
          "role_arn": "arn:aws:iam::monitoring-account-id:role/CrossAccountCWObservabilityRole"
        }
      }
    }
  }' \
  --resolve-conflicts OVERWRITE

업데이트 후 추가 기능 상태가 ACTIVE인지 확인합니다.

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

다음 명령을 실행하여 사용자 지정 차원을 구성합니다. cluster-name을 Amazon EKS 클러스터의 이름으로 바꾸고 label-key를 차원으로 사용할 Kubernetes 레이블로 바꿉니다.

aws eks update-addon \
  --cluster-name cluster-name \
  --addon-name amazon-cloudwatch-observability \
  --configuration-values '{
    "otelContainerInsights": {
      "enabled": true
    },
    "agent": {
      "config": {
        "logs": {
          "metrics_collected": {
            "kubernetes": {
              "enhanced_container_insights": true,
              "metric_dimensions": {
                "custom_dimensions": ["label-key"]
              }
            }
          }
        }
      }
    }
  }' \
  --resolve-conflicts OVERWRITE

업데이트 후 추가 기능 상태가 ACTIVE인지 확인합니다.

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

다음 명령을 실행하여 리소스 요청 및 제한을 설정합니다. cluster-name을 Amazon EKS 클러스터의 이름으로 바꾸고 리소스 값을 이전 테이블의 값으로 바꿉니다.

aws eks update-addon \
  --cluster-name cluster-name \
  --addon-name amazon-cloudwatch-observability \
  --configuration-values '{
    "otelContainerInsights": {
      "enabled": true
    },
    "agent": {
      "resources": {
        "requests": {
          "cpu": "cpu-request",
          "memory": "memory-request"
        },
        "limits": {
          "cpu": "cpu-limit",
          "memory": "memory-limit"
        }
      }
    }
  }' \
  --resolve-conflicts OVERWRITE

추가 기능 상태가 ACTIVE 이고 에이전트 포드가 새 리소스 할당으로 다시 시작되는지 확인합니다.

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

에이전트 포드가 새 리소스 제한으로 실행 중인지 확인합니다.

kubectl get pods -n amazon-cloudwatch -l app.kubernetes.io/name=cloudwatch-agent -o jsonpath='{.items[0].spec.containers[0].resources}'

추가 기능 상태가 ACTIVE인지 확인합니다. cluster-name을 Amazon EKS 클러스터의 이름으로 바꿉니다.

aws eks describe-addon \
  --cluster-name cluster-name \
  --addon-name amazon-cloudwatch-observability \
  --query "addon.{Status:status,ConfigValues:configurationValues}" \
  --output table

에이전트 포드가 다시 시작되고 Running 상태인지 확인합니다.

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

모든 에이전트 포드는 최근 재시작 시간과 함께 Running 상태로 표시되어야 합니다.