Menjelajahi peta panas

Halaman ini menjelaskan cara menganalisis peta panas dalam pemindaian Key Visualizer sehingga Anda dapat mengidentifikasi sumber masalah performa Firestore.

Sebelum membaca halaman ini, Anda harus sudah memahami ringkasan Key Visualizer. Anda juga dapat:

Menyesuaikan kecerahan

Peta panas Key Visualizer menggunakan warna gelap untuk menunjukkan nilai normal atau rendah, dan warna cerah untuk menunjukkan nilai tinggi. Anda dapat menyesuaikan skala warna untuk membantu Anda melihat pola di peta panas.

Perhatikan bahwa untuk sebagian besar metrik, Key Visualizer mengidentifikasi nilai yang "tinggi" dan "rendah" sepenuhnya berdasarkan penggunaan database Anda. Misalnya, jika Anda melakukan 20 operasi baca per detik dalam rentang kunci tertentu dan 1 operasi baca per detik dalam rentang kunci lainnya, Key Visualizer akan menggunakan warna cerah untuk rentang kunci tertentu tersebut. Perhatikan bahwa warna cerah tidak selalu menunjukkan masalah.

Untuk menyesuaikan warna yang digunakan untuk nilai yang berbeda, gunakan tombol + / - di kedua sisi ikon Adjust Brightness . Saat meningkatkan kecerahan, Anda akan menurunkan rentang nilai yang mewakili setiap warna; saat menurunkan kecerahan, Anda akan meningkatkan rentang nilai.

Untuk mereset kecerahan ke setelan default, klik ikon Sesuaikan Kecerahan .

Memperbesar periode waktu dan rentang kunci

Saat Anda membuka peta panas, peta tersebut akan menampilkan nilai untuk jangka waktu yang disertakan dalam pemindaian dan rentang kunci aktif di database Anda. Jika melihat masalah selama jangka waktu tertentu, atau dalam rentang kunci tertentu, Anda dapat memperbesar untuk memeriksa masalah lebih cermat.

Ada beberapa cara untuk memperbesar atau memperkecil:

  • Scroll ke atas atau ke bawah dalam peta panas.
  • Klik tombol Zoom Persegi Panjang , lalu klik dan tarik untuk memilih area yang akan diperbesar.
  • Tekan dan tahan tombol Shift, lalu klik dan tarik untuk memilih area yang akan diperbesar.
  • Kembali ke area peta panas sebelumnya dengan menekan tombol Backspace atau Delete.
  • Perkecil untuk melihat seluruh tabel dengan mengklik tombol Reset Zoom atau menekan tombol R.

Melihat perincian menurut awalan kunci

Bagian berikut menjelaskan cara melakukan pengelompokan menggunakan pemindaian kunci dokumen sebagai contoh. Untuk kunci indeks, awalan akan berubah menjadi grup kunci indeks.

Di sisi kiri peta panas, Key Visualizer mengatur kunci berdasarkan hierarki database Anda. Anda dapat menggunakannya untuk melihat perincian data untuk rentang kunci tertentu.

Untuk melihat perincian data peta panas untuk grup kunci yang memiliki awalan yang sama:

  1. Arahkan kursor ke salah satu tingkat dalam hierarki kunci yang muncul di sebelah kiri peta panas.

    Key Visualizer menyoroti area peta panas yang menunjukkan tingkat hierarki ini. Gambar ini juga menunjukkan awalan kunci untuk semua kunci pada level ini.

    Contoh area yang ditandai di peta panas untuk sekelompok kunci

  2. Klik tingkat hierarki kunci yang ingin Anda periksa.

    Key Visualizer memperbesar tingkat hierarki ini.

    Contoh zoom in pada tingkat hierarki kunci

  3. Klik tingkat hierarki kunci lainnya untuk memperbesar lebih lanjut, atau tekan tombol Backspace atau Delete untuk kembali ke area sebelumnya.

Menyematkan detail tentang metrik

Saat Anda mengarahkan kursor ke peta panas, Key Visualizer akan menampilkan tooltip yang berisi detail tentang metrik yang berada di bawah kursor. Anda dapat menyematkan tooltip ini dengan mengklik peta panas. Tooltip yang disematkan menampilkan detail selengkapnya tentang metrik. Menyematkan tooltip juga memudahkan untuk mengambil screenshot tooltip atau menyalin informasi dari tooltip.

Beralih metrik

Secara default, saat Anda membuka pemindaian Key Visualizer, pemindaian tersebut akan menampilkan metrik Ops/s untuk kunci dokumen, yang memberi Anda ringkasan pola penggunaan. Untuk beralih ke metrik lain, klik menu drop-down Metric di atas peta panas, lalu klik metrik yang ingin Anda lihat.

Untuk kunci indeks, metrik ini menampilkan metrik Index Write Ops/s yang memberikan ringkasan penggunaan kunci indeks.

Untuk deskripsi setiap metrik, lihat Metrik Visualisasi Utama.

Menemukan koneksi antara berbagai metrik untuk kunci dokumen

Anda dapat melihat beberapa metrik secara bersamaan di Key Visualizer saat ingin membandingkan metrik atau menemukan korelasi antarmetrik. Misalnya, Anda mungkin ingin melihat apakah hotspot pada peta panas Ops/s berkorelasi dengan latensi tinggi di peta panas Latensi operasi tulis rata-rata.

Untuk melihat beberapa metrik dan nilainya secara bersamaan, klik Tampilkan Panel Info di dekat pojok kanan atas. Daftar metrik akan muncul di panel di sebelah kanan pemindaian.

Contoh yang menampilkan panel multimetrik for_a_scan

Untuk memeriksa beberapa metrik sekaligus, gunakan alat berikut di panel multimetrik:

  • Untuk menampilkan atau menyembunyikan peta panas miniatur untuk semua metrik, klik Expand All atau Collapse All di kanan atas.

  • Untuk menampilkan peta panas setiap metrik, klik nama metrik.

  • Untuk menyembunyikan peta panas metrik individual, klik nama metrik lagi.

  • Untuk menampilkan peta panas metrik di jendela utama, klik panah solid di tepi kiri panel judul metrik.

    Panah kiri menampilkan metrik di jendela utama

  • Arahkan kursor ke peta panas miniatur untuk melihat aktivitas yang sesuai di tampilan utama.

Untuk membandingkan metrik yang berbeda untuk bucket kunci pada waktu yang sama, Anda dapat menyematkan nilai dalam pemindaian, lalu beralih ke metrik yang berbeda pada waktu yang sama:

  1. Arahkan kursor ke posisi yang diinginkan pada peta panas besar di jendela utama.
  2. Klik untuk menyematkan tooltip. Nilai di panel samping tetap tetap ke bucket kunci dan titik waktu yang Anda sematkan.
  3. Untuk menampilkan metrik di peta panas besar, klik panah tebal di sebelah kiri untuk metrik tersebut. Tooltip di jendela utama menampilkan detail lengkap untuk metrik tersebut.

Langkah selanjutnya