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 notifikasi penggunaan.
Dokumen ini memandu Anda menggunakan metrik, mempelajari dasbor metrik kustom, dan menyetel pemberitahuan.
Resource yang Dimonitor
Resource yang dipantau di Cloud Monitoring menampilkan entitas logis atau fisik, seperti virtual machine, database, atau aplikasi. Resource yang dipantau berisi serangkaian metrik unik yang dapat dijelajahi, dilaporkan melalui dasbor, atau digunakan untuk membuat pemberitahuan. Setiap resource juga memiliki serangkaian label resource, yang merupakan key-value pair 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:
| Referensi | Deskripsi | Mode database yang didukung |
firestore.googleapis.com/Database (disarankan) | 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 dalam mode 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 dalam mode Native dan Firestore dalam mode Datastore. Untuk mengetahui 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 project. Metrik ini tersedia untuk sebagian besar API Google Cloud . Jenis resource yang dimonitor
consumed_api
berisi metrik umum ini. Metrik ini diambil sampelnya
setiap 30 menit sehingga data menjadi halus.
Label resource yang penting untuk metrik serviceruntime adalah method. Label ini
mewakili metode RPC dasar yang dipanggil. Metode SDK yang Anda panggil mungkin
tidak harus memiliki nama yang sama dengan metode RPC dasar. Hal ini karena 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 dasar 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 diselesaikan.
Firestore mencatat metrik dari komponen Firestore Service. Metrik latensi mencakup waktu saat Firestore menerima permintaan hingga waktu saat Firestore selesai mengirim respons, termasuk interaksi dengan lapisan penyimpanan. Oleh karena itu, latensi dua arah (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, peta panas untuk ukuran respons metode RunQuery dapat dilihat.
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 memberikan jumlah baca, tulis, dan hapus. Metrik tulis memberikan perincian antara operasi 'CREATE' dan 'UPDATE'. Metrik ini selaras dengan operasi CRUD.
Metrik berikut dapat digunakan untuk memahami apakah database Anda lebih banyak melakukan operasi baca atau tulis, dan rasio dokumen baru vs. dokumen yang dihapus.
document/delete_ops_count: Jumlah dokumen yang berhasil dihapus.document/read_ops_count: Jumlah dokumen yang berhasil dibaca 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 ukuran payload
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 datastore_request resource yang dipantau sehingga tidak ada perincian layanan atau metode.
entity/read_sizes: Distribusi ukuran dokumen yang dibaca.entity/write_sizes: Distribusi ukuran dokumen yang ditulis.
Metrik penagihan (Edisi Enterprise)
Metrik penagihan berikut hanya tersedia untuk edisi Firestore Enterprise.
Gunakan metrik ini untuk memahami penggunaan penagihan. Metrik ini tidak mencakup penagihan dari operasi administrator (pengindeksan, impor, ekspor, dan penghapusan massal).
api/billable_read_units: Jumlah unit baca yang dapat ditagih. Penggunaan dapat dikelompokkan berdasarkan nama layanan dan metode API.api/billable_realtime_read_units: Jumlah unit pembaruan real-time yang dapat ditagih dari pembaruan real-time.api/billable_write_units: Jumlah unit tulis yang dapat ditagih. Penggunaan dapat dikelompokkan berdasarkan nama layanan dan metode API.document/billable_managed_delete_write_units: Jumlah unit tulis yang dapat ditagih dari layanan penghapusan terkelola seperti TTL.
Metrik indeks
Kecepatan 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 listener snapshot real time di mana perubahan yang relevan dalam database langsung 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 dalam mode Native dan Firestore dalam mode Datastore. Gunakan metrik ini untuk memantau dampak penerapan kebijakan TTL.
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 hingga 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, dokumen yang habis masa berlakunya karena TTL akan dihapus dalam waktu kurang dari 0,5 detik. Hal ini menunjukkan bahwa sistem berfungsi normal. Firestore biasanya menghapus dokumen yang sudah tidak berlaku dalam waktu 24 jam, tetapi hal ini tidak dijamin. Jika Anda melihat prosesnya memerlukan waktu lebih dari 24 jam, hubungi dukungan.
Langkah selanjutnya
- Pelajari cara menggunakan dasbor Cloud Monitoring untuk melihat metrik.
- Pantau penggunaan untuk mengidentifikasi pembacaan, penulisan, dan penghapusan dokumen dari waktu ke waktu.