OpenTelemetry considerazioni sulla compatibilità - Amazon CloudWatch

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

OpenTelemetry considerazioni sulla compatibilità

Per effettuare l'onboarding delle applicazioni con CloudWatch Application Signals, consigliamo di rimuovere preventivamente dall'applicazione tutte le soluzioni di monitoraggio delle prestazioni delle applicazioni esistenti. Questo include la rimozione di qualsiasi codice e configurazione della strumentazione.

Anche se Application Signals utilizza la OpenTelemetry strumentazione, non è garantito che sia compatibile con la strumentazione o la configurazione esistente. OpenTelemetry Nella migliore delle ipotesi, potreste riuscire a mantenere alcune delle vostre OpenTelemetry funzionalità, come le metriche personalizzate. Tuttavia, assicurati di leggere le sezioni seguenti per ulteriori informazioni.

Considerazioni se lo utilizzi già OpenTelemetry

Se la utilizzi già OpenTelemetry con la tua applicazione, il resto di questa sezione contiene informazioni importanti per garantire la compatibilità con Application Signals.

  • Prima di abilitare l'applicazione per Application Signals, è necessario rimuovere l'iniezione di qualsiasi altro agente di strumentazione automatica basato su OpenTelemetry dall'applicazione. Questo aiuta a evitare conflitti di configurazione. È possibile continuare a utilizzare la strumentazione manuale utilizzando la strumentazione compatibile con OpenTelemetry APIs Application Signals.

  • Se utilizzi la strumentazione manuale per generare intervalli o parametri personalizzati dall'applicazione, a seconda della complessità della strumentazione, l'abilitazione di Application Signals potrebbe interrompere la generazione di dati o causare altri comportamenti indesiderati. Potresti essere in grado di utilizzare alcune delle configurazioni disponibili in OpenTelemetry (ad eccezione di quelle menzionate nella tabella riportata più avanti in questa sezione) per mantenere il comportamento desiderato delle metriche o degli intervalli esistenti. Per ulteriori informazioni su queste configurazioni, consulta SDKConfigurazione nella documentazione. OpenTelemetry

    Ad esempio, utilizzando la OTEL_EXPORTER_OTLP_METRIC_ENDPOINT configurazione e un'istanza OpenTelemetry Collector autogestita, potresti continuare a inviare le metriche personalizzate alla destinazione desiderata.

  • Alcune variabili di ambiente o proprietà di sistema non devono essere utilizzate con Application Signals, mentre è possibile utilizzarne altre purché si seguano le indicazioni riportate nella tabella. Per i dettagli, consulta la seguente tabella.

Variabile di ambiente Raccomandazione con Application Signals

Variabili di ambiente generali

OTEL_SDK_DISABLED

Deve essere impostato su true.

OTEL_TRACES_EXPORTER

Deve essere impostato su otlp.

OTEL_LOGS_EXPORTER

Impostato per none disabilitare altri esportatori di log.

OTEL_EXPORTER_OTLP_ENDPOINT

Non deve essere usato.

OTEL_EXPORTER_OTLP_METRIC_ENDPOINT

Utilizzando la OTEL_EXPORTER_OTLP_METRIC_ENDPOINT configurazione e un'istanza OpenTelemetry Collector autogestita, potresti essere in grado di continuare a inviare le metriche personalizzate alla destinazione desiderata.

Nel. NETconfigurazione, questa variabile di ambiente è supportata nella strumentazione manuale, ma non nella strumentazione automatica. Non è possibile utilizzare questa variabile di ambiente per inviare metriche ai propri endpoint.

OTEL_EXPORTER_OTLP_TRACES_ENDPOINT

Non deve essere usato.

OTEL_ATTRIBUTE_COUNT_LIMIT

Se impostata, deve essere impostata a un valore sufficientemente alto da includere circa altri 10 attributi span aggiunti da CloudWatch Application Signals.

OTEL_EXPORTER_OTLP_PROTOCOL

Deve essere impostato su http/protobuf

OTEL_PROPAGATORS

Se impostato, deve essere incluso xray per la tracciabilità.

OTEL_TRACES_SAMPLER

Se impostato, deve essere xray a utilizzare il campionamento centralizzato di X-Ray.

Per utilizzare il campionamento locale, impostalo su parentbased_traceidratio e specifica la frequenza di campionamento in OTEL_TRACES_SAMPLER_ARG.

OTEL_TRACES_SAMPLER_ARG

Se utilizzi l'impostazione predefinita del campione di traccia centralizzato di X-Ray, questa variabile non deve essere utilizzata.

Se invece utilizzi il campionamento locale, imposta la frequenza di campionamento in questa variabile. Ad esempio, 0.05 per una frequenza di campionamento del 5%.

Variabili di ambiente specifiche per Java

OTEL_JAVA_ENABLED_RESOURCE_PROVIDERS

Se impostato, deve includere rilevatori di AWS risorse.

Variabili di ambiente specifiche per Python

OTEL_PYTHON_CONFIGURATOR

Se usato, deve essere impostato su aws_configurator

OTEL_PYTHON_DISTRO

Se usato, deve essere impostato su aws_distro

Variabili di ambiente specifiche per Node.js

OTEL_NODE_ENABLED_INSTRUMENTATIONS

Si consiglia di cancellare questa variabile in modo che tutte le strumentazioni siano abilitate per impostazione predefinita.

OTEL_NODE_DISABLED_INSTRUMENTATIONS

Si consiglia di cancellare questa variabile. ADOT JavaScript SDKVerrà impostato un valore predefinito per sopprimere i dati di telemetria di bassa qualità.