Melihat dan mengelola metrik sisi klien

Halaman ini menawarkan informasi tentang cara melihat dan mengelola metrik sisi klien. Metrik sisi klien menawarkan informasi latensi tentang permintaan RPC klien ke Spanner.

Spanner menyediakan metrik sisi klien yang dapat Anda gunakan bersama dengan metrik sisi server untuk mengoptimalkan performa dan memecahkan masalah performa jika terjadi.

Metrik sisi klien diukur dari saat permintaan keluar dari aplikasi Anda hingga saat aplikasi Anda menerima respons. Sebaliknya, metrik sisi server diukur dari saat Spanner menerima permintaan hingga byte data terakhir dikirim ke klien.

Sebelum memulai

  1. Metrik sisi klien tersedia setelah Anda mengaktifkan Cloud Monitoring API.

    Mengaktifkan Monitoring API

  2. Untuk mendapatkan izin yang diperlukan untuk mengakses metrik sisi klien, minta administrator Anda untuk memberi Anda peran IAM Monitoring Metric Writer (roles/monitoring.metricWriter) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

    Peran bawaan ini berisi izin monitoring.timeSeries.create yang diperlukan untuk mengakses metrik sisi klien.

    Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Mengakses metrik sisi klien

Anda dapat mengakses metrik sisi klien menggunakan library klien berikut:

  • Java di versi 6.81.0 dan yang lebih baru.
  • Go di versi 1.71.0 dan yang lebih baru.

Untuk melihat metrik sisi klien di Metrics Explorer, lakukan hal berikut:

  1. Di konsol Google Cloud , buka halaman Metrics Explorer.

    Buka Metrics Explorer

  2. Pilih project Anda.

  3. Klik Select a metric.

  4. Telusuri spanner.googleapis.com/client.

  5. Pilih metrik, lalu klik Terapkan.

Untuk mengetahui informasi selengkapnya tentang cara mengelompokkan atau menggabungkan metrik, lihat Membangun kueri menggunakan menu.

Aplikasi Anda harus berjalan setidaknya selama satu menit sebelum Anda dapat melihat metrik yang dipublikasikan.

Menonaktifkan metrik sisi klien

Jika sudah menggunakan OpenTelemetry untuk merekam metrik klien kustom, Anda dapat memilih untuk tidak menggunakan metrik sisi klien dengan menggunakan kode berikut:

Java 

Spanner spanner =
  SpannerOptions.newBuilder()
    .setProjectId("test-project")
    .setBuiltInMetricsEnabled(false)
    .build()
    .getService();

Go 

    client, err := spanner.NewClientWithConfig(ctx, database, spanner.ClientConfig{
    DisableNativeMetrics: true,
    })

Harga

Tidak ada biaya untuk melihat metrik sisi klien di Cloud Monitoring. Penggunaan Monitoring API dapat menimbulkan biaya. Untuk mengetahui informasi selengkapnya, lihat harga Google Cloud Observability.

Langkah berikutnya