Risoluzione dei problemi relativi all'installazione di Application Signals - Amazon CloudWatch
Prestazioni di avvio a freddo del livello Java di Application SignalsL'applicazione non si avvia dopo l'abilitazione di Application SignalsL'applicazione Python non si avvia dopo l'abilitazione di Application SignalsNessun dato di Application Signals per l'applicazione Python che utilizza un server WSGILa mia applicazione Node.js non è instrumentata o non genera telemetria Application SignalsNessun dato applicativo nel pannello di controllo di Application SignalsI valori delle metriche del servizio o di dipendenza sono sconosciutiGestione di un ConfigurationConflict durante l'utilizzo del componente aggiuntivo Amazon CloudWatch Observability EKSVoglio filtrare le metriche e le tracce non necessarieChe cosa significa InternalOperation?Come posso abilitare la registrazione per le applicazioni .NET?Come posso risolvere i conflitti tra le versioni dell'assemblaggio nelle applicazioni .NET?Posso disabilitare FluentBit?Posso filtrare i log dei container prima di esportarli in CloudWatch Logs? Risoluzione di TypeError quando si utilizza il livello JavaScript Lambda di AWS Distro per OpenTelemetry (ADOT) Aggiornamento alle versioni richieste degli agenti o del componente aggiuntivo Amazon EKSEmbedded Metric Format (EMF) disabilitato per Application Signals

Risoluzione dei problemi relativi all'installazione di Application Signals

Questa sezione contiene suggerimenti per la risoluzione dei problemi relativi a CloudWatch Application Signals.

Prestazioni di avvio a freddo del livello Java di Application Signals

L'aggiunta del livello Application Signals alle funzioni Java Lambda aumenta la latenza di avvio (tempo di avvio a freddo). I seguenti suggerimenti possono aiutare a ridurre la latenza per le funzioni sensibili al fattore tempo.

Avvio rapido per agente Java: il livello Java Lambda di Application Signals include una funzionalità di avvio rapido che per impostazione predefinita è disattivata, ma che può essere abilitata impostando la variabile OTEL_JAVA_AGENT_FAST_STARTUP_ENABLED su true. Se abilitata, questa funzionalità configura la JVM per utilizzare il compilatore C1 di livello 1 di compilazione a più livelli per generare codice nativo ottimizzato rapido per velocizzare gli avvii a freddo. Il compilatore C1 dà priorità alla velocità a scapito dell'ottimizzazione a lungo termine, mentre il compilatore C2 offre prestazioni complessive superiori profilando i dati nel tempo.

Per ulteriori informazioni, consulta Fast startup for Java agent.

Riduci i tempi di avvio a freddo con la simultaneità allocata: la simultaneità allocata di AWS Lambda prealloca un numero specifico di istanze di funzione, mantenendole inizializzate e pronte a gestire immediatamente le richieste. Ciò riduce i tempi di avvio a freddo eliminando la necessità di inizializzare l'ambiente della funzione durante l'esecuzione e garantendo prestazioni più rapide e coerenti, in particolare per i carichi di lavoro sensibili alla latenza. Per ulteriori informazioni, consulta Configuring provisioned concurrency for a function.

Ottimizza le prestazioni di avvio utilizzando Lambda SnapStart: AWS Lambda SnapStart è una funzionalità che ottimizza le prestazioni di avvio delle funzioni Lambda creando uno snapshot preinizializzato dell'ambiente di esecuzione dopo la fase di inizializzazione della funzione. Questo snapshot viene quindi riutilizzato per avviare nuove istanze, riducendo in modo significativo i tempi di avvio a freddo saltando il processo di inizializzazione durante l'invocazione della funzione. Per ulteriori informazioni, consulta Improving startup performance with Lambda SnapStart.

L'applicazione non si avvia dopo l'abilitazione di Application Signals

