Gunakan sebuah SDK

Gunakan SDK jika Anda ingin menggunakan antarmuka baris perintah atau memerlukan lebih banyak kemampuan penelusuran, pemantauan, atau pencatatan kustom daripada yang tersedia di file. AWS Management Console Anda juga dapat menggunakan sebuah AWS SDK untuk mengembangkan program yang menggunakan X-RayAPIs. Anda dapat menggunakan AWS Distro for OpenTelemetry (ADOT) SDK atau SDK X-Ray.

Jika Anda menggunakan sebuahSDK, Anda dapat menambahkan kustomisasi ke alur kerja Anda baik ketika Anda instrumen aplikasi Anda dan ketika Anda mengkonfigurasi kolektor atau agen Anda. Anda dapat menggunakan an SDK untuk melakukan tugas-tugas berikut yang tidak dapat Anda lakukan dengan menggunakan AWS Management Console:

• Publikasikan metrik khusus — Contoh metrik pada resolusi tinggi hingga 1 detik, gunakan beberapa dimensi untuk menambahkan informasi tentang metrik, dan agregat titik data ke dalam kumpulan statistik.

• Sesuaikan kolektor Anda - Sesuaikan konfigurasi untuk setiap bagian dari kolektor termasuk penerima, prosesor, eksportir, dan konektor.

• Sesuaikan instrumentasi Anda — Sesuaikan segmen dan subsegmen, tambahkan pasangan nilai kunci khusus sebagai atribut, dan buat metrik khusus.

• Buat dan perbarui aturan pengambilan sampel secara terprogram.

Gunakan ADOT SDK jika Anda ingin fleksibilitas menggunakan standar OpenTelemetry SDK dengan lapisan AWS keamanan dan optimasi tambahan. AWS Distro for OpenTelemetry (ADOT) SDK adalah paket vendor-agnostik yang memungkinkan integrasi dengan back end dari vendor lain dan AWS non-layanan tanpa harus menginstrumentasi ulang kode Anda.

Gunakan X-Ray SDK jika Anda sudah menggunakan X-RaySDK, hanya mengintegrasikan dengan AWS backend, dan tidak ingin mengubah cara Anda berinteraksi dengan X-Ray atau kode aplikasi Anda.

Untuk informasi selengkapnya tentang setiap fitur, lihatMemilih antara AWS Distro untuk OpenTelemetry dan X-Ray SDKs.

Gunakan ADOT SDK

ADOTSDKIni adalah satu set open sourceAPIs, perpustakaan dan agen yang mengirim data ke layanan backend. ADOTdidukung oleh AWS, terintegrasi dengan beberapa backend dan agen, dan menyediakan sejumlah besar pustaka open source yang dikelola oleh komunitas. OpenTelemetry Gunakan ADOT SDK untuk instrumen aplikasi Anda dan kumpulkan log, metadata, metrik, dan jejak. Anda juga dapat menggunakan ADOT untuk memantau layanan dan mengatur alarm berdasarkan metrik Anda. CloudWatch

Jika Anda menggunakan ADOTSDK, Anda memiliki opsi berikut, dalam kombinasi dengan agen:

• Gunakan ADOT SDK dengan CloudWatch agen — direkomendasikan.

• Gunakan ADOT SDK dengan ADOTKolektor — direkomendasikan jika Anda ingin menggunakan perangkat lunak agnostik vendor dengan AWS lapisan keamanan dan pengoptimalan.

Untuk menggunakan ADOTSDK, lakukan hal berikut:

• Instrumen aplikasi Anda menggunakan ADOTSDK. Untuk informasi selengkapnya, lihat dokumentasi untuk bahasa pemrograman Anda di dokumentasi ADOT teknis.

• Konfigurasikan ADOT kolektor untuk memberi tahu ke mana harus mengirim data yang dikumpulkannya.

Setelah ADOT kolektor menerima data Anda, ia mengirimkannya ke backend yang Anda tentukan dalam konfigurasi. ADOT ADOTdapat mengirim data ke beberapa backend, termasuk ke vendor di luar AWS, seperti yang ditunjukkan pada diagram berikut:

AWS memperbarui secara teratur ADOT untuk menambahkan fungsionalitas dan menyelaraskan dengan OpenTelemetrykerangka kerja. Pembaruan dan rencana pengembangan masa depan ADOT adalah bagian dari peta jalan yang tersedia untuk umum. ADOTmendukung beberapa bahasa pemrograman yang meliputi:

• Go

• Java

• JavaScript

• Python

• .NET

• Ruby

• PHP

Jika Anda menggunakan Python, secara otomatis ADOT dapat instrumen aplikasi Anda. Untuk mulai menggunakanADOT, lihat Pendahuluan dan Memulai dengan AWS Distro untuk OpenTelemetry Kolektor.

Gunakan X-Ray SDK

SDKX-Ray adalah sekumpulan AWS APIs dan pustaka yang mengirim data ke layanan AWS backend. Gunakan X-Ray SDK untuk instrumen aplikasi Anda dan mengumpulkan data jejak. Anda tidak dapat menggunakan X-Ray SDK untuk mengumpulkan data log atau metrik.

Jika Anda menggunakan X-RaySDK, Anda memiliki opsi berikut, dalam kombinasi dengan agen:

• Gunakan X-Ray SDK dengan AWS X-Ray daemon — Gunakan ini jika Anda tidak ingin memperbarui kode aplikasi Anda.

• Gunakan X-Ray SDK dengan CloudWatch agen — (disarankan) CloudWatch Agen ini kompatibel dengan X-RaySDK.

Untuk menggunakan X-RaySDK, lakukan hal berikut:

• Instrumen aplikasi Anda menggunakan X-RaySDK.

• Konfigurasikan kolektor untuk memberi tahu ke mana harus mengirim data yang dikumpulkannya. Anda dapat menggunakan CloudWatch agen atau daemon X-Ray untuk mengumpulkan informasi jejak Anda.

Setelah kolektor atau agen menerima data Anda, ia mengirimkannya ke AWS backend yang Anda tentukan dalam konfigurasi agen. X-Ray hanya SDK dapat mengirim data ke AWS backend seperti yang ditunjukkan pada diagram berikut:

Jika Anda menggunakanJava, Anda dapat menggunakan X-Ray SDK untuk secara otomatis instrumen aplikasi Anda. Untuk mulai menggunakan X-RaySDK, lihat perpustakaan yang terkait dengan bahasa pemrograman berikut:

• Go

• Java

• Node.js

• Python

• .NET

• Ruby