Actualización a las versiones requeridas de los agentes o del complemento de Amazon EKS - Amazon CloudWatch
Actualice el complemento de observabilidad de EKS de Amazon CloudWatchActualización del agente de CloudWatch y el agente de ADOT

Actualización a las versiones requeridas de los agentes o del complemento de Amazon EKS

A partir del 9 de agosto de 2024, CloudWatch Application Signals ya no será compatible con las versiones anteriores del complemento de observabilidad de EKS de Amazon CloudWatch, el agente de CloudWatch y el agente de autoinstrumentación de AWS Distro para OpenTelemetry.

  • En el caso del complemento de observabilidad de EKS de Amazon CloudWatch, las versiones anteriores a v1.7.0-eksbuild.1 no serán compatibles.

  • En el caso del agente de CloudWatch, las versiones anteriores a 1.300040.0 no serán compatibles.

  • Para el agente de autoinstrumentación de AWS Distro para OpenTelemetry:

    • Para Java, las versiones anteriores a 1.32.2 no serán compatibles.

    • Para Python, las versiones anteriores a 0.2.0 no serán compatibles.

    • Para .NET, las versiones anteriores a 1.3.2 no serán compatibles.

    • En el caso de Node.js, las versiones anteriores a 0.3.0 no son compatibles.

importante

Las versiones más recientes de los agentes incluyen actualizaciones del esquema de métrica de Application Signals. Estas actualizaciones no son compatibles con versiones anteriores y esto puede provocar problemas de datos si se utilizan versiones incompatibles. Para garantizar una transición sin problemas a la nueva funcionalidad, haga lo siguiente:

  • Si su aplicación se ejecuta en Amazon EKS, asegúrese de reiniciar todas las aplicaciones instrumentadas después de actualizar el complemento de observabilidad de Amazon CloudWatch.

  • En el caso de las aplicaciones que se ejecutan en otras plataformas, asegúrese de actualizar ambos agentes, el de CloudWatch y el de autoinstrumentación de AWS OpenTelemetry, a las versiones más recientes.

Con las instrucciones de las siguientes secciones, pueden actualizar a una versión compatible.

Actualice el complemento de observabilidad de EKS de Amazon CloudWatch

Para el complemento de observabilidad de EKS de Amazon CloudWatch, puede utilizar la AWS Management Console o la AWS CLI.

Uso de la consola

Actualización del complemento con la consola

  1. Abra la consola de Amazon EKS en https://console.aws.amazon.com/eks/home#/clusters.

  2. Seleccione el nombre del clúster de Amazon EKS que desea actualizar.

  3. Seleccione la pestaña Complementos y, a continuación, Observabilidad de Amazon CloudWatch.

  4. Seleccione Editar, luego la versión a la que desee actualizar y, a continuación, Guardar cambios.

    Asegúrese de elegir la versión v1.7.0-eksbuild.1 o posterior.

  5. Ingrese uno de los siguientes comandos de AWS CLI para reiniciar los servicios.

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

Utilizar la AWS CLI

Actualización del complemento con la AWS CLI

  1. Ingrese el siguiente comando para encontrar la versión más reciente.

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

  2. Ingrese el siguiente comando para actualizar el complemento. Sustituya $VERSION por la versión v1.7.0-eksbuild.1 o una posterior. Sustituya $AWS_REGION y $CLUSTER por su región y nombre de clúster.

    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
    nota

    Si utiliza una configuración personalizada para el complemento, puede encontrar un ejemplo de la configuración que se debe usar para $JSON_CONFIG en Habilitación de CloudWatch Application Signals.

  3. Ingrese uno de los siguientes comandos de AWS CLI para reiniciar los servicios.

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

Actualización del agente de CloudWatch y el agente de ADOT

Si sus servicios se ejecutan en arquitecturas distintas de Amazon EKS, tendrá que actualizar tanto el agente CloudWatch como el agente de autoinstrumentación de ADOT para utilizar las características más recientes de Application Signals.

Actualización sobre Amazon ECS

Actualización de sus agentes para los servicios que se ejecutan en Amazon ECS

  1. Cree una revisión de definición de tarea. Para más información, consulte Updating a task definition using the console.

  2. Sustituya el $IMAGE del contenedor ecs-cwagent por la etiqueta de imagen más reciente de cloudwatch-agent en Amazon ECR.

    Si actualiza a una versión fija, asegúrese de usar la versión 1.300040.0 o una posterior.

  3. Sustituya la etiqueta $IMAGE del contenedor init por la imagen más reciente de las siguientes ubicaciones:

  4. Actualice las variables del entorno de Application Signals en el contenedor de su aplicación con las instrucciones que se encuentran en Paso 4: instrumentar la aplicación con el agente de CloudWatch.

  5. Implemente el servicio con la nueva definición de tareas.

Actualización sobre Amazon EC2 u otras arquitecturas

Actualización de los agentes para los servicios que se ejecutan en Amazon EC2 u otras arquitecturas

  1. Siga las instrucciones en Descargue del paquete de del agente de CloudWatch y actualice el agente de CloudWatch a la versión más reciente. Asegúrese de seleccionar la versión 1.300040.0 o una posterior.

  2. Descargue la última versión del agente de autoinstrumentación de AWS Distro para OpenTelemetry desde una de las siguientes ubicaciones:

  3. Aplique las variables de entorno de Application Signals actualizadas a su aplicación y, a continuación, iníciela. Para obtener más información, consulte Paso 3: instrumentar la aplicación e iníciela.