Terapkan Wawasan Kontainer OTel dengan Helm

Untuk menambahkan repositori Helm

1. Jalankan perintah berikut untuk menambahkan repositori.

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

2. Perbarui repositori untuk mendapatkan versi bagan terbaru.

   helm repo update

Untuk membuat peran IAM untuk agen CloudWatch

1. Ambil URL penerbit OIDC untuk klaster Anda. Ganti cluster-name dengan nama cluster Amazon EKS Anda.

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

2. Buat peran IAM dengan kebijakan kepercayaan untuk IRSA. Ganti account-id dengan ID AWS akun Anda dan oidc-id dengan ID penyedia OIDC dari langkah sebelumnya (bagian setelahnya). 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. Lampirkan kebijakan yang CloudWatchAgentServerPolicy dikelola ke peran.

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

Untuk menginstal bagan Helm

• Jalankan perintah berikut. Ganti cluster-name dengan nama kluster Amazon EKS Anda, region dengan AWS Wilayah Anda, dan account-id dengan ID AWS akun Anda.

  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

  penting

  parameter otelContainerInsights.enabled diperlukan. OTel Container Insights tidak diaktifkan secara default.

Untuk memverifikasi instalasi Helm

1. Verifikasi bahwa status rilis Helm ditampilkandeployed.

   helm list -n amazon-cloudwatch

2. Konfirmasikan bahwa pod operator sedang berjalan.

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

3. Konfirmasikan bahwa pod CloudWatch agen berjalan di semua node.

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

   Semua pod agen harus menunjukkan Running status.

Untuk mengonfigurasi integrasi cert-manager

1. Verifikasi bahwa cert-manager diinstal di cluster Anda.

   kubectl get pods -n cert-manager

2. Instal bagan Helm dengan cert-manager diaktifkan. Ganti cluster-name dengan nama kluster Amazon EKS Anda, region dengan AWS Wilayah Anda, dan account-id dengan ID AWS akun Anda.

   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

Untuk memutakhirkan bagan Helm

1. Perbarui repositori Helm untuk mendapatkan versi bagan terbaru.

   helm repo update

2. Jalankan perintah upgrade dengan nilai yang Anda inginkan. Ganti cluster-name dengan nama kluster Amazon EKS Anda, region dengan AWS Wilayah Anda, dan account-id dengan ID AWS akun Anda.

   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. Verifikasi bahwa pemutakhiran berhasil diselesaikan.

   helm list -n amazon-cloudwatch

   Nomor revisi harus bertambah dan status harus ditampilkan. deployed

Untuk menghapus bagan Helm

1. Jalankan perintah berikut untuk menghapus instalasi rilis.

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

2. Secara opsional, hapus namespace jika tidak lagi diperlukan.

   kubectl delete namespace amazon-cloudwatch

Untuk memeriksa metrik di CloudWatch

1. Buka CloudWatch konsol di https://console.aws.amazon.com/cloudwatch/.

2. Di panel navigasi, pilih Wawasan Kontainer.

3. Verifikasi bahwa klaster Anda muncul di daftar klaster dan metrik infrastruktur terisi.