Halaman ini menawarkan informasi ringkasan tentang pengumpulan rekaman aktivitas dengan OpenTelemetry. Untuk memantau dan men-debug permintaan Spanner, Anda dapat mengaktifkan rekaman aktivitas di library klien Spanner. Pelacakan sisi klien dan end-to-end dapat membantu Anda memantau performa dan men-debug masalah.
Trace memberikan informasi yang relevan untuk setiap permintaan dari klien, seperti berikut:
Rentang dengan stempel waktu saat klien mengirim permintaan RPC dan saat klien menerima respons RPC, termasuk latensi yang disebabkan oleh jaringan dan sistem klien.
Atribut (key-value pair) yang memberikan informasi tentang klien dan konfigurasinya.
Anotasi dengan peristiwa penting dalam rentang.
Untuk mengetahui informasi selengkapnya tentang rentang dan atribut, lihat Rentang dan Atribut dalam dokumentasi OpenTelemetry.
Pelacakan end-to-end
Selain pelacakan sisi klien, Anda dapat memilih untuk mengaktifkan pelacakan menyeluruh. Perekaman aktivitas end-to-end membantu Anda memahami dan men-debug masalah latensi yang khusus untuk Spanner seperti berikut:
Identifikasi apakah latensi disebabkan oleh latensi jaringan antara aplikasi dan Spanner, atau apakah latensi terjadi dalam Spanner.
Identifikasi Google Cloud region yang dilalui permintaan aplikasi Anda dan apakah ada permintaan lintas region. Permintaan lintas region biasanya berarti latensi yang lebih tinggi antara aplikasi dan Spanner Anda.
Untuk mencegah kelebihan beban Cloud Trace dan membantu mengelola biaya secara efektif, penelusuran end-to-end memiliki batas jumlah rentang aktivitas yang dapat Anda ekspor. Tidak ada dampak pada penggunaan pelacakan end-to-end untuk pemecahan masalah karena batas ini.
OpenTelemetry
Library klien Spanner mendukung pengumpulan rekaman aktivitas menggunakan API OpenTelemetry. OpenTelemetry adalah framework observabilitas open source. OpenTelemetry menawarkan berbagai konfigurasi seperti pengekspor untuk backend tertentu, rasio pengambilan sampel, dan batas rentang.
Mengekspor rekaman aktivitas menggunakan OTLP
Sebagai bagian dari konfigurasi OpenTelemetry, Anda menggunakan pengekspor untuk mengirim data
trace ke backend kemampuan observasi. Sebaiknya gunakan pengekspor OpenTelemetry Protocol
(OTLP)
yang mengirim data menggunakan protokol OpenTelemetry. Anda dapat mengonfigurasi pengekspor OTLP
untuk mengirim trace langsung ke backend kemampuan pengamatan yang mendukung OTLP,
seperti Cloud Trace menggunakan
Telemetry
API, atau
ke pengumpul OpenTelemetry.
Batasan
Rekaman aktivitas Spanner memiliki batasan berikut:
- Rentang rekaman aktivitas hanya tersedia untuk library klien Java, Go, Node, dan Python.
- Trace end-to-end hanya dapat diekspor ke Cloud Trace.
Harga
Selain penggunaan Spanner, pelacakan dapat menimbulkan biaya melalui backend kemampuan pengamatan Anda.
Penyerapan rentang rekaman aktivitas ke backend kemampuan observasi Anda dapat ditagih. Misalnya, jika Anda menggunakan Cloud Trace sebagai backend, Anda akan ditagih sesuai dengan harga Cloud Trace.
Untuk lebih memahami penagihan, mulailah dengan rasio pengambilan sampel rekaman aktivitas kecil berdasarkan traffic Anda.
Langkah berikutnya
Untuk menyiapkan tracing sisi klien dan end-to-end, lihat Menyiapkan pengumpulan rekaman aktivitas menggunakan OpenTelemetry.