View a markdown version of this page

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 API secara langsung atau AWS Command Line Interface (AWS CLI) untuk memanggil perintah X-Ray API. Gunakan panduan berikut untuk memilih cara Anda berinteraksi dengan API:

  • Gunakan sintaks AWS CLI untuk lebih sederhana menggunakan perintah pra-format atau dengan opsi di dalam permintaan Anda.

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

Jika Anda menggunakan X-Ray API secara langsung alih-alih AWS CLI, Anda harus memparametrisasi 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-Ray API:

X-Ray menampilkan informasi terperinci tentang permintaan aplikasi.

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

  • PutTraceSegments— Mengunggah dokumen segmen ke X-Ray.

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

  • GetTraceSummaries— Mengambil ID 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. X-Ray Men AWS CLI dukung semua fungsi yang tersedia di X-Ray SDK termasuk yang lain Layanan AWS. Fungsi berikut adalah versi operasi API yang tercantum sebelumnya dengan format yang lebih sederhana:

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

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

  • get-trace-summaries — Mengambil ID 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 CLI untuk sistem operasi Anda. AWS dukunganLinux, macOS dan sistem Windows operasi. Untuk informasi selengkapnya tentang daftar X-Ray perintah, lihat panduan Refer AWS CLI ensi Perintah untuk X-Ray.

Topik