OpenTelemetry pertimbangan kompatibilitas - Amazon CloudWatch

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

OpenTelemetry pertimbangan kompatibilitas

Untuk onboard aplikasi Anda dengan CloudWatch Application Signals, kami sarankan Anda menghapus sepenuhnya solusi pemantauan kinerja aplikasi yang ada dari aplikasi Anda sebelumnya. Ini termasuk menghapus kode instrumentasi dan konfigurasi apa pun.

Meskipun Sinyal Aplikasi menggunakan OpenTelemetry instrumentasi, tidak dijamin kompatibel dengan OpenTelemetry instrumentasi atau konfigurasi Anda yang ada. Dalam skenario kasus terbaik, Anda mungkin dapat menyimpan beberapa OpenTelemetry fungsionalitas Anda, seperti metrik khusus. Namun demikian, pastikan untuk membaca bagian berikut untuk detailnya.

Pertimbangan jika Anda sudah menggunakan OpenTelemetry

Jika Anda sudah menggunakan OpenTelemetry dengan aplikasi Anda, sisa bagian ini berisi informasi penting untuk mencapai kompatibilitas dengan Sinyal Aplikasi.

  • Sebelum Anda mengaktifkan aplikasi Anda untuk Sinyal Aplikasi, Anda harus menghapus injeksi agen instrumentasi otomatis lainnya berdasarkan OpenTelemetry dari aplikasi Anda. Ini membantu menghindari konflik konfigurasi. Anda dapat terus menggunakan instrumentasi manual menggunakan kompatibel OpenTelemetry APIs bersama dengan Sinyal Aplikasi.

  • Jika Anda menggunakan instrumentasi manual untuk menghasilkan rentang atau metrik kustom dari aplikasi Anda, maka tergantung pada kompleksitas instrumentasi yang digunakan, mengaktifkan Sinyal Aplikasi akan dapat menyebabkan mereka berhenti menghasilkan data atau memiliki perilaku berbeda yang tidak diinginkan. Anda mungkin dapat menggunakan beberapa konfigurasi yang tersedia di OpenTelemetry (kecuali yang disebutkan dalam tabel nanti di bagian ini) untuk mempertahankan perilaku yang diinginkan dari metrik atau rentang yang ada. Untuk informasi selengkapnya tentang konfigurasi ini, lihat SDKKonfigurasi dalam OpenTelemetry dokumentasi.

    Misalnya, dengan menggunakan OTEL_EXPORTER_OTLP_METRIC_ENDPOINT konfigurasi dan instance OpenTelemetry Kolektor yang dikelola sendiri, Anda mungkin dapat terus mengirim metrik kustom ke tujuan yang Anda inginkan.

  • Beberapa variabel lingkungan atau properti sistem tidak boleh digunakan dengan Sinyal Aplikasi, sementara Anda dapat menggunakan variabel lingkungan atau properti sistem yang lain selama Anda mengikuti panduan dalam tabel. Lihat tabel berikut untuk detailnya.

Variabel Lingkungan Rekomendasi dengan Sinyal Aplikasi

Variabel lingkungan umum

OTEL_SDK_DISABLED

Tidak boleh diatur ke true.

OTEL_TRACES_EXPORTER

Harus diatur ke otlp.

OTEL_LOGS_EXPORTER

Setel none untuk menonaktifkan eksportir log lainnya.

OTEL_EXPORTER_OTLP_ENDPOINT

Tidak boleh digunakan.

OTEL_EXPORTER_OTLP_METRIC_ENDPOINT

Dengan menggunakan OTEL_EXPORTER_OTLP_METRIC_ENDPOINT konfigurasi dan instance OpenTelemetry Kolektor yang dikelola sendiri, Anda mungkin dapat terus mengirim metrik khusus ke tujuan yang Anda inginkan.

Dalam. NETpengaturan, variabel lingkungan ini didukung dalam instrumentasi manual, tetapi tidak instrumentasi otomatis. Anda tidak dapat menggunakan variabel lingkungan ini untuk mengirim metrik ke titik akhir Anda sendiri.

OTEL_EXPORTER_OTLP_TRACES_ENDPOINT

Tidak boleh digunakan.

OTEL_ATTRIBUTE_COUNT_LIMIT

Jika diatur, harus diatur cukup tinggi untuk menyertakan sekitar 10 atribut rentang lebih yang ditambahkan oleh Sinyal CloudWatch Aplikasi.

OTEL_EXPORTER_OTLP_PROTOCOL

Harus diatur ke http/protobuf

OTEL_PROPAGATORS

Jika diatur, harus menyertakan xray untuk penelusuran.

OTEL_TRACES_SAMPLER

Jika diatur, harus xray untuk menggunakan sampling terpusat X-Ray.

Untuk menggunakan sampling lokal, atur ini ke parentbased_traceidratio dan tentukan laju sampling di OTEL_TRACES_SAMPLER_ARG.

OTEL_TRACES_SAMPLER_ARG

Jika Anda menggunakan default sampel pelacakan terpusat X-Ray, variabel ini tidak boleh digunakan.

Jika Anda menggunakan sampling lokal sebagai gantinya, atur laju sampling dalam variabel ini. Misalnya, 0.05 untuk laju sampling 5%.

Variabel lingkungan khusus Java

OTEL_JAVA_ENABLED_RESOURCE_PROVIDERS

Jika diatur, harus menyertakan detektor AWS sumber daya.

Variabel lingkungan khusus Python

OTEL_PYTHON_CONFIGURATOR

Jika digunakan, harus diatur ke aws_configurator

OTEL_PYTHON_DISTRO

Jika digunakan, harus diatur ke aws_distro

Variabel lingkungan khusus Node.js

OTEL_NODE_ENABLED_INSTRUMENTATIONS

Kami menyarankan Anda menghapus variabel ini sehingga semua instrumentasi diaktifkan secara default.

OTEL_NODE_DISABLED_INSTRUMENTATIONS

Kami menyarankan Anda menghapus variabel ini. ADOT JavaScript SDKAkan menetapkan nilai default untuk menekan data telemetri berkualitas rendah.