View a markdown version of this page

Migrazione da Enhanced Container Insights (Classic) a OTel Container Insights - Amazon CloudWatch
PrerequisitiModifiche importantiFasi della migrazioneVerificaRollback

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Migrazione da Enhanced Container Insights (Classic) a OTel Container Insights

Sia Enhanced Container Insights (Classic) che OTel Container Insights utilizzano lo stesso componente aggiuntivo amazon-cloudwatch-observability Amazon EKS. La migrazione è un aggiornamento della versione aggiuntiva in loco che puoi completare in 15-30 minuti.

avvertimento

CloudWatch gli allarmi configurati con i nomi delle metriche Classic non funzionano automaticamente con le metriche di Otel. È necessario ricreare gli allarmi utilizzando le regole degli allarmi. PromQL-based

Prerequisiti

Prima di iniziare la migrazione, verificate di soddisfare i seguenti requisiti.

  • Un cluster Amazon EKS che esegue Kubernetes versione 1.28 o successiva

  • Il amazon-cloudwatch-observability componente aggiuntivo è installato e in stato ACTIVE

  • AWS CLI versione 2.15.0 o successiva

  • kubectlconfigurato per comunicare con il cluster di destinazione

  • Un ruolo IAM con la policy CloudWatchAgentServerPolicy gestita allegata

Modifiche importanti

Esamina le seguenti modifiche sostanziali prima di iniziare la migrazione.

Funzionalità rimosse

Le seguenti funzionalità non sono disponibili in Otel Container Insights:

  • Metriche personalizzate StatsD: utilizzate invece il ricevitore Otel StatSD.

  • plugin collectd — Migra alla strumentazione. OTel-native

Impostazioni predefinite modificate

La tabella seguente mostra i valori predefiniti che cambiano tra Classic e Otel Container Insights.

Impostazione Impostazione predefinita classica Otel IC (impostazione predefinita)
Intervallo di raccolta 60 secondi 60 secondi
Osservabilità migliorata Abilitato Abilitato
Richiesta della CPU dell'agente 200 m 100 m
Richiesta di memoria per l'agente 200 Min 128 Mi

Fasi della migrazione

Questa migrazione utilizza un approccio graduale per ridurre al minimo le lacune di monitoraggio. Esegui i flussi di metriche Classic e Otel in parallelo, convalidi i dati e quindi disabiliti lo stream Classic.

Fase 1: conferma dello stato attuale (solo versione classica)

Prima di apportare modifiche, confermate lo stato attuale del componente aggiuntivo e registrate la versione per il rollback.

Per confermare la configurazione attuale del componente aggiuntivo

  1. Eseguite il comando seguente per verificare lo stato attuale del componente aggiuntivo.

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

  2. Verifica che il status campo siaACTIVE.

  3. Registra il addonVersion valore. È necessario questo valore se è necessario eseguire il rollback.

Fase 2: abilita la doppia pubblicazione (Classic + oTel)

Abilita OTel Container Insights insieme a Enhanced Container Insights (Classic). Questo pubblica entrambi i flussi di metriche contemporaneamente in modo da poter convalidare l'equivalenza dei dati.

Importante

Entrambi i flussi metrici comportano addebiti durante questa fase. Ti consigliamo di mantenere la finestra di pubblicazione doppia il più breve possibile per ridurre al minimo i costi.

Per abilitare la doppia pubblicazione

  1. Esegui il comando seguente per aggiornare il componente aggiuntivo con entrambi gli stream abilitati.

    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. Attendi che lo stato del componente aggiuntivo ritorni a. ACTIVE

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

  3. Verifica che le metriche di Otel compaiano in CloudWatch interrogando una metrica nota con PromQL.

Fase 3: ricrea gli allarmi e aggiornare i dashboard

Crea dei sostituti di Otel per i tuoi allarmi e dashboard Classic esistenti. Mantieni attivi gli allarmi Classic come rete di sicurezza durante questa fase.

Per ricreare gli allarmi per le metriche di Otel

  1. Identifica tutti gli CloudWatch allarmi che fanno riferimento ai nomi delle metriche di Classic Container Insights.

  2. Crea allarmi equivalenti utilizzando espressioni PromQL-based matematiche metriche che fanno riferimento ai nomi delle metriche OTel.

  3. Verifica che i nuovi allarmi entrino OK nello stato e producano valutazioni di soglia equivalenti.

  4. Aggiorna tutte CloudWatch le dashboard per includere i widget basati sulle metriche di Otel oltre ai widget Classic esistenti.

Fase 4: Disattiva Classic (passa solo a OTel)

Dopo aver verificato il corretto funzionamento delle metriche, degli allarmi e dei dashboard di Otel, disattiva lo stream Classic.

Per disabilitare Classic e mantenere solo OTel

  1. Esegui il comando seguente per disabilitare la pubblicazione delle metriche classiche.

    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. Attendi che lo stato del componente aggiuntivo ritorni a. ACTIVE

  3. Rimuovi gli allarmi Classic che hai sostituito nella Fase 3.

Verifica

Dopo aver completato la migrazione, verifica che lo stack di osservabilità funzioni correttamente.

  • Controlla le metriche in Query Studio: utilizza le query ProMQL per confermare che le metriche provengono dalla pipeline Otel.

  • Confronta con i valori di base: verifica che i valori delle metriche siano coerenti con le metriche Classic registrate durante la Fase 2.

  • Verifica i dashboard di Container Insights: verifica che la console Container Insights visualizzi i dati per il tuo cluster.

  • Verifica la consegna dei log: verifica che i log dei container continuino a essere visualizzati in CloudWatch Logs.

  • Verifica degli allarmi: verifica che non sia attivo alcun allarme. INSUFFICIENT_DATA

Rollback

Se riscontri problemi dopo la migrazione, puoi ripristinare la configurazione classica precedente.

Per tornare a Enhanced Container Insights (Classic)

  1. Identifica la versione del componente aggiuntivo precedente che hai registrato nella Fase 1.

  2. Eseguite il comando seguente per effettuare il downgrade del componente aggiuntivo.

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

  3. Attendi che lo stato del componente aggiuntivo ritorni a. ACTIVE

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

  4. Re-apply eventuali valori di configurazione personalizzati utilizzati con la versione precedente.