Se l'applicazione su un cluster Amazon EKS non si avvia dopo aver abilitato Application Signals sul cluster, verifica quanto segue:

  • Verifica se l'applicazione è stata strumentata da un'altra soluzione di monitoraggio. Application Signals potrebbe non supportare la coesistenza con altre soluzioni di instrumentazione.

  • Verifica che l'applicazione soddisfi i requisiti di compatibilità per utilizzare Application Signals. Per ulteriori informazioni, consulta Sistemi supportati.

  • Se l'applicazione non è riuscita a recuperare gli artefatti di Application Signals come l'agente Java o Python di AWS Distro per OpenTelemetry e le immagini dell'agente CloudWatch, potrebbe trattarsi di un problema di rete.

Per mitigare il problema, rimuovi l'annotazione instrumentation.opentelemetry.io/inject-java: "true" o instrumentation.opentelemetry.io/inject-python: "true" dal manifesto di implementazione dell'applicazione e implementa nuovamente l'applicazione. Quindi controlla se l'applicazione funziona.

Problemi noti

È noto che la raccolta delle metriche di runtime nella versione dell'SDK Java v1.32.5 non funziona con le applicazioni che utilizzano JBoss Wildfly. Questo problema si estende al componente aggiuntivo Amazon CloudWatch Observability EKS e riguarda le versioni da 2.3.0-eksbuild.1 a 2.5.0-eksbuild.1.

Se riscontri problemi, esegui il downgrade della versione o disabilita la raccolta delle metriche di runtime aggiungendo la variabile di ambiente OTEL_AWS_APPLICATION_SIGNALS_RUNTIME_ENABLED=false all'applicazione.

L'applicazione Python non si avvia dopo l'abilitazione di Application Signals

È un problema noto nell'instrumentazione automatica di OpenTelemetry che una variabile di ambiente PYTHONPATH mancante a volte può causare il mancato avvio dell'applicazione. Per risolvere questo problema, assicurati di impostare la variabile di ambiente PYTHONPATH sulla posizione della directory di lavoro dell'applicazione. Per ulteriori informazioni su questo problema, consulta Python autoinstrumentation setting of PYTHONPATH is not compliant with Python's module resolution behavior, breaking Django applications.

Per le applicazioni Django sono richieste alcune configurazioni aggiuntive, che sono descritte nella documentazione di OpenTelemetry Python.

  • Usa il flag --noreload per impedire il ricaricamento automatico.

  • Imposta la variabile di ambiente DJANGO_SETTINGS_MODULE sulla posizione del file settings.py dell'applicazione Django. Ciò garantisce che OpenTelemetry possa accedere e integrarsi correttamente con le impostazioni di Django.

Nessun dato di Application Signals per l'applicazione Python che utilizza un server WSGI

Se si utilizza un server WSGI come Gunicorn o uWSGI, è necessario apportare ulteriori modifiche per far funzionare l'instrumentazione automatica di ADOT Python.

Nota

Assicurati di utilizzare la versione più recente di ADOT Python e del componente aggiuntivo Amazon CloudWatch Observability EKS prima di procedere.

Passaggi aggiuntivi per abilitare Application Signals con un server WSGI

  1. Importa l'instrumentazione automatica nei processi di lavoro biforcati.

    Per Gunicorn, usa l'hook post_fork:

    # gunicorn.conf.py
def post_fork(server, worker):
    from opentelemetry.instrumentation.auto_instrumentation import sitecustomize

    Per uWSGI, usa la direttiva import.

    #  uwsgi.ini
[uwsgi]
; required for the instrumentation of worker processes
enable-threads = true
lazy-apps = true
import = opentelemetry.instrumentation.auto_instrumentation.sitecustomize

  2. Abilita la configurazione per l'instrumentazione automatica di ADOT Python per saltare il processo principale e rimandarlo ai worker impostando la variabile di ambiente OTEL_AWS_PYTHON_DEFER_TO_WORKERS_ENABLED su true.

La mia applicazione Node.js non è instrumentata o non genera telemetria Application Signals

Per abilitare Application Signals per Node.js, è necessario assicurarsi che l'applicazione Node.js utilizzi il formato del modulo CommonJS (CJS). AWS Distro per OpenTelemetry Node.js non supporta il formato del modulo ESM, poiché il supporto di OpenTelemetry JavaScript per ESM è sperimentale ed è in corso.

