Memantau metrik database

Hanya relevan dengan edisi Cloud Firestore Enterprise.

Halaman ini menjelaskan cara menggunakan metrik Cloud Monitoring untuk Cloud Firestore dengan kompatibilitas MongoDB guna memantau database Anda.

Metrik Cloud Monitoring untuk Cloud Firestore dengan kompatibilitas MongoDB

Bagian berikut memberikan ringkasan metrik yang tersedia untuk Cloud Firestore dengan kompatibilitas MongoDB.

Resource yang Dimonitor

Resource yang dipantau di Cloud Monitoring merepresentasikan entitas logis atau fisik, seperti virtual machine, database, atau aplikasi. Resource yang dipantau berisi serangkaian metrik unik yang dapat dieksplorasi, dilaporkan melalui dasbor, atau digunakan untuk membuat pemberitahuan. Setiap resource juga memiliki serangkaian label resource, yang merupakan pasangan nilai kunci yang menyimpan informasi tambahan tentang resource. Label resource tersedia untuk semua metrik yang terkait dengan resource.

Dengan menggunakan Cloud Monitoring API, performa Cloud Firestore dengan kompatibilitas MongoDB dipantau dengan resource berikut:

Resource Deskripsi
firestore.googleapis.com/Database Jenis resource yang dipantau yang memberikan perincian untuk project, location, dan database_id.

Metrik

Untuk daftar lengkap metrik Cloud Firestore, lihat Metrik Cloud Firestore. Bagian berikut menjelaskan beberapa metrik yang tersedia.

Metrik runtime layanan

Metrik serviceruntime memberikan ringkasan umum tentang traffic proyek. Metrik ini tersedia untuk sebagian besar API Google Cloud. Jenis resource yang dipantau consumed_api berisi metrik umum ini. Metrik ini diambil sampelnya setiap 30 menit sehingga data menjadi lebih lancar.

Label resource penting untuk metrik serviceruntime adalah method. Label ini mewakili metode RPC pokok yang dipanggil. Metode SDK yang Anda panggil mungkin tidak harus memiliki nama yang sama dengan metode RPC pokok. Alasannya adalah SDK menyediakan abstraksi API tingkat tinggi. Namun, saat mencoba memahami cara aplikasi Anda berinteraksi dengan Cloud Firestore, penting untuk memahami metrik berdasarkan nama metode RPC.

Jika Anda perlu mengetahui metode RPC pokok untuk metode SDK tertentu, lihat dokumentasi API.

api/request_latencies

Metrik api/request_latencies memberikan distribusi latensi di semua permintaan yang telah selesai.

Cloud Firestore mencatat metrik dari komponen Layanan Cloud Firestore. Metrik latensi mencakup waktu saat Cloud Firestore menerima permintaan hingga waktu saat Cloud Firestore selesai mengirim respons, termasuk interaksi dengan lapisan penyimpanan. Oleh karena itu, latensi pulang pergi (rtt) antara klien dan layanan Cloud Firestore tidak disertakan dalam metrik ini.

Metrik operasi dokumen

Cloud Firestore memberikan jumlah baca, tulis, dan hapus. Metrik operasi tulis memberikan perincian antara operasi 'CREATE' dan 'UPDATE'. Metrik ini selaras dengan operasi CRUD.

Metrik berikut dapat digunakan untuk memahami apakah database Anda lebih banyak melakukan operasi baca atau tulis, dan rasio dokumen baru versus dokumen yang dihapus.

  • document/delete_ops_count: Jumlah dokumen yang berhasil dihapus.
  • document/read_ops_count: Jumlah pembacaan dokumen yang berhasil dari kueri atau pencarian.
  • document/write_ops_count: Jumlah dokumen yang berhasil ditulis.

Metrik penagihan

Gunakan metrik ini untuk memahami penggunaan penagihan. Metrik ini tidak mencakup penagihan dari operasi administrator (pengindeksan, impor, ekspor, dan penghapusan massal).

  • api/billable_read_units: Jumlah unit baca yang dapat ditagih. Penggunaan dapat dikelompokkan berdasarkan nama layanan dan metode API.

  • api/billable_write_units: Jumlah unit tulis yang dapat ditagih. Penggunaan dapat dikelompokkan berdasarkan nama layanan dan metode API.

  • document/billable_managed_delete_write_units: Jumlah unit tulis yang dapat ditagih dari layanan penghapusan terkelola seperti TTL.

Metrik indeks

Kecepatan penulisan indeks dapat dibandingkan dengan metrik document/write_ops_count untuk memahami fanout indeks.

  • index/write_count: Jumlah penulisan indeks.

Metrik TTL

Metrik TTL untuk metrik kompatibilitas Cloud Firestore dengan MongoDB digunakan untuk memantau efek penerapan kebijakan TTL.

  • document/ttl_deletion_count: Jumlah total dokumen yang dihapus oleh layanan TTL.
  • document/ttl_expiration_to_deletion_delays: Waktu yang berlalu antara saat dokumen dengan TTL habis masa berlakunya, dan saat dokumen benar-benar dihapus.

Melihat dasbor standar dan membuat dasbor kustom

