Memahami pemantauan performa di Firestore
Cloud Monitoring mengumpulkan metrik, peristiwa, dan metadata dari produk Google Cloud . Data yang dilaporkan di dasbor Penggunaan dan Penggunaan aturan keamanan juga dapat diakses melalui Cloud Monitoring untuk analisis yang lebih mendetail. Dengan Cloud Monitoring, Anda juga dapat menyiapkan dasbor kustom dan pemberitahuan penggunaan.
Dokumen ini memandu Anda menggunakan metrik, mempelajari dasbor metrik kustom, dan menyetel pemberitahuan.
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 Firestore dipantau dengan resource berikut:
Resource | Deskripsi | Mode database yang didukung |
firestore.googleapis.com/Database (direkomendasikan) | Jenis resource yang dimonitor yang memberikan perincian untuk project , location * , dan database_id . Label
database_id akan menjadi (default) untuk database yang dibuat
tanpa nama tertentu. |
Berlaku untuk kedua mode. |
firestore_instance | Jenis resource yang dipantau untuk project Firestore dan tidak memberikan perincian untuk database. | Berlaku untuk Firestore Native |
datastore_request | Jenis resource yang dipantau untuk project Datastore dan tidak memberikan perincian untuk database. | Berlaku untuk kedua mode. |
Metrik
Firestore tersedia dalam dua mode yang berbeda, Firestore Native dan Firestore dalam mode Datastore. Untuk perbandingan fitur antara kedua mode ini, lihat Memilih antara mode database.
Untuk mengetahui daftar lengkap metrik untuk kedua mode, lihat link berikut:
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 memiliki nama yang sama dengan metode RPC yang mendasarinya. Alasannya adalah SDK menyediakan abstraksi API tingkat tinggi. Namun, saat mencoba
memahami cara aplikasi Anda berinteraksi dengan Firestore, penting untuk memahami metrik berdasarkan nama metode RPC.
Jika Anda perlu mengetahui metode RPC pokok untuk metode SDK tertentu, lihat dokumentasi API.
Gunakan metrik runtime layanan berikut untuk memantau database Anda.
api/request_count
Metrik ini memberikan jumlah permintaan yang selesai, di seluruh protokol(protokol permintaan, seperti http, gRPC, dll.),
kode respons (kode respons HTTP), response_code_class
(class kode respons, seperti 2xx, 4xx,dll.), dan grpc_status_code
(kode respons gRPC numerik). Gunakan metrik ini untuk mengamati permintaan API secara keseluruhan dan menghitung tingkat error.

Pada gambar 1, permintaan yang menampilkan kode 2xx yang dikelompokkan menurut layanan dan metode dapat dilihat. Kode 2xx adalah kode status HTTP yang menunjukkan bahwa permintaan berhasil.

Pada gambar 2, commit yang dikelompokkan menurut response_code
dapat dilihat. Dalam contoh ini, kita hanya melihat respons HTTP 200 yang menunjukkan bahwa database dalam kondisi baik.
api/request_latencies
Metrik api/request_latencies
memberikan distribusi latensi di semua permintaan yang telah selesai.
Firestore mencatat metrik dari komponen Layanan Firestore. Metrik latensi mencakup waktu saat Firestore menerima permintaan hingga waktu saat Firestore selesai mengirimkan respons, termasuk interaksi dengan lapisan penyimpanan. Oleh karena itu, latensi pulang pergi (rtt) antara klien dan layanan Firestore tidak disertakan dalam metrik ini.

api/request_sizes dan api/response_sizes
Metrik api/request_sizes
dan api/response_sizes
masing-masing memberikan
insight tentang ukuran payload (dalam byte). Hal ini dapat berguna untuk memahami
workload tulis yang mengirimkan data dalam jumlah besar atau kueri yang terlalu luas,
dan menampilkan payload besar.

Pada gambar 5, Anda dapat melihat peta panas untuk ukuran respons metode RunQuery
.
Kita dapat melihat bahwa ukuran stabil, median 50 byte, dan secara keseluruhan antara 10 byte dan 100 byte. Perhatikan bahwa ukuran payload selalu diukur dalam byte yang tidak dikompresi, tidak termasuk overhead kontrol transmisi.
Metrik operasi dokumen
Firestore menyediakan jumlah pembacaan, penulisan, dan penghapusan. 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 banyak dibaca atau banyak ditulis, dan rasio dokumen baru vs. 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.

