Aktualisieren Sie auf die erforderlichen Versionen der Agenten oder des EKS Amazon-Add-ons - Amazon CloudWatch
Aktualisieren Sie das Amazon CloudWatch Observability-Add-on EKSAktualisieren Sie den CloudWatch Agenten und den ADOT Agenten

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.

Aktualisieren Sie auf die erforderlichen Versionen der Agenten oder des EKS Amazon-Add-ons

Nach dem 9. August 2024 wird CloudWatch Application Signals ältere Versionen des Amazon CloudWatch EKS Observability-Add-ons, des Agenten und des CloudWatch Agenten AWS Distro for OpenTelemetry Auto-Instrumentation nicht mehr unterstützen.

  • Für das Amazon CloudWatch EKS Observability-Add-on werden Versionen, die älter sind als, v1.7.0-eksbuild.1 nicht unterstützt.

  • Für den CloudWatch Agenten werden Versionen, die älter sind als, 1.300040.0 nicht unterstützt.

  • Für den Agenten AWS Distro for OpenTelemetry Auto-Instrumentation:

    • Für Java werden Versionen, die älter 1.32.2 sind als, nicht unterstützt.

    • Für Python werden Versionen älter als 0.2.0 nicht unterstützt.

    • Für. NET, Versionen, die älter 1.3.2 sind als, werden nicht unterstützt.

    • Für Node.js werden Versionen, die älter 0.3.0 sind als, nicht unterstützt.

Wichtig

Die neuesten Versionen der Agents enthalten Aktualisierungen des Application Signals-Metrikschemas. Diese Updates sind nicht abwärtskompatibel, und dies kann zu Datenproblemen führen, wenn inkompatible Versionen verwendet werden. Gehen Sie wie folgt vor, um einen reibungslosen Übergang zu den neuen Funktionen sicherzustellen:

  • Wenn Ihre Anwendung auf Amazon läuft, stellen Sie sicherEKS, dass Sie alle instrumentierten Anwendungen neu starten, nachdem Sie das Amazon CloudWatch Observability-Add-on aktualisiert haben.

  • Achten Sie bei Anwendungen, die auf anderen Plattformen ausgeführt werden, darauf, sowohl den CloudWatch Agenten als auch den Agenten für AWS OpenTelemetry automatische Instrumentierung auf die neuesten Versionen zu aktualisieren.

Die Anweisungen in den folgenden Abschnitten können Ihnen bei der Aktualisierung auf eine unterstützte Version helfen.

Aktualisieren Sie das Amazon CloudWatch Observability-Add-on EKS

Zum Amazon CloudWatch EKS Observability-Add-on können Sie das AWS Management Console oder das AWS CLI verwenden.

Verwenden der Konsole

Um das Add-on über die Konsole zu aktualisieren

  1. Öffnen Sie die EKS Amazon-Konsole unter https://console.aws.amazon.com/eks/home#/clusters.

  2. Wählen Sie den Namen des EKS Amazon-Clusters, das aktualisiert werden soll.

  3. Wählen Sie den Tab Add-ons und anschließend Amazon CloudWatch Observability.

  4. Wählen Sie Bearbeiten, wählen Sie die Version aus, auf die Sie aktualisieren möchten, und wählen Sie dann Änderungen speichern.

    Stellen Sie sicher, dass Sie v1.7.0-eksbuild.1 oder später wählen.

  5. Geben Sie einen der folgenden AWS CLI Befehle ein, um Ihre Dienste neu zu starten.

      # Restart a deployment
  kubectl rollout restart deployment/name
  # Restart a daemonset
  kubectl rollout restart daemonset/name
  # Restart a statefulset
  kubectl rollout restart statefulset/name

Verwenden Sie den AWS CLI

Um das Add-on mit dem zu aktualisieren AWS CLI

  1. Geben Sie den folgenden Befehl ein, um die neueste Version zu finden.

    aws eks describe-addon-versions \
--addon-name amazon-cloudwatch-observability

  2. Geben Sie den folgenden Befehl ein, um das Add-on zu aktualisieren. Ersetzen $VERSION mit einer aktuellen Version v1.7.0-eksbuild.1 oder einer späteren Version. Ersetzen $AWS_REGION and $CLUSTER mit Ihrer Region und Ihrem Clusternamen.

    aws eks update-addon \
--region $AWS_REGION \
--cluster-name $CLUSTER \
--addon-name amazon-cloudwatch-observability \
--addon-version $VERSION \
# required only if the advanced configuration is used.
--configuration-values $JSON_CONFIG
    Anmerkung

    Wenn Sie eine benutzerdefinierte Konfiguration für das Add-on verwenden, finden Sie ein Beispiel für die Konfiguration, die Sie verwenden können $JSON_CONFIG in CloudWatch Anwendungssignale aktivieren erlauben.

  3. Geben Sie einen der folgenden AWS CLI Befehle ein, um Ihre Dienste neu zu starten.

      # Restart a deployment
  kubectl rollout restart deployment/name
  # Restart a daemonset
  kubectl rollout restart daemonset/name
  # Restart a statefulset
  kubectl rollout restart statefulset/name