Per determinare se la tua applicazione utilizza CJS e non ESM, assicurati che non soddisfi le condizioni per abilitare ESM.

Nessun dato applicativo nel pannello di controllo di Application Signals

Se nei pannelli di controllo di Application Signals mancano parametri o tracce, le cause potrebbero essere le seguenti. Esamina queste cause solo se hai atteso per 15 minuti che Application Signals raccogliesse e visualizzasse i dati dall'ultimo aggiornamento.

  • Assicurati che la libreria e il framework che stai utilizzando siano supportati dall'agente Java ADOT. Per ulteriori informazioni, consulta Librerie/framework.

  • Verifica che l'agente CloudWatch sia in esecuzione. Controlla innanzitutto lo stato dei pod degli agenti CloudWatch e assicurati che siano tutti nello stato Running.

    kubectl -n amazon-cloudwatch get pods.

    Aggiungi quanto segue al file di configurazione dell'agente CloudWatch per abilitare i log di debug, quindi riavvia l'agente.

    "agent": {

  "region": "${REGION}",
  "debug": true
},

    Quindi verifica la presenza di errori nei pod dell'agente CloudWatch.

  • Verifica la presenza di problemi di configurazione dell'agente CloudWatch. Verifica che quanto segue sia ancora presente nel file di configurazione dell'agente CloudWatch e che l'agente sia stato riavviato da quando è stato aggiunto.

    "agent": {
  "region": "${REGION}",
  "debug": true
},

    Quindi controlla nei log di debug di OpenTelemetry la presenza di messaggi di errore come ERROR io.opentelemetry.exporter.internal.grpc.OkHttpGrpcExporter - Failed to export .... Questi messaggi potrebbero indicare il problema.

    Se questo non risolve il problema, scarica e controlla le variabili di ambiente con nomi che iniziano con OTEL_ descrivendo il pod con il comando kubectl describe pod.

  • Per abilitare la registrazione di debug di OpenTelemetry Python, imposta la variabile di ambiente OTEL_PYTHON_LOG_LEVEL su debug e implementa nuovamente l'applicazione.

  • Verifica se sono presenti autorizzazioni errate o insufficienti per l'esportazione dei dati dall'agente CloudWatch. Se vedi messaggi di Access Denied nei log dell'agente CloudWatch, questo potrebbe essere il problema. È possibile che le autorizzazioni applicate durante l'installazione dell'agente CloudWatch siano state successivamente modificate o revocate.

  • Verifica la presenza di un problema di AWS Distro for OpenTelemetry (ADOT) durante la generazione dei dati di telemetria.

    Assicurati che le annotazioni sulla strumentazione instrumentation.opentelemetry.io/inject-java e sidecar.opentelemetry.io/inject-java vengano applicate alla distribuzione dell'applicazione e che il valore sia true. Senza questi, i pod dell'applicazione non saranno dotati di strumenti anche se il componente aggiuntivo ADOT è installato correttamente.

    Quindi, controlla se il container init è applicato all'applicazione e lo stato di Ready è True. Se il container init non è pronto, verifica lo stato del motivo.

    Se il problema persiste, abilita la registrazione di debug sull'SDK Java di OpenTelemetry impostando la variabile di ambiente OTEL_JAVAAGENT_DEBUG su true e implementando nuovamente l'applicazione. Quindi cerca i messaggi che iniziano con ERROR io.telemetry.

  • È possibile che l'esportatore metric/span stia eliminando i dati. Per scoprirlo, controlla il log dell'applicazione per i messaggi che includono Failed to export...

  • L'agente CloudWatch potrebbe subire delle limitazioni durante l'invio di parametri o intervalli ad Application Signals. Verifica la presenza di messaggi che indicano una limitazione nei log dell'agente CloudWatch.

  • Assicurati di aver abilitato la configurazione di rilevamento servizi. È necessario eseguire questa operazione solo una volta nella Regione in uso.

    Per verificarlo, nella console CloudWatch scegli Application Signals e poi Servizi. Se il Passaggio 1 non è contrassegnato come Completo, scegli Scoperta dei servizi. I dati dovrebbero iniziare ad arrivare entro cinque minuti.

