View a markdown version of this page

Migre do Enhanced Container Insights (Classic) para o OTel Container Insights - Amazon CloudWatch
Pré-requisitosAlterações que podem causar interrupçõesEtapas da migraçãoVerificaçãoReversão

Migre do Enhanced Container Insights (Classic) para o OTel Container Insights

Tanto o Enhanced Container Insights (Classic) quanto o OTel Container Insights usam o mesmo complemento Amazon EKS amazon-cloudwatch-observability. A migração é uma atualização de versão do complemento instalado que você pode concluir em 15 a 30 minutos.

Atenção

Os alarmes do CloudWatch configurados com nomes de métricas Classic não funcionam automaticamente com as métricas do OTel. Você deve recriar os alarmes usando regras baseadas em PromQL.

Pré-requisitos

Antes de começar a migração, certifique-se de cumprir os requisitos a seguir.

  • Um cluster do Amazon EKS que executa a versão 1.28 ou versões posteriores do Kubernetes

  • O complemento amazon-cloudwatch-observability instalado e em status ACTIVE

  • AWS CLI versão 2.15.0 ou posterior

  • kubectl configurado para comunicar-se com o cluster de destino

  • Um perfil do IAM com a política gerenciada CloudWatchAgentServerPolicy anexada

Alterações que podem causar interrupções

Analise as seguintes alterações importantes antes de começar a migração.

Recursos removidos

Os seguintes recursos não estão disponíveis no OTel Container Insights:

  • Métricas personalizadas do StatsD: em vez disso, use o receptor OTel StatsD.

  • Plug-in collectd: migre para a instrumentação nativa do OTel.

Padrões alterados

A tabela a seguir mostra os valores padrão que mudam entre o Classic e OTel Container Insights.

Configuração Padrão do Classic Padrão do OTel CI
Intervalo da coleta 60 segundos 60 segundos
Observabilidade aprimorada Habilitado Habilitado
Solicitação de CPU do atendente 200 m 100 m
Solicitação de memória do atendente 200 Mi 128 milhões

Etapas da migração

Essa migração usa uma abordagem em fases para minimizar as lacunas de monitoramento. Você executa os fluxos de métricas Classic e OTel em paralelo, valida os dados e depois desativa o fluxo Classic.

Fase 1: confirme o estado atual (somente Classic)

Antes de fazer alterações, confirme o estado atual do complemento e registre a versão para reversão.

Para confirmar sua configuração atual do complemento

  1. Execute o comando a seguir para verificar o status atual do complemento.

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

  2. Verifique se o campo status está ACTIVE.

  3. Registre o valor addonVersion. Você precisará desse valor se precisar reverter.

Fase 2: ative a publicação dupla (Classic + OTel)

Ative o OTel Container Insights junto com o Enhanced Container Insights (Classic). Isso publica os dois fluxos de métricas simultaneamente para que você possa validar a equivalência de dados.

Importante

Ambos os fluxos de métricas incorrem em cobranças durante essa fase. Recomendamos manter a janela dupla de publicação pelo menor tempo possível para minimizar os custos.

Para habilitar a publicação dupla

  1. Execute o comando a seguir para atualizar o complemento com os dois fluxos habilitados.

    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. Aguarde até que o status do complemento retorne para ACTIVE.

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

  3. Verifique se as métricas do OTel aparecem no CloudWatch consultando uma métrica conhecida com o PromQL.

Fase 3: recrie alarmes e atualize painéis

Crie substitutos do OTel para seus alarmes e painéis Classic existentes. Mantenha os alarmes Classic ativos como uma rede de segurança durante esta fase.

Para recriar alarmes para métricas do OTel

  1. Identifique todos os alarmes do CloudWatch que fazem referência aos nomes das métricas do Classic Container Insights.

  2. Crie alarmes equivalentes usando expressões de matemática de métricas baseadas em PromQL que fazem referência a nomes de métricas OTel.

  3. Verifique se os novos alarmes entram no estado OK e produzem avaliações de limite equivalentes.

  4. Atualize qualquer painel do CloudWatch para incluir widgets com base nas métricas do OTel junto com os widgets Classic existentes.

Fase 4: desative o Classic (mudar para somente OTel)

Depois de validar se as métricas, os alarmes e os painéis do OTel funcionam corretamente, desative o fluxo Classic.

Para desativar o Classic e manter somente o OTel

  1. Execute o comando a seguir para desativar a publicação de métricas Classic.

    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. Aguarde até que o status do complemento retorne para ACTIVE.

  3. Remova os alarmes Classic que você substituiu na Fase 3.

Verificação

Depois de concluir a migração, verifique se sua pilha de observabilidade está funcionando corretamente.

  • Verifique as métricas no Query Studio: use as consultas do PromQL para confirmar se as métricas fluem do pipeline do OTel.

  • Compare com os valores da linha de base: verifique se os valores das métricas são consistentes com as métricas Classic que você registrou durante a Fase 2.

  • Verifique os painéis do Container Insights: confirme se o console do Container Insights exibe os dados do seu cluster.

  • Verifique a entrega do log: verifique se os logs do contêiner continuam aparecendo no CloudWatch Logs.

  • Verifique os alarmes: confirme se não há alarmes no estado INSUFFICIENT_DATA.

Reversão

Se você encontrar problemas após a migração, poderá restaurar a configuração Classic anterior.

Para reverter para o Enhanced Container Insights (Classic)

  1. Identifique a versão anterior do complemento que você registrou na Fase 1.

  2. Execute o seguinte comando para fazer downgrade do complemento.

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

  3. Aguarde até que o status do complemento retorne para ACTIVE.

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

  4. Reaplique todos os valores de configuração personalizados que você usou com a versão anterior.