Stellen Sie Otel Container Insights mit Helm bereit

Um das Helm-Repository hinzuzufügen

1. Führen Sie den folgenden Befehl aus, um das Repository hinzuzufügen.

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

2. Aktualisieren Sie das Repository, um die neuesten Diagrammversionen zu erhalten.

   helm repo update

Um die IAM-Rolle für den Agenten zu erstellen CloudWatch

1. Rufen Sie die OIDC-Aussteller-URL für Ihren Cluster ab. cluster-nameErsetzen Sie durch den Namen Ihres Amazon EKS-Clusters.

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

2. Erstellen Sie die IAM-Rolle mit einer Vertrauensrichtlinie für IRSA. account-idErsetzen Sie sie durch Ihre AWS Konto-ID und oidc-id durch die OIDC-Anbieter-ID aus dem vorherigen Schritt (den Teil danach). 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. Hängen Sie die von CloudWatchAgentServerPolicy verwaltete Richtlinie an die Rolle an.

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

Um das Helm-Diagramm zu installieren

• Führen Sie den folgenden Befehl aus. cluster-nameErsetzen Sie es durch den Namen Ihres Amazon EKS-Clusters, region durch Ihre AWS Region und account-id durch Ihre AWS Konto-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

  Wichtig

  Der Parameter otelContainerInsights.enabled muss angegeben werden. oTEL Container Insights ist standardmäßig nicht aktiviert.

Um die Helm-Installation zu überprüfen

1. Stellen Sie sicher, dass der Helm-Release-Status angezeigt wirddeployed.

   helm list -n amazon-cloudwatch

2. Vergewissern Sie sich, dass der Operator-Pod läuft.

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

3. Vergewissern Sie sich, dass die CloudWatch Agenten-Pods auf allen Knoten ausgeführt werden.

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

   Alle Agent-Pods müssen Running den Status anzeigen.

Um die Cert-Manager-Integration zu konfigurieren

1. Stellen Sie sicher, dass Cert-Manager in Ihrem Cluster installiert ist.

   kubectl get pods -n cert-manager

2. Installieren Sie das Helm-Diagramm mit aktiviertem Cert-Manager. cluster-nameErsetzen Sie es durch den Namen Ihres Amazon EKS-Clusters, region durch Ihre AWS Region und account-id durch Ihre AWS Konto-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

Um das Helm-Diagramm zu aktualisieren

1. Aktualisieren Sie das Helm-Repository, um die neuesten Diagrammversionen zu erhalten.

   helm repo update

2. Führen Sie den Upgrade-Befehl mit den gewünschten Werten aus. cluster-nameErsetzen Sie es durch den Namen Ihres Amazon EKS-Clusters, region durch Ihre AWS Region und account-id durch Ihre AWS Konto-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. Stellen Sie sicher, dass das Upgrade erfolgreich abgeschlossen wurde.

   helm list -n amazon-cloudwatch

   Die Revisionsnummer muss erhöht werden und der Status muss angezeigt deployed werden.

Um das Helm-Diagramm zu deinstallieren

1. Führen Sie den folgenden Befehl aus, um die Version zu deinstallieren.

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

2. Löschen Sie optional den Namespace, falls er nicht mehr benötigt wird.

   kubectl delete namespace amazon-cloudwatch

Um Metriken einzuchecken CloudWatch

1. Öffnen Sie die CloudWatch Konsole unter https://console.aws.amazon.com/cloudwatch/.

2. Wählen Sie im Navigationsbereich Container Insights aus.

3. Vergewissern Sie sich, dass Ihr Cluster in der Clusterliste erscheint und dass die Infrastrukturmetriken aufgefüllt werden.