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_METRICS_ENDPOINT configurazione e un'istanza OpenTelemetry Collector autogestita, potresti essere in grado di 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_TRACES_ENDPOINT	Non deve essere usato.
OTEL_ATTRIBUTE_COUNT_LIMIT	Se impostato, deve essere impostato 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