Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Fehlerbehebung bei Container Insights auf Amazon EKS
<a name="container-insights-eks-troubleshooting"></a>

In diesem Abschnitt werden häufig auftretende Probleme behandelt, die bei der Einrichtung oder dem Betrieb von Container Insights auf Amazon EKS auftreten können. Verwenden Sie die folgenden Tabellen und Diagnosebefehle, um Probleme zu identifizieren und zu lösen, unabhängig davon, ob Sie den OTel- oder den Classic-Ansatz verwenden.

Anleitungen zur spezifischen Einrichtung des Ansatzes finden Sie unter oder. [Schnellstart: oTEL Container Insights auf Amazon EKS](container-insights-eks-otel-quickstart.md) [Anleitung zur Einrichtung (AWS CLI)](container-insights-eks-classic-setup.md) Einen Vergleich der Ansätze finden Sie unter. [Vergleichen Sie die Ansätze von Container Insights](container-insights-eks-compare.md)

## Metriken erscheinen nicht in CloudWatch
<a name="container-insights-eks-troubleshooting-metrics"></a>

Wenn Sie im `ContainerInsights` Namespace keine Metriken sehen, verwenden Sie die folgende Tabelle, um die Ursache zu ermitteln.


| Symptom | Ursache | Auflösung | 
| --- | --- | --- | 
| Keine Metriken im Namespace ContainerInsights | Der IAM-Rolle fehlt die Berechtigung cloudwatch:PutMetricData | Hängen Sie die CloudWatchAgentServerPolicy verwaltete Richtlinie an die IAM-Rolle des Agenten an. | 
| Für einige Knoten werden Metriken angezeigt, für andere jedoch nicht | Der Agent DaemonSet wurde aufgrund von Fehlern nicht auf allen Knoten eingeplant | Fügen Sie dem Agenten Toleranzen hinzu, um die Planung auf fehlerhaften Knoten DaemonSet zu ermöglichen. | 
| Metriken werden nicht mehr angezeigt | Der Agent-Pod ist OOM-Kill oder wird neu gestartet | Erhöhen Sie die Speicherlimits in der Ressourcenspezifikation für den Agenten-Pod. | 
| Die Metriken sind veraltet oder Null | Die Netzwerkkonnektivität ist blockiert | Überprüfen Sie die VPC-Sicherheitsgruppen und stellen Sie sicher, dass ein CloudWatch VPC-Endpunkt vorhanden ist. | 
| Verbesserte Metriken fehlen | Der Agent ist nicht für Enhanced Observability konfiguriert | enhancedObservability: trueIn der Agentenkonfiguration festgelegt. | 

## Agenten-Pods werden nicht gestartet
<a name="container-insights-eks-troubleshooting-agent-pods"></a>

Wenn Agent-Pods nicht gestartet werden können oder nicht ausgeführt werden, verwenden Sie die folgende Tabelle, um das Problem zu diagnostizieren.


| Symptom | Ursache | Auflösung | 
| --- | --- | --- | 
| ImagePullBackOff | Amazon ECR ist nicht erreichbar oder das Image-Tag ist falsch | Überprüfen Sie die Image-URI und stellen Sie sicher, dass Ihre Knoten auf Amazon ECR zugreifen können. | 
| Pending | Zu wenig CPU oder Arbeitsspeicher auf dem Knoten | Skalieren Sie die Knotengruppe oder reduzieren Sie die Ressourcenanforderungen in der Agenten-Pod-Spezifikation. | 
| CrashLoopBackOff | Ungültige Konfiguration oder fehlende Volume-Mount | Überprüfen Sie die Pod-Logs auf Konfigurationsfehler, indem Sie es kubectl logs auf dem betroffenen Pod ausführen. | 
| FailedScheduling | Knotenaffinität oder Taints verhindern die Planung | Prüfen Sie die Toleranzen nodeSelector und Toleranzen in der Spezifikation. DaemonSet | 
| Beenden Sie den Code 1 | Dem Dienstkonto fehlt die IRSA-Anmerkung | Stellen Sie sicher, dass das Dienstkonto die eks.amazonaws.com/role-arn Anmerkung enthält. | 

