Memantau penggunaan
Halaman ini berisi penjelasan mengenai cara memantau penggunaan Firestore dan menemukan potensi masalah di aplikasi Anda.
Dasbor penggunaan
Gunakan dasbor penggunaan di Google Cloud Console dan Firebase console untuk melihat pembacaan, penulisan, dan penghapusan dokumen dari waktu ke waktu.
Kontrol akses
Dasbor penggunaan memerlukan izin 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 Firestore, buka halaman Penggunaan 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 pada halaman untuk melihat penggunaan database Anda.
Dasbor penggunaan gabungan
Jika project memiliki beberapa database Firestore, Anda dapat melihat metrik penggunaan gabungan di Google Cloud console atau Firebase console. Dasbor penggunaan level project menggabungkan metrik penggunaan dari semua database Firestore dalam database mode Native. Dasbor ini tidak mencakup penggunaan dari Firestore dalam database mode Datastore.
Konsol Google Cloud
Di konsol Google Cloud, buka halaman Project usage.
Buka penggunaan project Google Cloud
Dasbor penggunaan project menampilkan operasi dokumen dari waktu ke waktu sebagai berikut:
Firebase console
Buka halaman penggunaan Firestore (Firebase console)
Dasbor penggunaan dan laporan penagihan
Dasbor penggunaan 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.
Metrik Cloud Monitoring
Cloud Monitoring mengumpulkan metrik, peristiwa, dan metadata dari produk Google Cloud. Dasbor penggunaan di konsol Firestore melaporkan data metrik yang sama. Untuk menyiapkan dasbor kustom dan notifikasi penggunaan, gunakan Cloud Monitoring.
Cloud Monitoring mencakup metrik 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 Firestore dan berlangganan 10 kueri. Ini meningkatkan metrik Anda dengan 1 koneksi aktif dan 10 pemroses snapshot.
- Frekuensi pengambilan sampel
Metrik Firestore diambil sampelnya setiap menit, tetapi pembaruan mungkin memerlukan waktu hingga 4 menit agar muncul di dasbor Anda.
Metrik latensi
Metrik latensi backend tersedia melalui metrik firestore Google Cloud umum.
Misalnya, grafik latensi p50 dapat ditemukan di tampilan Metrics Explorer Cloud Console.
Menyiapkan dasbor Cloud Monitoring
Untuk menyiapkan dasbor dengan metrik Firestore, lihat artikel Mengelola dasbor kustom dan Menambahkan widget dasbor.
Langkah selanjutnya
- Mempelajari Cloud Monitoring lebih lanjut.
- Pelajari praktik terbaik untuk memantau performa Firestore.