Déployez OTel Container Insights avec Helm

Pour ajouter le référentiel Helm

1. Exécutez la commande suivante pour ajouter le référentiel.

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

2. Mettez à jour le référentiel pour obtenir les dernières versions des graphiques.

   helm repo update

Pour créer le rôle IAM pour l'agent CloudWatch

1. Récupérez l'URL de l'émetteur OIDC pour votre cluster. cluster-nameRemplacez-le par le nom de votre cluster Amazon EKS.

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

2. Créez le rôle IAM avec une politique de confiance pour l'IRSA. account-idRemplacez-le par votre identifiant de AWS compte et oidc-id par l'identifiant du fournisseur OIDC de l'étape précédente (la partie suivantehttps://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. Attachez la stratégie gérée par CloudWatchAgentServerPolicy au rôle.

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

Pour installer le graphique Helm

• Exécutez la commande suivante. cluster-nameRemplacez-le par le nom de votre cluster Amazon EKS, region par votre AWS région et account-id par votre identifiant de AWS compte.

  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

  Important

  Le paramètre otelContainerInsights.enabled est obligatoire. OTel Container Insights n'est pas activé par défaut.

Pour vérifier l'installation de Helm

1. Vérifiez que l'état de la version de Helm s'affichedeployed.

   helm list -n amazon-cloudwatch

2. Vérifiez que le module opérateur est en cours d'exécution.

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

3. Vérifiez que les modules d' CloudWatch agent sont en cours d'exécution sur tous les nœuds.

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

   Tous les modules d'agent doivent indiquer Running leur statut.

Pour configurer l'intégration du gestionnaire de certificats

1. Vérifiez que cert-manager est installé dans votre cluster.

   kubectl get pods -n cert-manager

2. Installez le graphique Helm avec le gestionnaire de certificats activé. cluster-nameRemplacez-le par le nom de votre cluster Amazon EKS, region par votre AWS région et account-id par votre identifiant de AWS compte.

   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

Pour mettre à jour le graphique de Helm

1. Mettez à jour le référentiel Helm pour obtenir les dernières versions des graphiques.

   helm repo update

2. Exécutez la commande de mise à niveau avec les valeurs souhaitées. cluster-nameRemplacez-le par le nom de votre cluster Amazon EKS, region par votre AWS région et account-id par votre identifiant de AWS compte.

   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. Vérifiez que la mise à niveau s'est terminée correctement.

   helm list -n amazon-cloudwatch

   Le numéro de révision doit être incrémenté et le statut doit être affichédeployed.

Pour désinstaller le graphique Helm

1. Exécutez la commande suivante pour désinstaller la version.

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

2. Supprimez éventuellement l'espace de noms s'il n'est plus nécessaire.

   kubectl delete namespace amazon-cloudwatch

Pour vérifier les métriques dans CloudWatch

1. Ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.

2. Dans le volet de navigation, choisissez Container Insights.

3. Vérifiez que votre cluster apparaît dans la liste des clusters et que les métriques d'infrastructure sont renseignées.