Halaman ini memberikan ringkasan komponen tingkat tinggi yang terlibat dalam permintaan Spanner dan pengaruh setiap komponen terhadap latensi.
Permintaan Spanner API
Komponen tingkat tinggi yang digunakan untuk membuat permintaan Spanner API mencakup:
Library klien Spanner, yang menyediakan lapisan abstraksi di atas gRPC, dan menangani detail komunikasi server, seperti pengelolaan sesi, transaksi, dan percobaan ulang.
Google Front End (GFE), yang merupakan layanan infrastruktur yang umum digunakan untuk semua layanan Google Cloud , termasuk Spanner. GFE memverifikasi bahwa semua koneksi Transport Layer Security (TLS) dihentikan dan menerapkan perlindungan terhadap serangan Denial of Service. Untuk mempelajari GFE lebih lanjut, lihat Layanan Google Front End.
Frontend API (AFE) Spanner, yang melakukan berbagai pemeriksaan pada permintaan API (termasuk autentikasi, otorisasi, dan pemeriksaan kuota) , serta mengelola sesi dan status transaksi.
Database Spanner, yang menjalankan pembacaan dan penulisan ke database.
Saat Anda melakukan remote procedure call ke Spanner, library klien Spanner akan menyiapkan permintaan API. Kemudian, permintaan API akan melewati GFE dan AFE Spanner sebelum mencapai database Spanner.
Dengan mengukur dan membandingkan latensi permintaan antara berbagai komponen dan database, Anda dapat menentukan komponen mana yang menyebabkan masalah. Latensi ini mencakup latensi end-to-end klien, GFE, permintaan Spanner API, dan kueri.

Bagian berikut menjelaskan setiap jenis latensi yang Anda lihat dalam diagram sebelumnya.
Konektivitas langsung
Traffic aplikasi yang memenuhi kriteria tertentu dapat dirutekan langsung ke Spanner, melewati Google Front End (GFE) dan mengoptimalkan performa. Konektivitas langsung dapat diaktifkan untuk aplikasi yang memenuhi kriteria berikut:
- Berjalan di Compute Engine atau Google Kubernetes Engine.
- Gunakan endpoint global.
- Dalam jaringan yang dikonfigurasi dengan rute dan aturan firewall yang mengizinkan traffic egress
untuk menjangkau
34.126.0.0/18dan2001:4860:8040::/42. - Menggunakan versi library klien:
- Java: 6.111.0 atau yang lebih baru.
- Go: 1.88.0 atau yang lebih baru.
- Kredensial yang Anda gunakan untuk aplikasi memiliki izin
spanner.databases.get.
Fitur ini dapat diaktifkan dengan menetapkan
variabel lingkungan GOOGLE_SPANNER_ENABLE_DIRECT_ACCESS ke true
atau melalui konfigurasi library klien Anda (
setEnableDirectAccess(true)
di Java, ClientConfig.EnableDirectAccess
di Go, atau properti koneksi enableDirectAccess=true di
driver JDBC).
Untuk memverifikasi apakah konektivitas langsung Spanner sedang digunakan, pantau label penggunaan di metrik sisi klien Anda.
Latensi menyeluruh
Latensi menyeluruh adalah durasi waktu (dalam milidetik) antara byte pertama permintaan Spanner API yang dikirim klien ke database (melalui GFE dan frontend Spanner API), dan byte terakhir respons yang diterima klien dari database.

Metrik
spanner.googleapis.com/client/operation_latencies
memberikan waktu antara byte pertama permintaan API
yang dikirim hingga byte terakhir respons yang diterima. Hal ini mencakup percobaan ulang yang dilakukan oleh library klien.
Untuk mengetahui informasi selengkapnya, lihat Melihat dan mengelola metrik sisi klien.
Latensi GFE
Latensi Google Front End (GFE) adalah durasi waktu (dalam milidetik) antara saat jaringan Google menerima remote procedure call dari klien dan saat GFE menerima byte pertama respons. Latensi ini tidak mencakup handshake TCP atau TLS.

Setiap respons dari Spanner (REST atau gRPC) menyertakan header yang berisi total waktu antara GFE dan backend (layanan Spanner) untuk permintaan dan respons. Hal ini membantu membedakan sumber latensi antara klien dan GFE dengan lebih baik.
Metrik spanner.googleapis.com/client/gfe_latencies
menangkap dan mengekspos latensi GFE untuk permintaan Spanner.
Klien membaca latensi GFE dari header respons. Jika permintaan gagal atau
waktu habis sebelum klien menerimanya (misalnya, dengan
error DEADLINE_EXCEEDED), klien tidak akan mencatat latensi GFE dan
akan meningkatkan
metrik
spanner.googleapis.com/client/gfe_connectivity_error_count. Saat Anda memecahkan masalah waktu tunggu, periksa metrik ini dan metrik spanner.googleapis.com/client/attempt_latencies selain latensi GFE. Jika jumlah error konektivitas GFE meningkat, permintaan akan gagal sebelum klien menerima header respons, meskipun latensi GFE terlihat normal. Dalam hal ini, latensi dapat berasal dari mana saja antara klien dan backend Spanner.
Untuk mengetahui informasi selengkapnya, lihat Melihat dan mengelola metrik sisi klien.
Latensi permintaan Spanner API
Latensi permintaan API Spanner adalah durasi waktu (dalam detik) dari saat AFE Spanner menerima byte pertama permintaan hingga saat frontend Spanner API mengirim byte terakhir respons. Latensi mencakup waktu yang diperlukan untuk memproses permintaan API di backend Spanner dan lapisan API. Namun, latensi ini tidak mencakup overhead jaringan atau reverse-proxy antara klien dan server Spanner.

Metrik spanner.googleapis.com/api/request_latencies menangkap
dan mengekspos latensi AFE Spanner untuk permintaan
Spanner. Untuk mengetahui informasi selengkapnya, lihat
Metrik Spanner.
Latensi kueri
Latensi kueri adalah durasi waktu (dalam milidetik) yang diperlukan untuk menjalankan kueri SQL di database Spanner.

Latensi kueri tersedia untuk API executeSql.
Jika parameter
QueryMode
ditetapkan ke WITH_STATS atau WITH_PLAN_AND_STATS,
ResultSetStats
Spanner akan tersedia dalam respons. ResultSetStats mencakup waktu yang berlalu untuk menjalankan kueri di database Spanner.
Untuk menangkap dan memvisualisasikan latensi kueri, lihat Menangkap latensi kueri dengan OpenTelemetry.
Langkah berikutnya
- Pelajari cara mengidentifikasi titik latensi di komponen Spanner.