View a markdown version of this page

Migrieren Sie von Enhanced Container Insights (Classic) zu oTEL Container Insights - Amazon CloudWatch
VoraussetzungenAbwärtskompatible ÄnderungenSchritte zur MigrationVerifizierungRollback

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

  • kubectlkonfiguriert 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

  2. Stellen Sie sicher, dass das status ACTIVE Feld

  3. 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

  2. Warten Sie, bis der Status des Add-ons wieder angezeigt wirdACTIVE.

    aws eks describe-addon \
  --cluster-name cluster-name \
  --addon-name amazon-cloudwatch-observability \
  --query "addon.status"

  3. 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.

  2. Erstellen Sie äquivalente Alarme mithilfe PromQL-based metrischer mathematischer Ausdrücke, die auf oTEL-Metriknamen verweisen.

  3. Stellen Sie sicher, dass die neuen Alarme in den OK Status wechseln und entsprechende Schwellenwertauswertungen liefern.

  4. 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

  2. Warten Sie, bis der Status des Add-ons wieder angezeigt wirdACTIVE.

  3. 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.

  2. 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

  3. 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"

  4. Re-apply alle benutzerdefinierten Konfigurationswerte, die Sie mit der vorherigen Version verwendet haben.