Ringkasan pemantauan

Pemantauan di Spanner Omni berfungsi mirip dengan pemantauan di Spanner, dengan beberapa pengecualian. Dokumen ini memberikan penjelasan tentang pengecualian tersebut dan mengarahkan Anda ke informasi terkait dalam dokumentasi pemantauan Spanner. Saat Anda membaca dokumentasi Spanner, lihat kembali halaman ini untuk mengonfirmasi perbedaan Spanner Omni.

Fitur Spanner yang tidak didukung

Spanner Omni mendukung semua fitur pemantauan Spanner, kecuali pelacakan end-to-end.

Mengambil sinyal telemetri

Untuk mendapatkan insight tentang performa, penggunaan, dan potensi masalah, Anda dapat menangkap sinyal dari database Spanner Omni.

Ringkasan pengambilan sinyal

Sinyal telemetri membantu Anda memahami performa database.

Sinyal berikut tersedia untuk Spanner Omni:

Jenis sinyal Deskripsi
Metrik Data numerik tentang kondisi atau performa database.
Log Membuat catatan aktivitas sistem dari waktu ke waktu.
Trace Jalur permintaan melalui aplikasi Anda.
Tabel statistik Tabel bawaan untuk membuat kueri informasi database.

Di Spanner Omni, metrik sisi klien tidak didukung. Metrik sisi klien mencakup latensi untuk metrik GFE, pengumpulan metrik sisi klien, dan pengumpulan metrik sisi klien kustom. Untuk mengetahui informasi selengkapnya, lihat Ringkasan pengambilan sinyal dalam dokumentasi Spanner.

Pengumpulan trace

Trace mewakili jalur permintaan melalui aplikasi Anda. Dengan trace, Anda dapat mengikuti alur permintaan dan mengidentifikasi akar penyebab masalah. Misalnya, pelacakan dapat memberikan informasi untuk setiap permintaan dari klien, seperti span dengan stempel waktu saat klien mengirim dan menerima permintaan RPC. Hal ini membantu Anda memantau dan men-debug permintaan database.

Untuk mengetahui informasi selengkapnya, lihat Ringkasan pengumpulan trace dalam dokumentasi Spanner.

Menyiapkan pengumpulan trace menggunakan OpenTelemetry

Anda dapat mengonfigurasi library klien Spanner untuk mengekspor trace menggunakan API OpenTelemetry. Proses ini melibatkan konfigurasi OpenTelemetry SDK dan penggunaan pengekspor untuk mengirim data trace ke backend kemampuan observasi.

Pelacakan sisi klien tidak tersedia untuk Spanner Omni.

Untuk mengetahui informasi selengkapnya, lihat Menyiapkan pengumpulan trace menggunakan OpenTelemetry dalam dokumentasi Spanner.

Mengekspor trace server ke kolektor

Server Spanner Omni dapat mengekspor trace-nya sendiri dalam format OTLP ke kolektor trace, seperti Jaeger. Untuk menetapkan kolektor, lakukan salah satu hal berikut:

  • Di VM, tetapkan variabel lingkungan SPANNER_TRACE_EXPORTER_ENDPOINT sebelum Anda memulai server. Untuk mengetahui informasi selengkapnya, lihat Mengumpulkan dan menganalisis trace.

  • Di Kubernetes, tetapkan nilai Helm deployment.traceExporterEndpoint:

    helm upgrade spanner-omni oci://us-docker.pkg.dev/spanner-omni/charts/spanner-omni \
        --version 2.0.0 \
        --namespace NAMESPACE \
        --reuse-values \
        --set deployment.traceExporterEndpoint=dns:///COLLECTOR_HOST:COLLECTOR_PORT
    

    Jika Anda menginstal diagram Helm dengan monitoring.enabled=true dan tidak menetapkan deployment.traceExporterEndpoint, server akan mengekspor trace ke kolektor Jaeger yang diinstal diagram Helm, di dns:///jaeger.monitoring.svc.cluster.local:4317.

Server mengekspor trace ke endpoint soket domain Unix (target yang dimulai dengan unix: atau unix-abstract:) tanpa TLS, karena trace tidak keluar dari host. Server memperlakukan setiap kolektor lain sebagai jarak jauh, termasuk kolektor di localhost, alamat IP loopback, pod atau layanan lain, atau alamat IP node Kubernetes (misalnya, $HOST_IP:4317 untuk kolektor DaemonSet).

Mengekspor trace melalui TLS

