Gunakan X-Ray API - AWS X-Ray

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

Gunakan X-Ray API

Jika X-Ray SDK tidak mendukung bahasa pemrograman Anda, Anda dapat menggunakan X-Ray APIs secara langsung atau AWS Command Line Interface (AWS CLI) untuk memanggil API perintah X-Ray. Gunakan panduan berikut untuk memilih bagaimana Anda berinteraksi denganAPI:

  • Gunakan sintaks AWS CLI untuk lebih sederhana menggunakan perintah yang telah diformat sebelumnya atau dengan opsi di dalam permintaan Anda.

  • Gunakan X-Ray API secara langsung untuk fleksibilitas maksimum dan kustomisasi untuk permintaan yang Anda buat untuk X-Ray.

Jika Anda menggunakan X-Ray API secara langsung alih-alih AWS CLI, Anda harus membuat parameter permintaan Anda dalam format data yang benar dan mungkin juga harus mengonfigurasi otentikasi dan penanganan kesalahan.

Diagram berikut menunjukkan panduan untuk memilih cara berinteraksi dengan X-RayAPI:

X-Ray menampilkan informasi rinci tentang permintaan aplikasi.

Gunakan X-Ray API untuk mengirim data jejak langsung ke X-Ray. X-Ray API mendukung semua fungsi yang tersedia dalam X-Ray SDK termasuk tindakan umum berikut:

  • PutTraceSegments— Mengunggah dokumen segmen ke X-Ray.

  • BatchGetTraces— Mengambil daftar jejak dalam daftar jejakIDs. Setiap jejak yang diambil adalah kumpulan dokumen segmen dari satu permintaan.

  • GetTraceSummaries— Mengambil IDs dan anotasi untuk jejak. Anda dapat menentukan a FilterExpression untuk mengambil subset ringkasan jejak.

  • GetTraceGraph— Mengambil grafik layanan untuk ID jejak tertentu.

  • GetServiceGraph— Mengambil dokumen yang JSON diformat yang menjelaskan layanan yang memproses permintaan masuk dan memanggil permintaan hilir.

Anda juga dapat menggunakan AWS Command Line Interface (AWS CLI) di dalam kode aplikasi Anda untuk berinteraksi secara terprogram dengan X-Ray. AWS CLI Mendukung semua fungsi yang tersedia di X-Ray SDK termasuk yang lain Layanan AWS. Fungsi-fungsi berikut adalah versi API operasi yang terdaftar sebelumnya dengan format yang lebih sederhana:

  • put-trace-segments— Mengunggah dokumen segmen ke X-Ray.

  • batch-get-traces— Mengambil daftar jejak dalam daftar jejakIDs. Setiap jejak yang diambil adalah kumpulan dokumen segmen dari satu permintaan.

  • get-trace-summaries— Mengambil IDs dan anotasi untuk jejak. Anda dapat menentukan a FilterExpression untuk mengambil subset ringkasan jejak.

  • get-trace-graph— Mengambil grafik layanan untuk ID jejak tertentu.

  • get-service-graph— Mengambil dokumen yang JSON diformat yang menjelaskan layanan yang memproses permintaan masuk dan memanggil permintaan hilir.

Untuk memulai, Anda harus menginstal AWS CLIuntuk sistem operasi Anda. AWS mendukungLinux, macOS dan sistem Windows operasi. Untuk informasi selengkapnya tentang daftar perintah X-Ray, lihat panduan Referensi AWS CLI Perintah untuk X-Ray.

Topik