View a markdown version of this page

Migración de Información de contenedores mejorada (versión clásica) a Información de contenedores de OTel - Amazon CloudWatch
Requisitos previosCambios bruscosPasos para realizar la migraciónVerificaciónReversión

Migración de Información de contenedores mejorada (versión clásica) a Información de contenedores de OTel

Tanto Información de contenedores mejorada (versión clásica) como Información de contenedores de OTel utilizan el mismo complemento amazon-cloudwatch-observability de Amazon EKS. La migración es una actualización interna de la versión del complemento que puede completar en 15 a 30 minutos.

aviso

Las alarmas de CloudWatch configuradas con nombres de métricas clásicas no funcionan automáticamente con las métricas de OTel. Debe volver a crear las alarmas mediante reglas de alarma basadas en PromQL.

Requisitos previos

Antes de comenzar la migración, compruebe que cumple con los siguientes requisitos.

  • Un clúster de Amazon EKS que ejecuta la versión 1.28 de Kubernetes o una posterior

  • El complemento amazon-cloudwatch-observability está instalado y tiene el estado ACTIVE

  • AWS CLI versión 2.15.0 o posterior

  • kubectl configurado para comunicarse con el clúster de destino

  • Un rol de IAM con la política administrada CloudWatchAgentServerPolicy adjunta

Cambios bruscos

Revise los siguientes cambios importantes antes de comenzar la migración.

Características eliminadas

Las siguientes características no están disponibles en Información de contenedores de OTel:

  • Métricas personalizadas de StatsD: en su lugar, utilice el receptor StatsD de OTel.

  • Complemento collectd: migre a la instrumentación nativa de OTel.

Se modificaron los valores predeterminados

En la siguiente tabla se muestran los valores predeterminados que cambian entre la versión clásica e Información de contenedores de OTel.

Opción Valor predeterminado de la versión clásica Valor predeterminado de los componentes de inferencia de OTel
Intervalo de recopilación 60 segundos 60 segundos
Observabilidad mejorada Habilitado Habilitado
Solicitud de CPU del agente 200m 100 m
Solicitud de memoria del agente 200 Mi 128 Mi

Pasos para realizar la migración

Esta migración utiliza un enfoque gradual para minimizar las brechas de supervisión. Debe ejecutar los flujos de métricas de la versión clásica y de OTel en paralelo, validar los datos y, a continuación, desactivar el flujo de la versión clásica.

Fase 1: confirmación del estado actual (solo en versión clásica)

Antes de realizar cambios, confirme el estado actual del complemento y grabe la versión para revertirla.

Confirmación de la configuración actual del complemento

  1. Ejecute el siguiente comando para comprobar el estado actual del complemento.

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

  2. Compruebe que el campo status sea ACTIVE.

  3. Registre el valor de addonVersion. Necesita este valor si debe revertirlo.

Fase 2: activación de la publicación dual (versión clásica + OTel)

Active Información de contenedores de OTel junto con Información de contenedores mejorada (versión clásica). Esto publica ambos flujos de métricas simultáneamente para que pueda validar la equivalencia de los datos.

importante

Ambos flujos de métricas incurren en cargos durante esta fase. Recomendamos mantener la ventana de publicación dual lo más corta posible para minimizar los costos.

Activación de la publicación dual

  1. Ejecute el siguiente comando para actualizar el complemento con los dos flujos activados.

    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. Espere a que el estado del complemento vuelva a ser ACTIVE.

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

  3. Compruebe que las métricas de OTel aparecen en CloudWatch consultando una métrica conocida con PromQL.

Fase 3: nueva creación de las alarmas y actualización de los paneles

Cree reemplazos de OTel para sus alarmas y paneles actuales de la versión clásica. Mantenga las alarmas de la versión clásica activas como red de seguridad durante esta fase.

Nueva creación de las alarmas para las métricas de OTel

  1. Identifique todas las alarmas de CloudWatch que hacen referencia a los nombres de las métricas de Información de contenedores (versión clásica).

  2. Cree alarmas equivalentes mediante expresiones matemáticas de métricas basadas en PromQL que hagan referencia a los nombres de las métricas de OTel.

  3. Compruebe que las nuevas alarmas entren en estado OK y produzcan evaluaciones de umbral equivalentes.

  4. Actualice todos los paneles de CloudWatch para incluir widgets basados en las métricas de OTel junto con los widgets actuales de la versión clásica.

Fase 4: desactivación de la versión clásica (solo el cambio a OTel)

Tras comprobar que las métricas, las alarmas y los paneles de OTel funcionan correctamente, desactive el flujo de la versión clásica.

Desactivación de la versión clásica y conservación solamente de OTel

  1. Ejecute el siguiente comando para desactivar la publicación de métricas de la versión clásica.

    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. Espere a que el estado del complemento vuelva a ser ACTIVE.

  3. Elimine las alarmas de la versión clásica que sustituyó en la fase 3.

Verificación

Tras completar la migración, compruebe que la pila de observabilidad funcione correctamente.

  • Comprobación de las métricas en Query Studio: utilice las consultas de PromQL para confirmar que las métricas provengan de la canalización de OTel.

  • Comparación con los valores de referencia: compruebe que los valores de las métricas sean coherentes con las métricas de la versión clásica que registró durante la fase 2.

  • Verifique los paneles de Información de contenedores: confirme que la consola de Información de contenedores muestre los datos del clúster.

  • Verificación de la entrega de registros: compruebe que los registros del contenedor sigan apareciendo en Registros de CloudWatch.

  • Verificación de las alarmas: confirme que no haya ninguna alarma con el estado INSUFFICIENT_DATA.

Reversión

Si tiene problemas después de la migración, puede restaurar la configuración anterior de la versión clásica.

Regresión a Información de contenedores mejorada (versión clásica)

  1. Identifique la versión anterior del complemento que grabó en la fase 1.

  2. Ejecute el siguiente comando para reducir la versión del complemento.

    aws eks update-addon \
  --cluster-name cluster-name \
  --addon-name amazon-cloudwatch-observability \
  --addon-version previous-version \
  --resolve-conflicts OVERWRITE

  3. Espere a que el estado del complemento vuelva a ser ACTIVE.

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

  4. Vuelva a aplicar los valores de configuración personalizados que utilizó en la versión anterior.