## Add-on Installationsfehler
<a name="container-insights-eks-troubleshooting-addon"></a>

Wenn das `amazon-cloudwatch-observability` Add-on nicht installiert werden kann oder einen fehlerhaften Status meldet, verwenden Sie die folgende Tabelle zur Problembehandlung.


| Symptom | Ursache | Auflösung | 
| --- | --- | --- | 
| CREATE\_FAILED | Widersprüchliche Ressourcen aus einer früheren Installation | Löschen Sie widersprüchliche Ressourcen und verwenden Sie --resolve-conflicts OVERWRITE sie bei der Erstellung des Add-ons. | 
| Der OIDC-Anbieter wurde nicht gefunden | Für den Cluster ist kein IAM-OIDC-Identitätsanbieter vorhanden | Erstellen Sie den Anbieter, indem Sie Folgendes ausführen. eksctl utils associate-iam-oidc-provider | 
| Versionskonflikt | Add-on Version ist nicht mit der Kubernetes-Version kompatibel | Listet kompatible Versionen auf, indem Sie sie ausführen. aws eks describe-addon-versions | 
| DEGRADED-Status | Gesundheitschecks schlagen aufgrund fehlender Berechtigungen fehl | Überprüfen Sie die Pod-Protokolle und stellen Sie sicher, dass der IRSA-Rolle die erforderlichen Richtlinien zugeordnet sind. | 

## Probleme mit der Protokollzustellung
<a name="container-insights-eks-troubleshooting-logs"></a>

Wenn Container-Logs nicht in Amazon CloudWatch Logs erscheinen, verwenden Sie die folgende Tabelle, um die Ursache zu ermitteln.


| Symptom | Ursache | Auflösung | 
| --- | --- | --- | 
| Die Protokollgruppe ist nicht vorhanden | Fehlende logs:CreateLogGroup Erlaubnis | Fügen Sie Amazon CloudWatch Logs-Berechtigungen zur Agenten-IAM-Rolle hinzu. | 
| Die Protokollgruppe ist vorhanden, aber leer | Der Agent ist nicht für Protokolle konfiguriert, oder die Region stimmt nicht überein | Stellen Sie sicher, dass die Agentenkonfiguration die Protokollerfassung beinhaltet und dass die Region mit Ihrer Cluster-Region übereinstimmt. | 
| Protokolle werden um mehr als 5 Minuten verzögert | Das Spülintervall ist zu hoch oder der Knoten ist stark ausgelastet | Reduzieren Sie den force\_flush\_interval Wert in der Agentenkonfiguration. | 
| Leistungsprotokolle fehlen | Der Agent ist nur für Anwendungsprotokolle konfiguriert | Stellen Sie sicher, dass der Abschnitt mit dem Container Insights-Leistungsprotokoll in der Agentenkonfiguration vorhanden ist. | 

## Migration-specific Probleme
<a name="container-insights-eks-troubleshooting-migration"></a>

Wenn bei der Migration zwischen Container Insights-Ansätzen Probleme auftreten, verwenden Sie die folgende Tabelle. Den vollständigen Migrations-Workflow finden Sie unter[Migrationshandbücher](container-insights-eks-migration-hub.md).


| Symptom | Ursache | Auflösung | 
| --- | --- | --- | 
| Doppelte Metriken während des Parallellaufs | Bei beiden Ansätzen werden Metriken gleichzeitig veröffentlicht | Dieses Verhalten wird bei einem Parallellauf erwartet. Deaktivieren Sie den alten Ansatz, nachdem Sie den neuen Ansatz validiert haben. | 
| Unterschiedliche Metrikwerte zwischen den Ansätzen | Verschiedene Berechnungsmethoden | Geringe Unterschiede (weniger als 5%) werden erwartet. Große Unterschiede deuten auf ein Konfigurationsgefälle zwischen den Ansätzen hin. | 
| Das Rollback schlägt fehl | Die benutzerdefinierte Konfiguration wurde nicht erneut angewendet | Re-apply Ihre vollständigen Konfigurationswerte, wenn Sie ein Rollback durchführen. | 
| Während der Migration werden Alarme ausgelöst | Metrische Lücken während der Umstellungsphase | Stellen Sie die Behandlung fehlender Daten vorübergehend notBreaching auf „Bei betroffenen Alarmen“ ein. | 

