Implementa OTel Container Insights con Helm

Per aggiungere il repository Helm

1. Esegui il comando seguente per aggiungere il repository.

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

2. Aggiorna il repository per ottenere le versioni più recenti dei grafici.

   helm repo update

Per creare il ruolo IAM per l'agente CloudWatch

1. Recupera l'URL dell'emittente OIDC per il tuo cluster. Sostituisci cluster-name con il nome del tuo cluster Amazon EKS.

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

2. Crea il ruolo IAM con una policy di fiducia per IRSA. Sostituiscilo account-id con l'ID del tuo AWS account e oidc-id con l'ID del provider OIDC del passaggio precedente (la parte successiva). 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. Collegare la policy gestita CloudWatchAgentServerPolicy al ruolo.

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

Per installare il grafico Helm

• Eseguire il seguente comando seguente. Sostituiscilo cluster-name con il nome del tuo cluster Amazon EKS, region con la tua AWS regione e account-id con l'ID AWS del tuo account.

  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

  Importante

  Il parametro otelContainerInsights.enabled è obbligatorio. OTel Container Insights non è abilitato per impostazione predefinita.

Per verificare l'installazione di Helm

1. Verifica che sia visualizzato lo stato di rilascio di Helm. deployed

   helm list -n amazon-cloudwatch

2. Conferma che il pod dell'operatore sia in funzione.

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

3. Verificate che i pod CloudWatch dell'agente siano in esecuzione su tutti i nodi.

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

   Tutti i pod degli agenti devono mostrare lo Running stato.

Per configurare l'integrazione con cert-manager

1. Verifica che cert-manager sia installato nel tuo cluster.

   kubectl get pods -n cert-manager

2. Installa il grafico Helm con cert-manager abilitato. Sostituiscilo cluster-name con il nome del tuo cluster Amazon EKS, region con la tua AWS regione e account-id con l'ID AWS del tuo account.

   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

Per aggiornare il diagramma di Helm

1. Aggiorna il repository Helm per ottenere le versioni più recenti dei grafici.

   helm repo update

2. Esegui il comando di aggiornamento con i valori desiderati. Sostituiscilo cluster-name con il nome del tuo cluster Amazon EKS, region con la tua AWS regione e account-id con l'ID AWS del tuo account.

   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. Verifica che l'aggiornamento sia stato completato correttamente.

   helm list -n amazon-cloudwatch

   Il numero di revisione deve aumentare e lo stato deve essere visualizzato. deployed

Per disinstallare il grafico Helm

1. Esegui il comando seguente per disinstallare la versione.

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

2. Facoltativamente, elimina lo spazio dei nomi se non è più necessario.

   kubectl delete namespace amazon-cloudwatch

Per controllare le metriche in CloudWatch

1. Apri la CloudWatch console all'indirizzo https://console.aws.amazon.com/cloudwatch/.

2. Nel riquadro di navigazione, scegli Container Insights.

3. Verifica che il cluster compaia nell'elenco dei cluster e che i parametri dell'infrastruttura siano compilati.