Memantau aktivitas Cloud Firestore

Halaman ini menjelaskan bagaimana Anda dapat memantau penggunaan Cloud Firestore dan mengenali potensi masalah di aplikasi Anda.

Dasbor penggunaan

Gunakan dasbor penggunaan di Google Cloud Platform Console dan Firebase console untuk melihat operasi baca, tulis, dan hapus dokumen dari waktu ke waktu.

Kontrol akses

Dasbor penggunaan memerlukan izin Cloud 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, buka halaman Penggunaan database di GCP Console.

  1. Di Google Cloud Platform Console, buka halaman Databases.

    Buka Databases

  2. Pilih database yang diperlukan dari daftar database.

  3. Di menu navigasi, klik Usage.

  4. Klik link dalam pesan yang muncul di halaman untuk melihat penggunaan database Anda.

    Dasbor penggunaan database Cloud Firestore di GCP Console.

Dasbor penggunaan gabungan

Jika project Anda memiliki beberapa database Cloud Firestore, Anda dapat melihat metrik penggunaan gabungan di GCP Console atau Firebase console.

GCP Console

Di Google Cloud Platform Console, buka halaman Project usage.

Buka penggunaan project project GCP

Dasbor penggunaan project menampilkan operasi dokumen dari waktu ke waktu sebagai berikut:

Dasbor penggunaan Cloud Firestore di GCP Console.

Firebase console

Buka halaman penggunaan Cloud Firestore (Firebase console)

Dasbor penggunaan Cloud Firestore di Firebase console.

Dasbor penggunaan dan laporan penagihan

Dasbor penggunaan Cloud Firestore di Firebase dan Cloud Console 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. Dalam semua kasus perbedaan, laporan penagihan lebih diutamakan daripada dasbor penggunaan.

Operasi yang menyebabkan perbedaan antara dasbor penggunaan dan penggunaan yang ditagih meliputi:

  • Operasi impor dan ekspor. Operasi baca dan tulis yang dilakukan oleh operasi impor dan ekspor tidak muncul di dasbor penggunaan.
  • Penulisan hanya verifikasi tanpa pengoperasian. Operasi tulis yang hanya memverifikasi keberadaan atau ketiadaan dokumen berkontribusi pada operasi baca yang ditagih, tetapi keduanya masing-masing ditampilkan sebagai `UPDATE_NOOP` dan `DELETE_NOOP` di dasbor penggunaan tulis.
  • Operasi tulis tanpa pengoperasian. Operasi yang tidak mengakibatkan perubahan pada database, misalnya update yang tidak mengubah nilai kolom atau operasi tulis pada dokumen yang dihapus dapat ditampilkan di dasbor penggunaan sebagai `UPDATE_NOOP` atau `DELETE_NOOP`. Meskipun ditampilkan sebagai `NOOP`, mereka tetap berkontribusi pada operasi yang ditagih.
  • Operasi tulis yang diciutkan. Untuk beberapa operasi tulis yang terjadi secara berurutan dalam waktu singkat pada dokumen yang sama, dasbor penggunaan mungkin menciutkan beberapa operasi tulis secara bersamaan dan menghitungnya sebagai satu operasi. Saat penagihan penggunaan, setiap operasi tulis tetap dihitung secara terpisah.

    Dasbor penggunaan juga menciutkan operasi tulis untuk transformasi kolom seperti operasi stempel waktu server, peningkatan numerik, dan penggabungan array. Untuk transformasi kolom, dasbor penggunaan dapat menghitung beberapa operasi sebagai satu operasi.

  • Kueri yang menampilkan hasil nol. Kueri dengan hasil nol akan dikenai biaya satu operasi baca. Penggunaan ini ditagih, tetapi tidak muncul di dasbor penggunaan.
  • Operasi baca yang terkait dengan kueri agregasi seperti COUNT. Penggunaan ini ditagih, tetapi tidak muncul di dasbor penggunaan.

Dasbor penggunaan untuk penghapusan tidak mempresentasikan operasi masa berlaku otomatis yang dilakukan oleh kebijakan Time to live (TTL). Baca metrik TTL dari Cloud Monitoring.

Penggunaan aturan keamanan

Selain itu, Firebase console menyediakan dasbor evaluasi Aturan Keamanan, yaitu tampilan pemanggilan aturan yang singkat dan bermanfaat. Anda dapat menambahkan dasbor ini dengan analisis mendetail di Cloud Monitoring.

Buka Rules

Dasbor pemantauan Rules
untuk Cloud Firestore di Firebase console.

Metrik Cloud Monitoring

Cloud Monitoring mengumpulkan metrik, peristiwa, dan metadata dari produk Google Cloud. Dasbor penggunaan pada konsol Cloud Firestore melaporkan data metrik yang sama. Untuk menyiapkan dasbor kustom dan notifikasi penggunaan, gunakan Cloud Monitoring.

Cloud Monitoring mencakup metrik Cloud Firestore berikut:

Nama Metrik Deskripsi
Pembacaan Dokumen

Jumlah dokumen yang berhasil dibaca. Anda dapat memerinci metrik ini berdasarkan jenis operasi baca: LOOKUP atau QUERY.

Metrik ini tidak termasuk membaca dari operasi ekspor yang dikelola.

Penulisan Dokumen

Jumlah dokumen yang berhasil ditulis. Anda dapat memerinci metrik berdasarkan jenis operasi tulis: CREATE atau UPDATE.

Metrik ini tidak termasuk menulis dari operasi impor yang dikelola.

Penghapusan Dokumen Jumlah dokumen yang berhasil dihapus.
Koneksi Aktif

Jumlah koneksi aktif ke database Anda.

Setiap SDK seluler dan web yang aktif mempertahankan satu koneksi, yang dapat dibagikan ke beberapa pemroses snapshot. Library klien server membuat satu koneksi per pemroses snapshot.

Pemroses Snapshot

Jumlah pemroses snapshot di semua koneksi aktif.

Jumlah penghapusan time-to-live

Jumlah total dokumen yang dihapus oleh kebijakan Time-to-live (TTL).

Akhir masa berlaku time-to-live hingga penundaan penghapusan

Waktu yang berlalu antara saat dokumen habis masa berlakunya berdasarkan kebijakan Time-to-live (TTL) hingga saat dokumen benar-benar dihapus.

Penggunaan update real time

Gunakan koneksi aktif dan metrik pemroses snapshot untuk mengukur penggunaan Anda atas update realtime.

Katakanlah pengguna membuka aplikasi Anda di ponsel mereka. Aplikasi kemudian terhubung ke Cloud Firestore dan berlangganan ke 10 kueri. Ini meningkatkan metrik Anda dengan 1 koneksi aktif dan 10 pemroses snapshot.

Frekuensi pengambilan sampel

Metrik Cloud Firestore diambil sampelnya setiap menit, tetapi pembaruan mungkin memakan waktu hingga 4 menit agar muncul di dasbor Anda.

Metrik latensi

Metrik latensi backend tersedia melalui metrik serviceruntime Google Cloud yang umum.

Misalnya, grafik latensi p50 dapat ditemukan di tampilan Metrics Explorer Cloud Console.

Menyiapkan dasbor Cloud Monitoring

Untuk menyiapkan dasbor dengan metrik Cloud Firestore, lihat Mengelola dasbor kustom dan Menambahkan widget dasbor.

Langkah selanjutnya