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 + `kubectl`configurato 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 ``` 1. Verifica che il `status` campo sia`ACTIVE`. 1. 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 ``` 1. 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" ``` 1. 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. 1. Crea allarmi equivalenti utilizzando espressioni PromQL-based matematiche metriche che fanno riferimento ai nomi delle metriche OTel. 1. Verifica che i nuovi allarmi entrino `OK` nello stato e producano valutazioni di soglia equivalenti. 1. 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 ``` 1. Attendi che lo stato del componente aggiuntivo ritorni a. `ACTIVE` 1. 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. 1. 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 ``` 1. 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" ``` 1. Re-apply eventuali valori di configurazione personalizzati utilizzati con la versione precedente.