Ringkasan Key Visualizer

Halaman ini menyediakan ringkasan tentang alat diagnostik Key Visualizer untuk Firestore dalam mode Datastore.

Apa itu Key Visualizer?

Key Visualizer adalah alat yang membantu Anda menganalisis pola penggunaan mode Datastore. Alat ini menghasilkan laporan visual yang menguraikan penggunaan Anda berdasarkan entity yang Anda akses atau indeks entri yang ditulis atau dihapus saat entity 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 entity berurutan atau peningkatan traffic tiba-tiba.
Mendapatkan pemahaman yang lebih baik tentang cara mengakses data yang disimpan dalam mode Datastore.
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:

Memeriksa apakah pembacaan atau penulisan Anda akan menciptakan hotspot pada rentang entity 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.

Istilah Penting: Kunci indeks

Di Key Visualizer, istilah Kunci Indeks mengacu pada ID unik indeks. Indeks tersebut dapat berupa indeks bawaan atau indeks komposit. Misalnya, indeks berikut adalah beberapa contoh kunci indeks seperti yang terlihat pada alat Key Visualizer:

NAMESPACE: '' KIND: Test PROPERTIES: (integer: ASC, description: DESC)ANCESTOR:KEY(PROJECT('PROJECT_ID'),NAMESPACE(''),`Ancestor`,1685558526142092,`Test`,4848490060529664) VALUES: (1,"tIu9hjuuTpFj0OjDdBe0lX3Zfv8P6pOWKQYxE6hNaol0HrWzGoJ1MHva4T8XupUVccbe4ZCU7Fa1NUhEVBAAcBiUijZw00D0qHbZ") ENTITY: KEY(PROJECT('PROJECT_ID'),NAMESPACE(''),`Ancestor`,1685558526142092,`Test`,4848490060529664)
NAMESPACE: '' KIND: Test PROPERTIES: (integer: ASC, description:DESC) ANCESTOR: KEY(PROJECT('PROJECT_ID'),NAMESPACE(''),`Ancestor`,1685556682238805,`Test`,5097691411464192) VALUES: (1,"7m4tJ4nMqmpWgTH9dl6GxgHlnsLbCEZTlFRxVIapvFvXgt3SPogs2bqIDLxAL3GK6Wg1oig7PJi2iin7p3PZueNM5SgqMXwwAm9j") ENTITY:KEY(PROJECT('PROJECT_ID'),NAMESPACE(''),`Ancestor`,1685556682238805,`Test`,5097691411464192)

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 grup kunci entity 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 entity, sumbu x peta panas menyatakan waktu, dan sumbu y mewakili kunci entity, sedangkan untuk peta panas kunci indeks, sumbu x peta panas menyatakan waktu, dan sumbu y mewakili kunci indeks.

Setiap pemindaian Key Visualizer untuk Firestore dalam mode Datastore 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 entity 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 entity dalam pemindaian Key Visualizer:

Metrik	Deskripsi
Metrik aktivitas
Operasi	Jumlah rata-rata operasi entity 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 entity per detik untuk operasi tulis dan penghapusan.
Operasi pencarian	Jumlah rata-rata operasi entitas per detik untuk pencarian.
Operasi kueri/dtk	Jumlah rata-rata operasi entity 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, namun tidak menampilkan setiap metrik tunggal yang dapat memengaruhi performa mode Datastore. 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 dalam mode Datastore 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

Pelajari cara mulai menggunakan Key Visualizer.
Pahami pola kunci entity atau indeks pola kunci yang mungkin Anda lihat di peta panas Key Visualizer.
Cari tahu cara menjelajahi peta panas secara mendetail.