## Probleme mit oTEL Container Insights
<a name="container-insights-eks-troubleshooting-otel"></a>

Die folgenden Probleme beziehen sich speziell auf den Ansatz von oTEL Container Insights. Allgemeine Hinweise zur Einrichtung finden Sie unter[Schnellstart: oTEL Container Insights auf Amazon EKS](container-insights-eks-otel-quickstart.md).


| Symptom | Ursache | Auflösung | 
| --- | --- | --- | 
| 403 Forbidden Exporter-Fehler | In der IAM-Rolle fehlen Berechtigungen CloudWatch  | Stellen Sie sicher, dass der an die Agentenrolle angehängt CloudWatchAgentServerPolicy ist. | 
| Die Verbindung wurde am Metrik-Endpunkt verweigert | Collector kann das Kubelet nicht erreichen | Vergewissern Sie hostNetwork: true sich, dass dies in der Pod-Spezifikation festgelegt ist, oder stellen Sie sicher, dass das Dienstkonto über die erforderlichen Berechtigungen verfügt. | 
| Hohe Speicherauslastung | Die Warteschlange für die Batch-Verarbeitung ist zu groß | Reduzieren Sie die batch/send\_batch\_size Werte batch/timeout und in der Collector-Konfiguration. | 
| Benutzerdefinierte Metriken werden nicht angezeigt | Receiver ist nicht für den Anwendungsendpunkt konfiguriert | Fügen Sie in der Collector-Konfiguration einen Prometheus-Empfänger hinzu, der auf Ihren Port für Anwendungsmetriken abzielt. | 

## Allgemeine Diagnosebefehle
<a name="container-insights-eks-troubleshooting-commands"></a>

Verwenden Sie die folgenden Befehle, um Informationen über Ihre Container Insights-Bereitstellung zu sammeln.

Führen Sie den folgenden Befehl aus, um den Status des Agenten-Pods zu überprüfen.

```
kubectl get pods -n amazon-cloudwatch
```

Führen Sie den folgenden Befehl aus, um Agenten-Pod-Logs anzuzeigen.

```
kubectl logs -n amazon-cloudwatch -l app.kubernetes.io/name=cloudwatch-agent --tail=50
```

Führen Sie den folgenden Befehl aus, um den DaemonSet Agentenstatus zu überprüfen.

```
kubectl get daemonset -n amazon-cloudwatch
```

Führen Sie den folgenden Befehl aus, um die IAM-Rolle für ein Dienstkonto zu überprüfen.

```
kubectl get serviceaccount -n amazon-cloudwatch -o yaml
```

Führen Sie den folgenden Befehl aus, um den Status des Cluster-Add-ons zu überprüfen. {{cluster-name}}Ersetzen Sie durch den Namen Ihres Amazon EKS-Clusters.

```
aws eks describe-addon --cluster-name {{cluster-name}} --addon-name amazon-cloudwatch-observability
```

Führen Sie den folgenden Befehl aus, um Container Insights-Protokollgruppen aufzulisten. {{cluster-name}}Ersetzen Sie durch den Namen Ihres Amazon EKS-Clusters.

```
aws logs describe-log-groups --log-group-name-prefix "/aws/containerinsights/{{cluster-name}}"
```

## Zugehörige Ressourcen
<a name="container-insights-eks-troubleshooting-related"></a>

Weitere Informationen zur Einrichtung und zum Betrieb von Container Insights auf Amazon EKS finden Sie in den folgenden Themen.
+ [Schnellstart: oTEL Container Insights auf Amazon EKS](container-insights-eks-otel-quickstart.md)— Otel Container Insights einrichten
+ [Anleitung zur Einrichtung (AWS CLI)](container-insights-eks-classic-setup.md)— Richten Sie Classic Container Insights ein
+ [Migrationshandbücher](container-insights-eks-migration-hub.md)— Migrieren Sie zwischen Ansätzen
+ [Vergleichen Sie die Ansätze von Container Insights](container-insights-eks-compare.md)— Vergleichen Sie die Ansätze von Container Insights