I valori delle metriche del servizio o di dipendenza sono sconosciuti

Se vedi UnknownService, UnknownOperation, UnknownRemoteService o UnknownRemoteOperation per un nome o un'operazione di dipendenza nel pannello di controllo di Application Signals, controlla se i punti dati per il servizio remoto sconosciuto e l'operazione remota sconosciuta coincidono con le relative implementazioni.

  • UnknownService significa che il nome di un'applicazione instrumentata è sconosciuto. Se la variabile di ambiente OTEL_SERVICE_NAME non è definita e service.name non è specificato in OTEL_RESOURCE_ATTRIBUTES, il nome del servizio è impostato su UnknownService. Per risolvere questo problema, specifica il nome del servizio in OTEL_SERVICE_NAME o OTEL_RESOURCE_ATTRIBUTES.

  • UnknownOperation significa che il nome di un'operazione invocata è sconosciuto. Ciò si verifica quando Application Signals non è in grado di rilevare il nome di un'operazione che invoca la chiamata remota o quando il nome dell'operazione estratto contiene valori di cardinalità elevati.

  • UnknownRemoteService significa che il nome del servizio di destinazione è sconosciuto. Ciò si verifica quando il sistema non è in grado di estrarre il nome del servizio di destinazione a cui accede la chiamata remota.

    Una soluzione consiste nel creare un intervallo personalizzato attorno alla funzione che invia la richiesta e aggiungere l'attributo aws.remote.service con il valore designato. Un'altra opzione è configurare l'agente CloudWatch per personalizzare il valore della metrica di RemoteService. Per ulteriori informazioni sulle personalizzazioni nell'agente CloudWatch, consulta Attivazione di CloudWatch Application Signals.

  • UnknownRemoteOperation significa che il nome dell'operazione di destinazione è sconosciuto. Ciò si verifica quando il sistema non è in grado di estrarre il nome dell'operazione di destinazione a cui accede la chiamata remota.

    Una soluzione consiste nel creare un intervallo personalizzato attorno alla funzione che invia la richiesta e aggiungere l'attributo aws.remote.operation con il valore designato. Un'altra opzione è configurare l'agente CloudWatch per personalizzare il valore della metrica di RemoteOperation. Per ulteriori informazioni sulle personalizzazioni nell'agente CloudWatch, consulta Attivazione di CloudWatch Application Signals.

Gestione di un ConfigurationConflict durante l'utilizzo del componente aggiuntivo Amazon CloudWatch Observability EKS

Quando installi o aggiorni il componente aggiuntivo Amazon CloudWatch Observability EKS, se noti un errore causato da un Health Issue di tipo ConfigurationConflict con una descrizione che inizia con Conflicts found when trying to apply. Will not continue due to resolve conflicts mode, è probabile che l'agente CloudWatch e i relativi componenti associati come ServiceAccount, ClusterRole e ClusterRoleBinding siano già installati sul cluster. Quando il componente aggiuntivo tenta di installare l'agente CloudWatch e i componenti associati, se rileva modifiche nei contenuti, per impostazione predefinita l'installazione o l'aggiornamento non riesce per evitare di sovrascrivere lo stato delle risorse sul cluster.

Se stai tentando di effettuare l'onboarding sul componente aggiuntivo Amazon CloudWatch Observability EKS e riscontri questo errore, ti consigliamo di eliminare una configurazione dell'agente CloudWatch esistente che avevi precedentemente installato sul cluster e quindi di installare il componente aggiuntivo EKS. Assicurati di eseguire il backup di tutte le personalizzazioni che potresti aver apportato alla configurazione originale dell'agente CloudWatch, ad esempio una configurazione personalizzata dell'agente, e di fornirle al componente aggiuntivo Amazon CloudWatch Observability EKS alla prossima installazione o aggiornamento. Se in precedenza avevi installato l'agente CloudWatch per l'onboarding su Container Insights, consulta Eliminazione dell'agente CloudWatch e Fluent Bit per Container Insights per ulteriori informazioni.

