Ringkasan Key Visualizer

Halaman ini memberikan ringkasan alat diagnostik Key Visualizer untuk Firestore.

Apa yang dimaksud dengan Key Visualizer?

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

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

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

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

  • Periksa apakah operasi baca atau tulis Anda membuat hotspot pada rentang dokumen tertentu.
  • Lihat pengaruh peningkatan traffic mendadak terhadap latensi.
  • Lihat apakah pola akses Anda seimbang di seluruh database.
  • 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 untuk jangka waktu tertentu tersedia untuk database dengan traffic yang melebihi 3.000 operasi dokumen dalam menit tertentu dalam jangka waktu tersebut.

Kelayakan pemindaian sepenuhnya bergantung pada aktivitas database. Hal ini tidak bergantung pada jumlah data atau jenis data di database Anda.

Pemindaian Key Visualizer

Gambar berikut menunjukkan pemindaian Key Visualizer. Setiap pemindaian menyertakan peta panas yang menunjukkan 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 tersebut akan membuka pemindaian Key Visualizer yang sama dan memilih metrik yang sama. URL ini valid hingga durasi data pemindaian berakhir.

Peta panas

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

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

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

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

Berbagai jenis penggunaan menghasilkan pola visual yang berbeda dalam peta panas, yang dapat memungkinkan Anda mendiagnosis masalah dengan 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 dalam setiap pemindaian. Lihat Memulai Key Visualizer dan Menjelajahi peta panas.

Bucket kunci

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

Key Visualizer menggunakan total Ops/s database untuk membagi bucket kunci sehingga setiap bucket menangkap jumlah Ops/s yang kira-kira sama dengan ukuran minimum yang diinginkan sebesar 50 Ops/s per bucket kunci. Untuk database dengan total Ops/s yang lebih tinggi, setiap bucket kunci dapat menangkap lebih dari 50 Ops/s. Database dengan Ops/s kurang dari 50 akan menghasilkan pemindaian dengan satu bucket kunci.

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

Metrik

Metrik berikut tersedia untuk kunci dokumen dalam pemindaian Key Visualizer:

Metrik Deskripsi
Metrik aktivitas
Operasi/dtk Jumlah rata-rata operasi dokumen per detik. Kira-kira sama dengan jumlah operasi tulis, pencarian, dan kueri per detik. Metrik ini dapat menunjukkan kunci mana yang aktif.
Operasi tulis/dtk Jumlah rata-rata operasi dokumen per detik untuk operasi tulis dan hapus.
Operasi pencarian/dtk Jumlah rata-rata operasi dokumen per detik untuk pencarian.
Operasi kueri/dtk Jumlah rata-rata operasi dokumen per detik untuk kueri.
Metrik performa
Latensi tulis rata-rata Latensi rata-rata untuk operasi tulis dan hapus 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.
Latensi tail tulis Latensi maksimum yang diamati untuk operasi tulis atau hapus 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 dalam pemindaian Key Visualizer:

Metrik Deskripsi
Operasi Tulis Indeks/dtk Jumlah rata-rata penulisan indeks per detik.

Rata-rata performa

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

Batas

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

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

Durasi data

Data yang dikumpulkan oleh Key Visualizer untuk Firestore akan 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.

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

Langkah selanjutnya