Aktualisieren Sie den CloudWatch Agenten und den ADOT Agenten

Wenn Ihre Dienste auf anderen Architekturen als Amazon ausgeführt werdenEKS, müssen Sie sowohl den CloudWatch Agenten als auch den Agenten für ADOT automatische Instrumentierung aktualisieren, um die neuesten Funktionen von Application Signals nutzen zu können.

Update bei Amazon ECS

So aktualisieren Sie Ihre Agenten für Dienste, die auf Amazon ausgeführt werden ECS

  1. Erstellen Sie eine neue Version der Aufgabendefinition. Weitere Informationen finden Sie unter Aktualisieren einer Aufgabendefinition mithilfe der Konsole.

  2. Ersetzen Sie das $IMAGE des ecs-cwagent Containers durch das neueste Image-Tag von cloudwatch-agent bei Amazon. ECR

    Wenn Sie ein Upgrade auf eine feste Version durchführen, stellen Sie sicher, dass Sie eine Version verwenden, die der Version entspricht oder eine neuere Version als ist. 1.300040.0

  3. Ersetzen Sie das $IMAGE des init Containers durch das neueste Image-Tag aus den folgenden Speicherorten:

    • Verwenden Sie für Java adot-autoinstrumentation-javaaws-observability/.

      Wenn Sie ein Upgrade auf eine feste Version durchführen, stellen Sie sicher, dass Sie eine Version verwenden, die der Version entspricht oder eine neuere Version als ist. 1.32.2

    • Verwenden Sie für Python adot-autoinstrumentation-pythonaws-observability/.

      Wenn Sie ein Upgrade auf eine feste Version durchführen, stellen Sie sicher, dass Sie eine Version verwenden, die mindestens der Version entspricht. 0.2.0

    • Für. NET, verwenden Sie aws-observability/ adot-autoinstrumentation-dotnet.

      Wenn Sie ein Upgrade auf eine feste Version durchführen, stellen Sie sicher, dass Sie eine Version verwenden, die der Version entspricht oder eine neuere Version als ist. 1.3.2

    • Verwenden Sie für Node.js adot-autoinstrumentation-nodeaws-observability/.

      Wenn Sie ein Upgrade auf eine feste Version durchführen, stellen Sie sicher, dass Sie eine Version verwenden, die der Version entspricht oder eine neuere Version als ist. 0.3.0

  4. Aktualisieren Sie die Umgebungsvariablen von Application Signals in Ihrem App-Container, indem Sie den Anweisungen unter folgenSchritt 4: Kommunizieren Sie Ihre Bewerbung mit dem CloudWatch Agenten.

  5. Stellen Sie Ihren Service mit der neuen Aufgabendefinition bereit.

Update auf Amazon EC2 oder anderen Architekturen

Um Ihre Agenten für Dienste zu aktualisieren, die auf Amazon EC2 oder anderen Architekturen ausgeführt werden

  1. Folgen Sie den Anweisungen unter Laden Sie das CloudWatch Agentenpaket herunter und aktualisieren Sie den CloudWatch Agenten auf die neueste Version. Achten Sie darauf, Version 1.300040.0 oder höher auszuwählen.

  2. Laden Sie die neueste Version des Agenten AWS Distro for OpenTelemetry Auto-Instrumentation von einem der folgenden Orte herunter:

    • Verwenden Sie für Java. aws-otel-java-instrumentation

      Wenn Sie ein Upgrade auf eine feste Version durchführen, wählen Sie unbedingt 1.32.2 oder später.

    • Verwenden Sie für Python aws-otel-python-instrumentation .

      Wenn Sie ein Upgrade auf eine feste Version durchführen, wählen Sie unbedingt 0.2.0 oder später.

    • Für. NET, benutzen aws-otel-dotnet-instrumentation.

      Wenn Sie ein Upgrade auf eine feste Version durchführen, wählen Sie unbedingt 1.3.2 oder später.

    • Verwenden Sie für Node.js aws-otel-js-instrumentation.

      Wenn Sie ein Upgrade auf eine feste Version durchführen, achten Sie darauf, 0.3.0 oder später zu wählen.

  3. Wenden Sie die aktualisierten Umgebungsvariablen von Application Signals auf Ihre Anwendung an und starten Sie dann Ihre Anwendung. Weitere Informationen finden Sie unter Schritt 3: Ihre Anwendung instrumentieren und starten.