In alternativa, il componente aggiuntivo supporta un'opzione di configurazione per la risoluzione dei conflitti che può specificare OVERWRITE. È possibile utilizzare questa opzione per procedere con l'installazione o l'aggiornamento del componente aggiuntivo sovrascrivendo i conflitti nel cluster. Se utilizzi la console Amazon EKS, trovi il metodo di risoluzione dei conflitti selezionando le impostazioni di configurazione facoltative quando crei o aggiorni il componente aggiuntivo. Se utilizzi la AWS CLI, puoi fornire --resolve-conflicts OVERWRITE al tuo comando per creare o aggiornare il componente aggiuntivo.

Voglio filtrare le metriche e le tracce non necessarie

Se Application Signals sta raccogliendo tracce e metriche che non ti interessano, consulta Gestione di operazioni ad alta cardinalità per informazioni sulla configurazione dell'agente CloudWatch con regole personalizzate per ridurre la cardinalità.

Per ulteriori informazioni sulla personalizzazione delle regole di campionamento in tracce, consulta Configure sampling rules nella documentazione di X-Ray.

Che cosa significa InternalOperation?

InternalOperation è un'operazione che viene attivata dall'applicazione internamente anziché da un'invocazione esterna. La visualizzazione di InternalOperation è il comportamento previsto ed è indicazione di integrità.

Alcuni esempi tipici in cui potresti vedere InternalOperation includono quanto segue:

  • Precaricamento all'avvio: l'applicazione esegue un'operazione denominata loadDatafromDB che legge i metadati da un database durante la fase di riscaldamento. Invece di vedere loadDatafromDB come operazione di servizio, la vedrai classificata come InternalOperation.

  • Esecuzione asincrona in background: l'applicazione si abbona a una coda di eventi ed elabora i dati in streaming di conseguenza ogni volta che viene effettuato un aggiornamento. Ogni operazione attivata verrà eseguita sotto InternalOperation come operazione di servizio.

  • Recupero delle informazioni sull'host da un registro dei servizi: l'applicazione comunica con un registro dei servizi per il rilevamento servizi. Tutte le interazioni con il sistema di rilevamento sono classificate come InternalOperation.

Come posso abilitare la registrazione per le applicazioni .NET?

Per abilitare la registrazione per le applicazioni .NET, configura le seguenti variabili di ambiente. Per ulteriori informazioni su come configurare queste variabili di ambiente, consulta Troubleshooting .NET automatic instrumentation issues nella documentazione di OpenTelemetry.

  • OTEL_LOG_LEVEL

  • OTEL_DOTNET_AUTO_LOG_DIRECTORY

  • COREHOST_TRACE

  • COREHOST_TRACEFILE

Come posso risolvere i conflitti tra le versioni dell'assemblaggio nelle applicazioni .NET?

Se viene visualizzato il seguente errore, consulta Assembly version conflicts nella documentazione di OpenTelemetry per conoscere i passaggi per la risoluzione.

Unhandled exception. System.IO.FileNotFoundException: Could not load file or assembly 'Microsoft.Extensions.DependencyInjection.Abstractions, Version=7.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60'. The system cannot find the file specified.

