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. # Migrieren Sie von Enhanced Container Insights (Classic) zu oTEL Container Insights Sowohl Enhanced Container Insights (Classic) als auch OTel Container Insights verwenden dasselbe `amazon-cloudwatch-observability` Amazon EKS-Add-on. Bei der Migration handelt es sich um ein direktes Add-On-Versionsupdate, das Sie in 15—30 Minuten abschließen können. **Warnung** CloudWatch Alarme, die mit klassischen Metriknamen konfiguriert sind, funktionieren nicht automatisch mit oTEL-Metriken. Sie müssen Alarme mithilfe von PromQL-based Alarmregeln neu erstellen. ## Voraussetzungen Bevor Sie mit der Migration beginnen, stellen Sie sicher, dass Sie die folgenden Anforderungen erfüllen. + Ein Amazon EKS-Cluster mit Kubernetes Version 1.28 oder höher + Das `amazon-cloudwatch-observability` Add-on ist installiert und befindet sich im Status `ACTIVE` + AWS CLI Version 2.15.0 oder höher + `kubectl`konfiguriert für die Kommunikation mit Ihrem Zielcluster + Eine IAM-Rolle mit angehängter `CloudWatchAgentServerPolicy` verwalteter Richtlinie ## Abwärtskompatible Änderungen Überprüfen Sie die folgenden grundlegenden Änderungen, bevor Sie mit der Migration beginnen. ### Funktionen wurden entfernt Die folgenden Funktionen sind in oTEL Container Insights nicht verfügbar: + **Benutzerdefinierte StatsD-Metriken** — Verwenden Sie stattdessen den oTEL StatsD-Empfänger. + **Collectd-Plugin** — Migration zur Instrumentierung. OTel-native ### Standardwerte wurden geändert Die folgende Tabelle zeigt Standardwerte, die sich zwischen Classic und oTEL Container Insights ändern. | Einstellung | Klassischer Standard | Standard für Hotel-IC | | --- | --- | --- | | Erfassungsintervall | 60 Sekunden | 60 Sekunden | | Verbesserte Beobachtbarkeit | Aktiviert | Aktiviert | | CPU-Anfrage des Agenten | 200m | 100 m | | Speicheranforderung für Agenten | 200 Mi | 128 Meilen | ## Schritte zur Migration Bei dieser Migration wird ein schrittweiser Ansatz verwendet, um Überwachungslücken zu minimieren. Sie führen sowohl Classic- als auch OTel-Metrik-Streams parallel aus, validieren die Daten und deaktivieren dann den Classic-Stream. ### Phase 1: Bestätigen Sie den aktuellen Status (nur Classic) Bevor Sie Änderungen vornehmen, überprüfen Sie Ihren aktuellen Status des Add-ons und zeichnen Sie die Version für das Rollback auf. **Um Ihre aktuelle Add-On-Konfiguration zu bestätigen** 1. Führen Sie den folgenden Befehl aus, um den aktuellen Status des Add-ons zu überprüfen. ``` aws eks describe-addon \ --cluster-name {{cluster-name}} \ --addon-name amazon-cloudwatch-observability ``` 1. Stellen Sie sicher, dass das `status` `ACTIVE` Feld 1. Notieren Sie den `addonVersion` Wert. Sie benötigen diesen Wert, wenn Sie ein Rollback durchführen müssen. ### Phase 2: Aktivieren Sie das duale Publizieren (Classic \+ OTel) Aktivieren Sie OTel Container Insights zusammen mit Enhanced Container Insights (Classic). Dadurch werden beide Metrik-Streams gleichzeitig veröffentlicht, sodass Sie die Datenäquivalenz überprüfen können. **Wichtig** Für beide metrischen Streams fallen in dieser Phase Gebühren an. Wir empfehlen, das doppelte Veröffentlichungsfenster so kurz wie möglich zu halten, um die Kosten zu minimieren. **Um duales Publizieren zu ermöglichen** 1. Führen Sie den folgenden Befehl aus, um das Add-on zu aktualisieren, wobei beide Streams aktiviert sind. ``` aws eks update-addon \ --cluster-name {{cluster-name}} \ --addon-name amazon-cloudwatch-observability \ --addon-version {{latest-version}} \ --configuration-values '{"containerInsights":{"enabled":true},"otelContainerInsights":{"enabled":true}}' \ --resolve-conflicts OVERWRITE ``` 1. Warten Sie, bis der Status des Add-ons wieder angezeigt wird`ACTIVE`. ``` aws eks describe-addon \ --cluster-name {{cluster-name}} \ --addon-name amazon-cloudwatch-observability \ --query "addon.status" ``` 1. Stellen Sie sicher, dass oTEL-Metriken angezeigt werden, CloudWatch indem Sie eine bekannte Metrik mit PromQL abfragen. ### Phase 3: Alarme neu erstellen und Dashboards aktualisieren Erstellen Sie Otel-Ersatzprodukte für Ihre bestehenden Classic-Alarme und -Dashboards. Sorgen Sie dafür, dass die Classic-Alarme während dieser Phase als Sicherheitsnetz aktiv bleiben. **Um Alarme für oTel-Metriken neu zu erstellen** 1. Identifizieren Sie alle CloudWatch Alarme, die auf die Metriknamen von Classic Container Insights verweisen. 1. Erstellen Sie äquivalente Alarme mithilfe PromQL-based metrischer mathematischer Ausdrücke, die auf oTEL-Metriknamen verweisen. 1. Stellen Sie sicher, dass die neuen Alarme in den `OK` Status wechseln und entsprechende Schwellenwertauswertungen liefern. 1. Aktualisieren Sie alle CloudWatch Dashboards so, dass sie neben den bestehenden Classic-Widgets auch Widgets enthalten, die auf oTEL-Metriken basieren. ### Phase 4: Classic deaktivieren (nur zu oTEL wechseln) Nachdem Sie überprüft haben, dass die oTEL-Metriken, Alarme und Dashboards ordnungsgemäß funktionieren, deaktivieren Sie den Classic-Stream. **Um Classic zu deaktivieren und nur oTEL beizubehalten** 1. Führen Sie den folgenden Befehl aus, um die Veröffentlichung von Classic-Metriken zu deaktivieren. ``` aws eks update-addon \ --cluster-name {{cluster-name}} \ --addon-name amazon-cloudwatch-observability \ --configuration-values '{"containerInsights":{"enabled":false},"otelContainerInsights":{"enabled":true}}' \ --resolve-conflicts OVERWRITE ``` 1. Warten Sie, bis der Status des Add-ons wieder angezeigt wird`ACTIVE`. 1. Entfernen Sie die klassischen Alarme, die Sie in Phase 3 ersetzt haben. ## Verifizierung Stellen Sie nach Abschluss der Migration sicher, dass Ihr Observability-Stack ordnungsgemäß funktioniert. + **Überprüfen Sie die Metriken in Query Studio** — Verwenden Sie PromQL-Abfragen, um zu bestätigen, dass die Metriken aus der OTel-Pipeline stammen. + **Mit Basiswerten vergleichen** — Stellen Sie sicher, dass die Metrikwerte mit den Classic-Metriken übereinstimmen, die Sie in Phase 2 aufgezeichnet haben. + **Container Insights-Dashboards verifizieren** — Vergewissern Sie sich, dass die Container Insights-Konsole Daten für Ihren Cluster anzeigt. + **Protokollzustellung überprüfen** — Stellen Sie sicher, dass Container-Logs weiterhin in CloudWatch Logs angezeigt werden. + **Alarme überprüfen** — Stellen Sie sicher, dass keine Alarme `INSUFFICIENT_DATA` aktiviert sind. ## Rollback Wenn nach der Migration Probleme auftreten, können Sie die vorherige Classic-Konfiguration wiederherstellen. **Um zu Enhanced Container Insights (Classic) zurückzukehren** 1. Identifizieren Sie die vorherige Add-On-Version, die Sie in Phase 1 aufgenommen haben. 1. Führen Sie den folgenden Befehl aus, um das Add-on herunterzustufen. ``` aws eks update-addon \ --cluster-name {{cluster-name}} \ --addon-name amazon-cloudwatch-observability \ --addon-version {{previous-version}} \ --resolve-conflicts OVERWRITE ``` 1. Warten Sie, bis der Status des Add-ons wieder angezeigt wird. `ACTIVE` ``` aws eks describe-addon \ --cluster-name {{cluster-name}} \ --addon-name amazon-cloudwatch-observability \ --query "addon.status" ``` 1. Re-apply alle benutzerdefinierten Konfigurationswerte, die Sie mit der vorherigen Version verwendet haben.