Deskripsi metrik sisi klien

Halaman ini memberikan deskripsi mendetail tentang setiap metrik sisi klien yang ditawarkan Spanner. Untuk mengetahui informasi selengkapnya tentang cara melihat dan mengelola metrik sisi klien, lihat Melihat dan mengelola metrik sisi klien.

Metrik sisi klien menawarkan informasi latensi tentang upaya dan operasi permintaan RPC klien ke Spanner.

Upaya adalah satu permintaan RPC dari klien ke Spanner. Klien dapat melakukan beberapa upaya jika permintaan gagal.

Operasi mewakili penyelesaian semua permintaan RPC, termasuk semua upaya yang dilakukan klien ke Spanner. Operasi selesai saat klien menerima respons atau menghabiskan semua upaya.

Permintaan RPC pertama-tama mencapai Google Front End (GFE), lalu frontend Spanner API (AFE). Untuk mengetahui informasi selengkapnya, lihat Titik latensi dalam permintaan Spanner.

Klien menghitung metrik latensi GFE dan latensi AFE dari informasi pengaturan waktu yang ditambahkan GFE dan AFE ke header respons. Jika upaya berakhir sebelum klien menerima header respons, klien tidak akan mencatat sampel latensi GFE atau AFE untuk upaya tersebut. Misalnya, hal ini terjadi saat batas waktu permintaan berakhir dan klien menampilkan error DEADLINE_EXCEEDED. Sebagai gantinya, klien akan menambah metrik jumlah error konektivitas yang sesuai. Akibatnya, distribusi latensi GFE dan AFE hanya mencakup upaya yang menerima header respons dan mungkin terlihat normal meskipun banyak upaya yang mengalami waktu tunggu habis.

Klien mencatat metrik GFE hanya untuk permintaan yang melewati GFE. Jika permintaan menggunakan DirectPath (directpath_used adalah true), klien tidak akan mencatat latensi GFE atau jumlah error konektivitas GFE untuk permintaan tersebut.

Metrik ini mencakup jenis nilai metrik DISTRIBUTION dan INT64. Untuk informasi selengkapnya, lihat Jenis nilai dan jenis metrik.

Anda dapat mengakses metrik sisi klien menggunakan library klien Spanner untuk Java, Go, Node.js, dan Python.

Metrik sisi klien mendukung semua metode Spanner di google.spanner.v1.Spanner RPC API.

Semua metrik sisi klien memiliki dimensi berikut:

  • project ID: Google Cloud Project ID
  • instance ID: ID instance Spanner.
  • database ID: ID database Spanner.
  • location: region Google Cloud tempat metrik sisi klien dipublikasikan. Jika aplikasi Anda di-deploy di luar Google Cloud, metrik akan dipublikasikan ke region global.
  • method: nama metode RPC—misalnya, spanner.commit.
  • status: status RPC—misalnya, OK atau INTERNAL.
  • client_name: nama dan versi library—misalnya, spanner-java/6.70.1.
  • directpath_enabled: apakah library klien dikonfigurasi untuk langsung mengakses Spanner tanpa melalui frontend.
  • directpath_used: apakah permintaan saat ini dikirim langsung ke Spanner tanpa melalui frontend. Nilai false sementara directpath_enabled adalah true menunjukkan bahwa permintaan di-fallback ke jalur standar yang melewati GFE.

Jumlah error konektivitas AFE

Metrik jumlah error konektivitas AFE mencatat jumlah upaya yang dilakukan klien yang tidak menerima informasi pengaturan waktu AFE Spanner di header respons. Hal ini terjadi, misalnya, saat permintaan tidak mencapai AFE atau saat upaya kehabisan waktu sebelum klien menerima header respons. Metrik latensi AFE tidak mencatat sampel untuk upaya ini.

Metrik jumlah error konektivitas AFE memiliki atribut berikut:

  • Metric name: spanner.googleapis.com/client/afe_connectivity_error_count
  • Metric value type: INT64

Latensi AFE

Metrik latensi AFE mengukur waktu antara Spanner AFE menerima permintaan RPC dari klien dan Spanner AFE mulai menulis respons.

Klien menghitung nilai ini dari informasi pengaturan waktu di header respons. Jika upaya berakhir sebelum klien menerima header respons, klien tidak akan mencatat sampel dan akan menambah metrik AFE connectivity error count.

Metrik latensi AFE memiliki atribut berikut:

  • Metric name: spanner.googleapis.com/client/afe_latencies
  • Metric value type: DISTRIBUTION

Jumlah percobaan

Metrik jumlah upaya mencatat jumlah upaya yang dilakukan. Nilai attempt_count biasanya sama dengan nilai operation_count. Jika klien menerima error sementara, nilai attempt_count adalah jumlah dari semua upaya.

Metrik Jumlah upaya memiliki atribut berikut:

  • Metric name: spanner.googleapis.com/client/attempt_count
  • Metric value type: INT64

Latensi percobaan

Metrik latensi upaya mengukur durasi satu upaya RPC, sejak klien mengirim permintaan hingga upaya tersebut berhasil atau gagal. Nilai attempt_latencies biasanya sama dengan nilai operation_latencies. Jika klien menerima error sementara, nilai operation_latencies adalah jumlah dari semua nilai attempt_latencies.

Metrik Latensi percobaan memiliki atribut berikut:

  • Metric name: spanner.googleapis.com/client/attempt_latencies
  • Metric value type: DISTRIBUTION

Jumlah error konektivitas GFE

Metrik jumlah error konektivitas GFE mencatat jumlah upaya yang membuat klien tidak menerima informasi pengaturan waktu GFE di header respons. Hal ini terjadi, misalnya, saat permintaan tidak mencapai GFE atau saat upaya kehabisan waktu sebelum klien menerima header respons. Metrik latensi GFE tidak mencatat sampel untuk upaya ini.

Metrik jumlah error konektivitas GFE memiliki atribut berikut:

  • Metric name: spanner.googleapis.com/client/gfe_connectivity_error_count
  • Metric value type: INT64

Latensi GFE

Metrik latensi GFE mengukur waktu antara GFE menerima permintaan RPC dari klien dan saat GFE menerima byte pertama respons. Metrik ini tidak mencakup waktu yang diperlukan untuk handshake TCP atau TLS.

Klien menghitung nilai ini dari informasi pengaturan waktu di header respons. Jika upaya berakhir sebelum klien menerima header respons, klien tidak akan mencatat sampel dan akan menambah metrik GFE connectivity error count. Jika jumlah error konektivitas GFE meningkat, latensi GFE yang terlihat normal tidak berarti latensinya rendah.

Metrik latensi GFE memiliki atribut berikut:

  • Metric name: spanner.googleapis.com/client/gfe_latencies
  • Metric value type: DISTRIBUTION

Jumlah operasi

Metrik jumlah operasi mencatat jumlah operasi yang dilakukan setiap 60 detik.

Metrik Operation count memiliki atribut berikut:

  • Metric name: spanner.googleapis.com/client/operation_count
  • Metric value type: INT64

Latensi operasi

Metrik latensi operasi mengukur perjalanan bolak-balik operasi dari lapisan gRPC klien ke Spanner dan kembali ke klien.

Metrik Operation latencies memiliki atribut berikut:

  • Metric name : spanner.googleapis.com/client/operation_latencies
  • Metric value type: DISTRIBUTION

Langkah berikutnya