Mulai dari rilis Spanner Omni 2026.r4-lts.3, server dalam deployment dengan enkripsi TLS mengekspor trace ke kolektor jarak jauh hanya melalui TLS. Rilis sebelumnya mengekspor trace ke kolektor jarak jauh dalam teks biasa dan tidak mendukung ekspor trace TLS. Untuk mengekspor trace ke kolektor jarak jauh, lakukan hal berikut:

  1. Buat CA trace collector (ca-otlp.crt) dan sertifikat collector untuk nama host collector di endpoint trace exporter:

  2. Aktifkan TLS pada penerima gRPC OTLP kolektor dengan sertifikat kolektor. Contoh berikut menggunakan file collector.crt dan collector.key di direktori otlp-certs. Jalankan perintah dari direktori tempat Anda membuat sertifikat, atau ganti otlp-certs dengan jalur lengkap ke direktori tersebut.

    • Untuk Jaeger v1 (jaeger-all-in-one) di VM:

      export COLLECTOR_OTLP_ENABLED=true
      export COLLECTOR_OTLP_GRPC_TLS_ENABLED=true
      export COLLECTOR_OTLP_GRPC_TLS_CERT=otlp-certs/collector.crt
      export COLLECTOR_OTLP_GRPC_TLS_KEY=otlp-certs/collector.key
      jaeger-all-in-one
      

      Jaeger v2 mengonfigurasi TLS dalam file konfigurasinya. Untuk mengetahui informasi selengkapnya, lihat dokumentasi keamanan Jaeger.

    • Untuk kolektor Jaeger yang diinstal oleh diagram Helm dengan monitoring.enabled=true, buat secret TLS bernama jaeger-tls di namespace monitoring:

      kubectl create secret tls jaeger-tls -n monitoring \
          --cert=otlp-certs/collector.crt --key=otlp-certs/collector.key
      

      Mulai dari Helm chart versi 2.0.0, kolektor Jaeger menyajikan TLS secara default dalam deployment dengan enkripsi TLS, menggunakan secret jaeger-tls. Dalam deployment ini, helm install dan helm upgrade akan gagal jika secret tidak ada, kecuali jika Anda menetapkan deployment.traceExporterEndpoint ke kolektor Anda sendiri. Untuk menggunakan secret dengan nama yang berbeda, tetapkan monitoring.jaeger.tls.secretName. Jaeger memuat ulang sertifikat setiap monitoring.jaeger.tls.reloadInterval (default: 1h), sehingga Anda dapat merotasi sertifikat tanpa memulai ulang.

      Helm chart versi 2.0.0 memerlukan rilis Spanner Omni 2026.r4-lts.3 atau yang lebih baru. Dengan rilis sebelumnya, gunakan chart Helm versi 1.x.

  3. Distribusikan ca-otlp.crt ke server bersama dengan sertifikat lainnya:

  4. Mulai atau mulai ulang server. Server memutuskan apakah akan menggunakan TLS saat memulai, berdasarkan ada tidaknya ca-otlp.crt, sehingga penambahan atau penghapusan file hanya akan berlaku setelah dimulai ulang. Perubahan pada file yang ada, seperti rotasi sertifikat, akan diterapkan tanpa memulai ulang.

    Di Kubernetes, menambahkan kunci ke secret tls-certs tidak akan memulai ulang server. Untuk memulai ulang, jalankan perintah berikut:

    kubectl rollout restart statefulset -n NAMESPACE \
        -l app.kubernetes.io/instance=spanner-omni
    

Server memverifikasi bahwa sertifikat kolektor diterbitkan oleh ca-otlp.crt dan cocok dengan nama host di endpoint pengekspor trace. Server tidak menampilkan sertifikat klien, jadi jangan mengonfigurasi kolektor untuk mewajibkan sertifikat klien. Jika ca-otlp.crt ada, server juga menggunakan TLS untuk kolektor jarak jauh dalam deployment tanpa enkripsi TLS.

Memantau trace yang dihapus

Dalam deployment dengan enkripsi TLS, jika ca-otlp.crt tidak ada, server tidak akan mengekspor trace ke kolektor jarak jauh. Server mencatat peringatan pembatasan kapasitas yang menjelaskan cara memperbaiki konfigurasi, dan menghitung trace yang dihapus dalam metrik Prometheus opentelemetry_dropped_spans, dengan label reason ditetapkan ke secure_mode.

Sebelum Anda membuat deployment, server tidak dapat menentukan apakah deployment menggunakan enkripsi TLS. Sebelum itu, jika ca-otlp.crt tidak ada, server tidak akan mengekspor trace ke kolektor jarak jauh dan menghitungnya dengan label reason yang ditetapkan ke deployment_state_unavailable.

Jika ca-otlp.crt bukan sertifikat CA yang valid, atau jika sertifikat kolektor tidak diterbitkan oleh ca-otlp.crt atau tidak cocok dengan nama host di endpoint pengekspor trace, koneksi ke kolektor akan gagal hingga Anda memperbaiki konfigurasi. Metrik opentelemetry_dropped_spans tidak menghitung kegagalan ini. Untuk mendeteksinya, periksa log server untuk TLS handshake dan error ekspor trace. Server juga mencatat peringatan saat memulai jika ca-otlp.crt tidak berisi sertifikat PEM.

Log audit

Log audit melacak perubahan administratif dan peristiwa akses data untuk keamanan dan kepatuhan. Anda dapat menggunakan log audit untuk memantau latensi permintaan dengan mengacu pada kolom durasi pemrosesan. Untuk mengetahui informasi selengkapnya, lihat Log audit.

Memantau instance

Pantau instance Anda untuk memastikan performanya sesuai harapan dan untuk membantu Anda memecahkan potensi masalah.

Memantau performa instance menggunakan insight

Dasbor insight sistem menyediakan diagram dan metrik untuk latensi, pemakaian CPU, penyimpanan, throughput, dan statistik performa lainnya. Anda dapat menggunakan dasbor ini untuk memantau instance dan database Spanner Omni. Untuk mengetahui informasi selengkapnya, lihat Memantau instance dengan insight sistem dalam dokumentasi Spanner.

Langkah berikutnya