Cloud Firestore dengan kompatibilitas MongoDB mendukung dasbor standar yang menggunakan metrik Cloud Monitoring. Anda juga dapat membuat dasbor kustom.

Melihat metrik penggunaan database

Buka dasbor penggunaan di konsol Google Cloud untuk melihat operasi baca, tulis, dan hapus dokumen dari waktu ke waktu.

Kontrol akses

Dasbor penggunaan memerlukan izin Identity and Access Management (IAM) monitoring.timeSeries.list. Peran Owner, Editor, dan Viewer Project memberikan izin ini. Anda juga dapat memberikan izin ini melalui peran Cloud Monitoring atau peran khusus.

Dasbor penggunaan database

Untuk melihat metrik penggunaan untuk database Cloud Firestore dengan kompatibilitas MongoDB, lakukan hal berikut.

  1. Di konsol Google Cloud, buka halaman Databases.

    Buka Databases

  2. Pilih database yang diperlukan dari daftar database.

  3. Di menu navigasi, klik Usage.

Dasbor penggunaan dan laporan penagihan

Dasbor penggunaan Cloud Firestore di konsol memberikan perkiraan penggunaan. Langkah ini dapat membantu Anda mengidentifikasi lonjakan penggunaan. Namun, dasbor ini bukan tampilan persis dari operasi yang ditagih. Tagihan penggunaan kemungkinan lebih tinggi. Untuk memantau penagihan, lihat metrik penagihan.

Dalam semua kasus perbedaan, laporan penagihan lebih diutamakan daripada dasbor penggunaan.

Operasi impor dan ekspor menyebabkan perbedaan antara dasbor penggunaan dan penggunaan yang ditagih. Operasi baca dan tulis yang dilakukan oleh operasi ini tidak muncul di dasbor penggunaan.

Melihat metrik performa database

Halaman Monitoring di bagian Cloud Firestore konsol Google Cloud mencakup dasbor pemantauan standar seperti Latensi Permintaan (P50 dan P99), Kode Respons, dan Statistik kueri (P50). Anda juga dapat membuat hingga satu dasbor kustom. Untuk mengakses halaman Monitoring database, ikuti langkah-langkah berikut:

  1. Di Konsol Google Cloud, buka halaman Cloud Firestore Databases.

    Buka Databases

  2. Pilih database dari daftar.

  3. Di menu navigasi, klik Monitoring untuk membuka dasbor.

Membuat dasbor Cloud Monitoring kustom

Di Cloud Monitoring, dasbor kustom memungkinkan Anda menampilkan informasi yang relevan bagi Anda secara teratur. Misalnya, Anda dapat membuat dasbor untuk menampilkan metrik performa dan kebijakan pemberitahuan untuk project di lingkungan produksi.

Untuk mengetahui informasi selengkapnya tentang cara menyiapkan dasbor kustom, lihat artikel Mengelola dasbor kustom dan Menambahkan widget dasbor.

Membuat kebijakan pemberitahuan

Di Cloud Monitoring, Anda dapat membuat pemberitahuan untuk memberi tahu Anda saat terjadi perubahan pada kondisi metrik. Anda dapat menggunakan notifikasi ini untuk mendapatkan pemberitahuan tentang potensi masalah sebelum masalah tersebut memengaruhi pengguna Anda.

Untuk mengetahui informasi selengkapnya tentang cara membuat pemberitahuan, lihat Membuat kebijakan pemberitahuan batas metrik.

Pertimbangkan contoh berikut saat kita membuat kebijakan pemberitahuan latensi. Kebijakan pemberitahuan memeriksa latensi p99 selama periode 5 menit. Jika latensi p99 tetap lebih tinggi dari 250 md selama 5 menit, pemberitahuan akan dipicu.

Konsol

  1. Di konsol Google Cloud, buka halaman Monitoring, lalu pilih   Pemberitahuan.

    Buka Monitoring

  2. Pilih Buat kebijakan.

  3. Pilih metrik Request Latencies dari resource Consumed API.

  4. Tambahkan filter layanan untuk firestore.googleapis.com untuk database standar Cloud Firestore.

  5. Klik Berikutnya untuk mengonfigurasi pemicu.

  6. Pilih Jenis Kondisi sebagai Nilai Minimum.

    Kondisi nilai minimum ditetapkan ke nilai minimum 250 md. Pemberitahuan dipicu saat nilai latensi p99 tetap sama selama seluruh periode jendela geser (5 menit).

  7. Tetapkan Threshold value sebagai 250.

  8. Klik Berikutnya untuk mengonfigurasi notifikasi.

  9. Tetapkan nama kebijakan pemberitahuan, lalu klik Berikutnya.

  10. Tinjau konfigurasi pemberitahuan, lalu klik Create Policy.

MQL

Anda dapat menerapkan kebijakan pemberitahuan latensi yang sama menggunakan kueri Monitoring Query Language (MQL). Untuk contoh penggunaan MQL lainnya, lihat Contoh kueri MQL.

fetch consumed_api
| metric 'serviceruntime.googleapis.com/api/request_latencies'
| filter (resource.service == 'firestore.googleapis.com')
| group_by 5m,
    [value_request_latencies_percentile:
      percentile(value.request_latencies, 99)]
| every 5m
| condition val() > 0.25 's'