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

AWS X-Ray SDK for Go

X-Ray SDK for Go adalah serangkaian pustaka untuk aplikasi Go yang menyediakan kelas dan metode untuk menghasilkan dan mengirim pelacakan data ke daemon X-Ray. Data pelacakan mencakup informasi tentang permintaan HTTP yang masuk dibantu oleh aplikasi, dan panggilan yang aplikasi buat untuk layanan hilir menggunakan AWS SDK, klien HTTP, atau konektor basis data SQL. Anda juga dapat membuat segmen secara manual dan menambahkan informasi debug dalam anotasi dan metadata.

Unduh SDK dari repositori GitHub dengan go get:

$ go get -u github.com/aws/aws-xray-sdk-go/... 

Untuk aplikasi web, mulai dengan menggunakan xray.Handler fungsi untuk melacak permintaan yang masuk. Pesan handler membuat segmen untuk setiap permintaan yang dilacak, dan melengkapi segmen ketika respons dikirim. Ketika segmen terbuka Anda dapat menggunakan metode klien SDK untuk menambahkan informasi ke segmen dan membuat subsegmen untuk pelacakan panggilan hilir. SDK juga secara otomatis mencatat pengecualian yang aplikasi Anda lempar ketika segmen terbuka.

Untuk fungsi Lambda disebut oleh instrumen aplikasi atau layanan, Lambda membaca tracing header dan pelacakan sampel permintaan secara otomatis. Untuk fungsi lainnya, Anda dapat mengonfigurasi Lambda untuk sampel dan pelacakan permintaan masuk. Dalam kedua kasus, Lambda membuat segmen dan menyediakannya ke X-Ray SDK.

Selanjutnya, bungkus klien Anda dengan panggilan ke AWS fungsi. Langkah ini memastikan bahwa instrumen X-Ray memanggil metode klien apa pun. Anda juga dapat instrumen panggilan ke basis data SQL.

Setelah menjalankan SDK, sesuaikan perilakunyamengkonfigurasi perekam dan middleware. Anda dapat menambahkan plugin untuk mencatat data mengenai sumber daya komputasi yang berjalan di aplikasi Anda, menyesuaikan perilaku sampling dengan mendefinisikan aturan sampling, dan mengatur tingkat log untuk melihat lebih atau kurang informasi dari SDK dalam log aplikasi Anda.

Catat informasi tambahan tentang permintaan dan pekerjaan yang dilakukan aplikasi Anda dalam anotasi dan metadata. Anotasi adalah pasangan kunci-nilai sederhana yang diindeks untuk digunakan dengan ekspresi filter, sehingga Anda dapat mencari pelacakan yang berisi data tertentu. Entri metadata kurang bersifat membatasi dan dapat mencatat seluruh objek dan array — segala yang dapat disambungkan ke dalam JSON.

Bila Anda memiliki banyak klien diinstrumentasi dalam kode Anda, segmen permintaan tunggal dapat berisi sejumlah besar subsegmen, satu untuk setiap panggilan yang dilakukan dengan klien yang diinstrumentasi. Anda dapat mengatur dan mengelompokkan subsegmen dengan menggabungkan panggilan klien di subsegmen kustom. Anda dapat membuat subsegmen kustom untuk seluruh fungsi atau bagian dari kode apa pun, dan mencatat metadata dan anotasi pada subsegmen alih-alih menulis semuanya pada segmen induk.

Persyaratan

X-Ray SDK for Go memerlukan Go 1.9 atau versi yang lebih baru.

SDK tergantung pada pustaka berikut saat kompilasi dan waktu aktif:

Ketergantungan ini dinyatakan dalam file README.md.

Referensi dokumentasi

Setelah Anda mengunduh SDK, membangun dan meng-host dokumentasi lokal untuk melihatnya di web peramban.