View a markdown version of this page

Abilita OTel Container Insights dalla console - Amazon CloudWatch
PrerequisitiAbilita Otel Container InsightsCosa configura la consoleVerifica che i dati vengano visualizzati in CloudWatchRisoluzione dei problemi

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à.

Abilita OTel Container Insights dalla console

Puoi abilitare Otel Container Insights direttamente dal flusso di lavoro Console di gestione AWS con un clic minimo. Questo approccio è ideale se preferisci un' UI-driven esperienza e desideri abilitare la piena osservabilità su un cluster Amazon EKS esistente senza scrivere codice di infrastruttura o eseguire comandi CLI.

Prerequisiti

Prima di abilitare Otel Container Insights dalla console, verifica di soddisfare i seguenti requisiti.

  • Hai effettuato l'accesso alla console Amazon EKS.

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

  • Versione 6.2.0 o successiva del componente aggiuntivo. amazon-cloudwatch-observability

  • Autorizzazioni IAM:eks:DescribeCluster,eks:UpdateClusterConfig,eks:ListAddons, eks:CreateAddoneks:DescribeAddon, iam:AttachRolePolicy e. iam:CreateServiceLinkedRole

  • Al ruolo IAM del nodo deve essere associata la policy CloudWatchAgentServerPolicy gestita.

  • Il cluster è ACTIVE attivo.

Abilita Otel Container Insights

Utilizza la seguente procedura per abilitare Otel Container Insights dalla console Amazon EKS.

Per abilitare Otel Container Insights utilizzando la console

  1. Apri la Console Amazon EKS su https://console.aws.amazon.com/eks/.

  2. Scegli Clusters, quindi scegli il nome del cluster.

  3. Scegli la scheda Osservabilità.

  4. Accanto allo stato di Container Insights, scegli Gestisci.

  5. Seleziona la configurazione di Otel Container Insights.

  6. Conferma il ruolo IAM per il componente aggiuntivo. La console crea automaticamente il ruolo se non ne esiste già uno.

  7. Scegli Abilita .

Cosa configura la console

Quando abiliti OTel Container Insights dalla console, la console esegue le seguenti azioni per tuo conto.

  • Crea e configura l'associazione Pod Identity per lo spazio dei nomi amazon-cloudwatch

  • Installa il componente aggiuntivo amazon-cloudwatch-observability Amazon EKS con la versione 6.2.0 o successiva e otelContainerInsights.enabled=true

  • Allega il al ruolo IAM CloudWatchAgentServerPolicy designato

Verifica che i dati vengano visualizzati in CloudWatch

Dopo aver abilitato Otel Container Insights, i dati vengono visualizzati CloudWatch entro 5 minuti.

Per verificare i dati di Container Insights

  1. Apri la CloudWatch console all'indirizzo https://console.aws.amazon.com/cloudwatch/.

  2. Nel riquadro di navigazione, scegli Insights, quindi scegli Container Insights.

  3. Scegli il tuo cluster dall'elenco dei cluster.

Le dashboard di Container Insights sono popolate con i dati metrici del tuo cluster.

Risoluzione dei problemi

Utilizza le seguenti indicazioni per risolvere i problemi più comuni quando abiliti Otel Container Insights dalla console.

Il pulsante Abilita non è disponibile

Sintomo: il pulsante Abilita è disattivato e non puoi sceglierlo.

Causa: il cluster potrebbe essere in uno stato di aggiornamento o non disponi di autorizzazioni IAM sufficienti.

Soluzione: completa i seguenti passaggi per risolvere il problema.

  1. Verifica che lo stato del cluster sia riportato nella ACTIVE pagina dei dettagli del cluster.

  2. Verifica che il tuo utente o ruolo IAM disponga delle autorizzazioni richieste elencate nei prerequisiti.

  3. Se il cluster si sta aggiornando, attendi il completamento dell'aggiornamento e riprova.

Lo stato mostra DEGRADATO dopo l'attivazione

Sintomo: dopo aver abilitato Otel Container Insights, viene visualizzato lo stato del componente aggiuntivo. DEGRADED

Causa: il componente aggiuntivo è installato ma non può funzionare correttamente, in genere a causa di problemi di autorizzazione dei ruoli IAM o problemi di connettività dei nodi.

Soluzione: completa i seguenti passaggi per risolvere questo problema.

  1. Verifica che al ruolo IAM sia associata la policy CloudWatchAgentServerPolicy gestita.

  2. Verifica che i nodi del cluster abbiano connettività in uscita agli CloudWatch endpoint.

  3. Controlla i dettagli sullo stato del componente aggiuntivo nella console Amazon EKS selezionando la Add-onsscheda nella pagina dei dettagli del cluster.