Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Memantau aktivitas Cloud Firestore

Halaman ini berisi penjelasan tentang cara memantau penggunaan Cloud Firestore dan menemukan potensi masalah di aplikasi Anda. Dengan melihat penggunaan aplikasi, Anda juga dapat memperkirakan jumlah tagihan Anda. Selain itu, jika terjadi masalah, gambaran yang jelas tentang operasi database Anda dapat membantu Anda memecahkan masalah tersebut.

Dasbor penggunaan

Google Cloud Platform Console dan Firebase console menyertakan dasbor penggunaan Cloud Firestore yang menampilkan operasi baca, tulis, dan hapus dokumen dari waktu ke waktu.

GCP Console

Buka halaman penggunaan Cloud Firestore (GCP Console)

Dasbor penggunaan Cloud Firestore di GCP Console.

Kontrol akses

Dasbor penggunaan memerlukan izin Cloud IAM monitoring.timeSeries.list. Peran Pemilik, Editor, dan Viewer Project memberikan izin ini. Anda juga dapat memberikan izin ini melalui peran Cloud Monitoring atau peran khusus.

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.
  • Operasi tulis tanpa pengoperasian. Operasi yang tidak menghasilkan perubahan pada database, seperti update yang tidak mengubah nilai kolom atau operasi tulis pada dokumen yang dihapus, akan berkontribusi pada operasi yang ditagih. Namun, dasbor penggunaan tidak menghitung operasi-operasi tersebut.
  • Operasi tulis yang diciutkan. Dalam kasus dengan beberapa operasi tulis pada dokumen yang sama yang terjadi secara berurutan dalam waktu singkat, dasbor penggunaan mungkin menciutkan beberapa operasi tulis secara bersamaan dan menghitungnya sebagai satu operasi. Saat menagih 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.

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 halaman Aturan

Dasbor pemantauan Aturan
Cloud Firestore di Firebase console.

Kuota harian

Saat membuat project Firebase, Anda juga membuat project di Google Cloud. Halaman Kuota App Engine di GCP Console melacak informasi penggunaan Cloud Firestore harian termasuk pembacaan, penulisan, penulisan indeks, penghapusan, data yang disimpan, dan egress jaringan.

Buka halaman Kuota

Penggunaan Cloud Firestore di halaman Kuota App Engine.

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 merinci 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 merinci 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.

Evaluasi aturan

Jumlah evaluasi Aturan Cloud Firestore yang dijalankan sebagai respons terhadap permintaan tulis atau baca. Anda dapat merinci metrik ini berdasarkan hasil permintaan (ALLOW, DENY, atau ERROR).

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.

Dengan metrik tersebut, Anda dapat menyiapkan dasbor Cloud Firestore seperti berikut:

Penggunaan Cloud Firestore di dasbor Cloud Monitoring.

Selesaikan langkah-langkah di bawah untuk mulai memantau Cloud Firestore dengan Cloud Monitoring.

Membuat ruang kerja Cloud Monitoring

Untuk memantau Cloud Firestore dengan Cloud Monitoring, Anda harus menyiapkan ruang kerja untuk project Anda. Ruang kerja mengatur informasi pemantauan dari satu atau beberapa project. Setelah menyiapkan ruang kerja, Anda dapat membuat dasbor kustom dan kebijakan pemberitahuan.

  1. Buka Halaman Cloud Monitoring

    Jika project Anda sudah menjadi bagian dari ruang kerja, Halaman Cloud Monitoring akan terbuka. Jika tidak, pilih ruang kerja untuk project Anda.

  2. Pilih opsi Ruang Kerja Baru atau pilih ruang kerja yang ada.

  3. Klik Tambahkan. Setelah ruang kerja Anda dibuat, Halaman Cloud Monitoring akan terbuka.

Membuat dasbor dan menambahkan diagram

Tampilkan metrik Cloud Firestore yang dikumpulkan dari Cloud Monitoring di diagram dan dasbor Anda sendiri.

Sebelum melanjutkan, pastikan project Anda sudah menjadi bagian dari ruang kerja Cloud Monitoring.

  1. Di Halaman Cloud Monitoring, buka ruang kerja, lalu buka halaman Dasbor.

    Buka halaman Dasbor

  2. Klik Buat Dasbor dan masukkan nama dasbor.

  3. Di pojok kanan atas, klik Tambahkan Diagram.

  4. Di jendela Tambahkan Diagram, masukkan judul diagram. Klik tab Metrik.

  5. Pada kolom Temukan jenis resource dan metrik, masukkan Cloud Firestore. Dari drop-down yang terisi secara otomatis, pilih salah satu metrik Cloud Firestore.

  6. Untuk menambahkan metrik lainnya ke diagram yang sama, klik Tambahkan Metrik dan ulangi langkah sebelumnya.

  7. Jika ingin, sesuaikan diagram sesuai kebutuhan. Misalnya, di kolom Filter, klik + Tambahkan filter. Scroll ke bawah, lalu pilih nilai atau rentang untuk metrik yang Anda inginkan untuk memfilter diagram.

  8. Klik Simpan.

Untuk mengetahui informasi selengkapnya tentang diagram Cloud Monitoring, lihat Bekerja dengan diagram.

Membuat kebijakan pemberitahuan

Anda dapat membuat kebijakan pemberitahuan berdasarkan metrik Cloud Firestore. Ikuti langkah-langkah di bawah ini untuk membuat kebijakan pemberitahuan, sehingga Anda dapat menerima email setiap kali metrik Cloud Firestore tertentu mencapai nilai minimum tertentu.

Sebelum melanjutkan, pastikan project Anda sudah menjadi bagian dari ruang kerja Cloud Monitoring.

  1. Di Halaman Cloud Monitoring, buka ruang kerja Anda, lalu buka halaman Pemberitahuan.

    Buka halaman Buat Kebijakan Pemberitahuan Baru

  2. Klik Buat Kebijakan.

  3. Masukkan nama untuk kebijakan pemberitahuan Anda.

  4. Tambahkan kondisi pemberitahuan berdasarkan salah satu metrik Cloud Firestore. Klik Tambahkan Kondisi.

  5. Pilih Target. Pada kolom Temukan jenis resource dan metrik, masukkan Cloud Firestore. Dari drop-down yang terisi secara otomatis, pilih salah satu metrik Cloud Firestore.

  6. Di bagian Pemicu kebijakan, gunakan kolom drop-down untuk menentukan kondisi pemberitahuan.

  7. Tambahkan saluran notifikasi ke kebijakan pemberitahuan Anda. Di bagian Notifikasi, Klik Tambahkan Saluran Notifikasi. Pilih Email dari menu dropdown.

  8. Masukkan email Anda di kolom Alamat email. Klik Tambahkan.

  9. Secara opsional, isi kolom dokumentasi untuk menyertakan informasi tambahan dalam notifikasi email Anda.

  10. Klik Simpan.

Jika penggunaan Cloud Firestore Anda melebihi batas yang dikonfigurasi, Anda akan menerima peringatan email: Contoh email pemberitahuan Cloud Firestore.

Untuk info selengkapnya tentang kebijakan pemberitahuan, lihat Pengantar tentang pemberitahuan.

Langkah selanjutnya