Halaman ini menjelaskan cara memantau penggunaan Cloud Firestore dan menemukan potensi masalah di aplikasi Anda.
Dasbor penggunaan
Gunakan dasbor penggunaan di konsol Google Cloud 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
Guna melihat metrik penggunaan untuk database Cloud Firestore, buka halaman Usage database di konsol Google Cloud.
Di konsol Google Cloud, buka halaman Databases.
Pilih database yang diperlukan dari daftar database.
Di menu navigasi, klik Usage.
Klik link dalam pesan yang muncul di halaman untuk melihat penggunaan database Anda.
Dasbor penggunaan database Cloud Firestore di konsol Google Cloud."/>
Dasbor penggunaan gabungan
Jika project Anda memiliki beberapa database Cloud Firestore, Anda dapat melihat metrik penggunaan gabungan di konsol Google Cloud atau Firebase console.
Konsol Google Cloud
Di konsol Google Cloud, buka halaman Project usage.
Buka penggunaan project di project Google Cloud
Dasbor penggunaan project menampilkan operasi dokumen dari waktu ke waktu sebagai berikut:
Dasbor penggunaan project Cloud Firestore di konsol Google Cloud."/>
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 console dan konsol Cloud memberikan perkiraan penggunaan. Fitur 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 dari entri indeks yang dibaca. Penggunaan ini ditagih, tetapi tidak muncul di dasbor penggunaan. Misalnya, kueri agregasi menagih untuk entri indeks yang dibaca, tetapi penggunaan ini tidak muncul di dasbor penggunaan.
Dasbor penggunaan untuk penghapusan tidak mempresentasikan operasi masa berlaku otomatis yang dilakukan oleh kebijakan Time to live (TTL). Lihat 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 melengkapi dasbor ini dengan analisis mendetail di Cloud Monitoring.
Dasbor pemantauan Rules
untuk Cloud Firestore di Firebase console."/>
Cloud Monitoring metrik
Cloud Monitoring mengumpulkan metrik, peristiwa, dan metadata dari produk Google Cloud. Dasbor penggunaan di Cloud Firestore console 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 atau penghapusan massal. |
| 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 firestore Google Cloud yang umum.
Misalnya, grafik latensi p50 dapat ditemukan di tampilan Metrics Explorer Konsol Cloud.
Menyiapkan dasbor Cloud Monitoring
Untuk melihat dasbor bawaan atau menyiapkan dasbor, lihat Menggunakan dasbor pemantauan.