Ringkasan Key Visualizer

Halaman ini menyediakan ringkasan alat diagnostik Key Visualizer untuk Firestore.

Apa itu Key Visualizer?

Key Visualizer adalah alat yang membantu Anda menganalisis pola penggunaan Firestore. Alat ini menghasilkan laporan visual yang menguraikan penggunaan berdasarkan dokumen yang Anda akses atau indeks entri yang ditulis atau dihapus saat dokumen diubah.

Key Visualizer dapat memberikan insight tentang pola penggunaan dalam skala besar. Penggunaan Key Visualizer meliputi:

  • Memecahkan masalah performa. Key Visualizer membantu Anda mengidentifikasi masalah performa dalam database yang disebabkan oleh hotspot dari kunci indeks atau dokumen berurutan atau peningkatan traffic tiba-tiba.
  • Mendapatkan pemahaman yang lebih baik tentang cara mengakses data yang disimpan di Firestore.
  • Merancang model data secara iteratif atau meningkatkan desain model data yang ada. Di setiap iterasi, Anda dapat memeriksa Key Visualizer untuk menemukan masalah yang disebabkan oleh model data.

Untuk mencapai tujuan ini, Key Visualizer dapat membantu Anda menyelesaikan tugas-tugas berikut:

  • Periksa apakah pembacaan atau penulisan Anda menciptakan hotspot pada rentang dokumen tertentu.
  • Lihat bagaimana peningkatan traffic yang mendadak memengaruhi latensi.
  • Perhatikan apakah pola akses Anda seimbang di seluruh database Anda.
  • Periksa struktur kunci indeks untuk mengidentifikasi definisi indeks yang menyebabkan masalah pemuatan indeks.
  • Gunakan visualisasi kunci indeks untuk membuat prediksi pola beban kerja yang lebih baik.

Kelayakan pemindaian

Setiap pemindaian Key Visualizer mencakup periode dua jam. Pemindaian selama periode tertentu tersedia untuk database dengan traffic yang melebihi 3.000 operasi dokumen dalam satu menit tertentu pada periode tersebut.

Kelayakan pemindaian sepenuhnya bergantung pada aktivitas database. Ini tidak bergantung pada jumlah data atau jenis data dalam database Anda.

Pemindaian Key Visualizer

Gambar berikut menampilkan pemindaian Key Visualizer. Setiap pemindaian mencakup peta panas yang menampilkan pola akses atau metrik performa untuk sekelompok kunci dokumen atau kunci indeks dari waktu ke waktu.

Contoh pemindaian Key Visualizer

Membagikan URL pemindaian

Anda dapat membagikan atau mem-bookmark URL pemindaian Key Visualizer. URL akan membuka pemindaian Key Visualizer yang sama dan memilih metrik yang sama. URL ini valid hingga durasi data pemindaian berakhir.

Peta Panas

Inti dari pemindaian Key Visualizer adalah peta panas, yang menampilkan nilai metrik dari waktu ke waktu, yang dipecah menjadi hingga 1.000 bucket kunci yang berdekatan.

Untuk peta panas kunci dokumen, sumbu x peta panas menyatakan waktu, dan sumbu y mewakili kunci dokumen, sedangkan untuk peta panas kunci indeks, sumbu x peta panas menyatakan waktu, dan sumbu y mewakili kunci indeks.

Setiap pemindaian Key Visualizer untuk Firestore mencakup dua jam aktivitas yang dibagi menjadi segmen 10 detik.

Nilai rendah untuk metrik dianggap "dingin" dan muncul sebagai warna gelap. Nilai tinggi adalah "panas", dan tampak sebagai warna cerah. Nilai tertinggi muncul dalam warna putih.

Jenis penggunaan yang berbeda menghasilkan pola visual yang berbeda dalam peta panas, sehingga dapat mendiagnosis masalah secara sekilas. Lihat Pola peta panas untuk kunci dokumen atau Pola peta panas untuk kunci indeks untuk mengetahui contoh beberapa pola umum.

Key Visualizer menyediakan alat untuk membantu Anda memahami data di setiap pemindaian. Lihat Mulai menggunakan Key Visualizer dan Menjelajahi peta panas.

Bucket kunci

Key Visualizer membagi semua kunci di database Anda menjadi hingga 1.000 rentang yang berdekatan, dengan jumlah kunci yang kurang lebih sama di setiap rentang. Rentang ini dikenal sebagai bucket kunci.

Key Visualizer melaporkan sebagian besar metrik sebagai rata-rata dari setiap key bucket, atau sebagai nilai maksimum dalam setiap key bucket.

Metrik

Metrik berikut tersedia untuk kunci dokumen dalam pemindaian Key Visualizer:

Metrik Deskripsi
Metrik aktivitas
Operasi Jumlah rata-rata operasi dokumen per detik. Setara dengan jumlah penulisan, pencarian, dan kueri per detik. Metrik ini dapat menunjukkan kunci mana yang hot.
Operasi tulis Jumlah rata-rata operasi dokumen per detik untuk operasi tulis dan penghapusan.
Operasi pencarian Jumlah rata-rata operasi dokumen per detik untuk pencarian.
Operasi kueri/dtk Jumlah rata-rata operasi dokumen per detik untuk kueri.
Metrik performa
Rata-rata latensi tulis Latensi rata-rata untuk penulisan dan penghapusan dalam data yang diproses di bucket.
Latensi pencarian rata-rata Latensi rata-rata untuk pencarian dalam data yang diproses di bucket.
Latensi kueri rata-rata Latensi rata-rata untuk kueri dalam data yang diproses di bucket.
Menulis latensi tail Latensi penulisan atau penghapusan maksimum yang diamati dalam data yang diproses di bucket.
Latensi tail pencarian Latensi pencarian maksimum yang diamati dalam data yang diproses di bucket.
Latensi tail kueri Latensi kueri maksimum yang diamati dalam data yang diproses di bucket.

Metrik berikut tersedia untuk kunci indeks di pemindaian Key Visualizer:

Metrik Deskripsi
Operasi Penulisan Indeks Jumlah rata-rata penulisan indeks per detik.

Rata-rata performa

Metrik latensi rata-rata mengambil nilai rata-rata atas kunci di key bucket. Karena pengukuran ini diambil pada lapisan penyimpanan, latensi yang dilaporkan di sini mungkin lebih rendah dari total latensi yang dialami panggilan API.

Batas

Meskipun Key Visualizer menunjukkan berbagai metrik, Key Visualizer tidak menampilkan setiap metrik yang dapat memengaruhi performa Firestore. Misalnya:

  • Masalah jaringan antara aplikasi Anda dan Google Cloud mungkin tidak terlihat. Tanda ini mungkin muncul sebagai pita vertikal di semua tombol di Key Visualizer yang hanya memberikan petunjuk tentang kapan masalah terjadi.

Durasi data

Data yang dikumpulkan oleh Key Visualizer untuk Firestore dihapus setelah 14 hari.

Data Key Visualizer tersedia selama 14 hari terakhir. Misalnya, jika Anda meluncurkan Key Visualizer pada 19 Desember pukul 12.45, waktu mulai paling awal yang dapat Anda pilih untuk rentang waktu 2 jam adalah 5 Desember pukul 13.00.

Batasan ini juga berarti bahwa jika Anda mem-bookmark atau membagikan URL untuk pemindaian Key Visualizer, URL memiliki masa berlaku maksimum 14 hari.

Langkah selanjutnya