File name: 'Microsoft.Extensions.DependencyInjection.Abstractions, Version=7.0.0.0, Culture=neutral, PublicKeyToken=adb9793829ddae60'
   at Microsoft.AspNetCore.Builder.WebApplicationBuilder..ctor(WebApplicationOptions options, Action`1 configureDefaults)
   at Microsoft.AspNetCore.Builder.WebApplication.CreateBuilder(String[] args)
   at Program.<Main>$(String[] args) in /Blog.Core/Blog.Core.Api/Program.cs:line 26

Posso disabilitare FluentBit?

Puoi disabilitare FluentBit configurando il componente aggiuntivo Amazon CloudWatch Observability EKS. Per ulteriori informazioni, consulta (Facoltativo) Configurazione aggiuntiva.

Posso filtrare i log dei container prima di esportarli in CloudWatch Logs?

No, il filtraggio dei log dei container non è ancora supportato.

Risoluzione di TypeError quando si utilizza il livello JavaScript Lambda di AWS Distro per OpenTelemetry (ADOT)

La tua funzione Lambda potrebbe fallire con questo errore: TypeError - "Cannot redefine property: handler" quando:

  • Si utilizza il livello JavaScript Lambda di ADOT

  • Si utilizza esbuild per compilare TypeScript

  • Si esporta il gestore con la parola chiave export

Il livello JavaScript Lambda di ADOT deve modificare il gestore in fase di runtime. Quando si utilizza la parola chiave export con esbuild (direttamente o tramite AWS CDK), esbuild rende il gestore immutabile, impedendo queste modifiche.

Esporta la tua funzione di gestione utilizzando module.exports invece della parola chiave export: 

// Before
export const handler = (event) => {
  // Handler Code
}
// After
const handler = async (event) => {
  // Handler Code
}
module.exports = { handler }

Aggiornamento alle versioni richieste degli agenti o del componente aggiuntivo Amazon EKS

Dopo il 9 agosto 2024, CloudWatch Application Signals non supporterà più le versioni precedenti del componente aggiuntivo Amazon CloudWatch Observability EKS, dell'agente CloudWatch e dell'agente di instrumentazione automatica AWS Distro per OpenTelemetry.

  • Per il componente aggiuntivo Amazon CloudWatch Observability EKS, le versioni precedenti alla v1.7.0-eksbuild.1 non saranno supportate.

  • Per l'agente CloudWatch, le versioni precedenti alla 1.300040.0 non saranno supportate.

  • Per l'agente di instrumentazione automatica AWS Distro per OpenTelemetry:

    • Per Java, le versioni precedenti alla 1.32.2 non sono supportate.

    • Per Python, le versioni precedenti alla 0.2.0 non sono supportate.

    • Per .NET, le versioni precedenti alla 1.3.2 non sono supportate.

    • Per Node.js, le versioni precedenti alla 0.3.0 non sono supportate.

Importante

Le versioni più recenti degli agenti includono aggiornamenti allo schema delle metriche di Application Signals. Questi aggiornamenti non sono compatibili con le versioni precedenti e ciò può causare problemi di dati se vengono utilizzate versioni incompatibili. Per garantire una transizione ottimale alla nuova funzionalità, effettua le seguenti operazioni:

  • Se la tua applicazione è in esecuzione su Amazon EKS, assicurati di riavviare tutte le applicazioni instrumentate dopo aver aggiornato il componente aggiuntivo Amazon CloudWatch Observability.

  • Per le applicazioni in esecuzione su altre piattaforme, assicurati di aggiornare sia l'agente CloudWatch sia l'agente di instrumentazione automatica AWS OpenTelemetry alle versioni più recenti.

Le istruzioni nelle sezioni seguenti possono aiutarti a eseguire l'aggiornamento a una versione supportata.

Aggiornamento del componente aggiuntivo Amazon CloudWatch Observability EKS

Per aggiornare il componente aggiuntivo Amazon CloudWatch Observability EKS, puoi utilizzare la Console di gestione AWS o la AWS CLI.

Utilizzo della console

Per aggiornare il componente aggiuntivo utilizzando la console

  1. Apri la console Amazon EKS all'indirizzo https://console.aws.amazon.com/eks/home#/clusters.

  2. Scegli il nome del cluster Amazon EKS da aggiornare.

  3. Scegli la scheda Componente aggiuntivo, quindi scegli Amazon CloudWatch Observability.

  4. Scegli Modifica, seleziona la versione a cui desideri eseguire l'aggiornamento, quindi scegli Salva modifiche.

    Assicurati di scegliere v1.7.0-eksbuild.1 o successive.

  5. Immetti uno dei seguenti comandi AWS CLI per riavviare i servizi.

      # Restart a deployment
  kubectl rollout restart deployment/name
  # Restart a daemonset
  kubectl rollout restart daemonset/name
  # Restart a statefulset
  kubectl rollout restart statefulset/name

Utilizzo dell'AWS CLI

Per aggiornare il componente aggiuntivo utilizzando la AWS CLI

  1. Immetti il seguente comando per trovare la versione più recente.

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

  2. Immetti il seguente comando per aggiornare il componente aggiuntivo. Sostituisci $VERSION con una versione pari a v1.7.0-eksbuild.1 o successiva. Sostituisci $AWS_REGION e $CLUSTER con il nome e la Regione del cluster.

    aws eks update-addon \
--region $AWS_REGION \
--cluster-name $CLUSTER \
--addon-name amazon-cloudwatch-observability \
--addon-version $VERSION \
# required only if the advanced configuration is used.
--configuration-values $JSON_CONFIG
    Nota

    Se per il componente aggiuntivo stai usando una configurazione personalizzata, puoi trovare un esempio della configurazione da usare per $JSON_CONFIG in Attivazione di CloudWatch Application Signals.

  3. Immetti uno dei seguenti comandi AWS CLI per riavviare i servizi.

      # Restart a deployment
  kubectl rollout restart deployment/name
  # Restart a daemonset
  kubectl rollout restart daemonset/name
  # Restart a statefulset
  kubectl rollout restart statefulset/name

Aggiornamento dell'agente CloudWatch e dell'agente ADOT

Se i tuoi servizi funzionano su architetture diverse da Amazon EKS, dovrai aggiornare sia l'agente CloudWatch sia l'agente di instrumentazione automatica ADOT per utilizzare le funzionalità di Application Signals più recenti.

Aggiornamento su Amazon ECS

Per aggiornare gli agenti per i servizi in esecuzione su Amazon ECS

  1. Crea una nuova revisione della definizione delle attività. Per ulteriori informazioni, consulta Updating a task definition using the console.

  2. Sostituisci il valore $IMAGE del container ecs-cwagent con il tag dell'ultima immagine di cloudwatch-agent su Amazon ECR.

    Se esegui l'upgrade a una versione fissa, assicurati di utilizzare una versione pari a 1.300040.0 o successiva.

  3. Sostituisci il valore $IMAGE del container init con il tag dell'ultima immagine dalle seguenti posizioni:

  4. Aggiorna le variabili di ambiente di Application Signals nel container dell'app seguendo le istruzioni riportate all'indirizzo Fase 4: strumentazione dell'applicazione con l'agente CloudWatch.

  5. Implementa il servizio con la nuova definizione di attività.

Aggiornamento su Amazon EC2 o su altre architetture

Per aggiornare gli agenti per i servizi in esecuzione su Amazon EC2 o su altre architetture

  1. Assicurati di selezionare la versione 1.300040.0 o successiva dell'agente CloudWatch.

  2. Scarica l'ultima versione dell'agente di instrumentazione automatica di AWS Distro per OpenTelemetry da una delle seguenti posizioni:

    • Per Java, usa aws-otel-java-instrumentation.

      Se esegui l'aggiornamento a una versione fissa, assicurati di scegliere 1.32.2 o una versione successiva.

    • Per Python, usa aws-otel-python-instrumentation.

      Se esegui l'aggiornamento a una versione fissa, assicurati di scegliere 0.2.0 o una versione successiva.

    • Per .NET, usa aws-otel-dotnet-instrumentation.

      Se esegui l'aggiornamento a una versione fissa, assicurati di scegliere 1.3.2 o una versione successiva.

    • Per Node.js, usa aws-otel-js-instrumentation.

      Se esegui l'aggiornamento a una versione fissa, assicurati di scegliere 0.3.0 o una versione successiva.

  3. Applica le variabili di ambiente aggiornate di Application Signals all'applicazione, quindi avviala. Per ulteriori informazioni, consulta Passaggio 3: instrumentazione e avvio dell'applicazione.

Embedded Metric Format (EMF) disabilitato per Application Signals

La disabilitazione di EMF per il gruppo di log /aws/application-signals/data può avere il seguente impatto sulla funzionalità di Application Signals.

  • Le metriche e i grafici di Application Signals non verranno visualizzati

  • La funzionalità di Application Signals verrà ridotta

Come posso ripristinare Application Signals?

Quando Application Signals visualizza grafici o metriche vuoti, è necessario abilitare EMF per il gruppo di log /aws/application-signals/data per ripristinare la piena funzionalità. Per ulteriori informazioni, consulta PutAccountPolicy.