Pada gambar 6, Anda dapat melihat cara membuat rasio yang menunjukkan rasio dokumen yang dibaca vs. dokumen yang ditulis. Dalam contoh ini, jumlah dokumen yang dibaca sekitar 6% lebih banyak daripada jumlah dokumen yang ditulis.
Metrik operasi dokumen
Metrik ini memberikan distribusi ukuran payload dalam byte untuk operasi baca (pencarian
dan kueri) serta penulisan ke database Firestore. Nilai tersebut menunjukkan total ukuran payload. Misalnya, hasil apa pun yang ditampilkan oleh kueri.
Metrik ini mirip dengan metrik api/request_sizes
dan api/response_sizes
, dengan perbedaan utama adalah metrik operasi dokumen memberikan pengambilan sampel yang lebih terperinci, tetapi perincian yang kurang terperinci.
Misalnya, metrik operasi dokumen menggunakan resource yang dipantau datastore_request
sehingga tidak ada perincian layanan atau metode.
entity/read_sizes
: Distribusi ukuran dokumen yang dibaca.entity/write_sizes
: Distribusi ukuran dokumen tertulis.
Metrik indeks
Tingkat penulisan indeks dapat dibandingkan dengan metrik document/write_ops_count
untuk memahami rasio fanout indeks.
index/write_count
: Jumlah penulisan indeks.

Pada gambar 7, Anda dapat melihat bagaimana kecepatan penulisan indeks dapat dibandingkan dengan kecepatan penulisan dokumen. Dalam contoh ini, untuk setiap penulisan dokumen, ada sekitar 6 penulisan indeks, yang merupakan tingkat fanout indeks yang relatif kecil.
Klien yang terhubung langsung ke database menggunakan Firebase SDK
Dua metrik pengukur tersedia untuk melacak aktivitas dari klien yang terhubung langsung ke database Firestore melalui SDK Seluler, SDK Web, atau keduanya. Metrik ini mencakup fungsi yang terkait dengan pemroses snapshot real time di mana perubahan yang relevan dalam database segera di-streaming kembali ke klien.
network/active_connections
: Jumlah koneksi aktif pada titik waktu tersebut. Setiap klien web atau seluler memiliki satu koneksi.network/snapshot_listeners
: Jumlah pemroses snapshot yang saat ini terdaftar di semua klien yang terhubung. Mungkin ada beberapa koneksi per klien.
Anda dapat melihat metrik ini di tab Usage
dalam database Firestore di Firebase console.

Metrik TTL
Metrik TTL tersedia untuk database Firestore Native dan Firestore dalam mode Datastore. Gunakan metrik ini untuk memantau efek kebijakan TTL yang diterapkan.
document/ttl_deletion_count
: Jumlah total dokumen yang dihapus oleh layanan TTL.

Pada Gambar 9, Anda dapat melihat tingkat penghapusan dokumen setiap menit selama beberapa hari.
document/ttl_expiration_to_deletion_delays
: Waktu yang berlalu antara saat dokumen dengan TTL habis masa berlakunya, dan saat dokumen benar-benar dihapus.

Pada gambar 10, Anda dapat melihat bahwa metrik ini memberikan distribusi waktu dalam detik yang diperlukan Firestore untuk menghapus dokumen dengan kebijakan TTL. Di persentil ke-99, penghapusan dokumen yang masa berlakunya habis karena TTL memerlukan waktu kurang dari 0,5 detik. Hal ini menunjukkan bahwa sistem berfungsi normal. Firestore biasanya menghapus dokumen yang masa berlakunya telah habis dalam waktu 24 jam, tetapi hal ini tidak dijamin. Jika Anda melihat prosesnya memerlukan waktu lebih dari 24 jam, hubungi dukungan.
Langkah berikutnya
- Pelajari cara menggunakan dasbor Cloud Monitoring untuk melihat metrik.
- Pantau penggunaan untuk mengidentifikasi operasi baca, tulis, dan hapus dokumen dari waktu ke waktu.