Halaman ini memberikan ringkasan 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. Layanan ini menghasilkan laporan visual yang mengelompokkan penggunaan Anda berdasarkan entitas yang Anda akses atau entri indeks yang ditulis atau dihapus saat entitas 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 yang tiba-tiba.
- Mendapatkan pemahaman yang lebih baik tentang cara Anda mengakses data yang disimpan dalam mode Datastore.
- Mendesain model data secara berulang atau meningkatkan desain model data yang ada. Di 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 entitas tertentu.
- Lihat pengaruh peningkatan traffic mendadak terhadap latensi.
- Periksa 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 jangka waktu dua jam. Pemindaian untuk jangka waktu tertentu tersedia untuk database dengan traffic yang melebihi 3.000 operasi dokumen dalam satu menit tertentu dalam jangka waktu tersebut.
Kelayakan pemindaian sepenuhnya bergantung pada aktivitas database. Fitur ini tidak bergantung pada jumlah data atau jenis data di database Anda.
Pemindaian Key Visualizer
Gambar berikut menunjukkan pemindaian Key Visualizer. Setiap pemindaian mencakup peta panas yang menunjukkan pola akses atau metrik performa untuk sekelompok kunci entity atau kunci indeks dari waktu ke waktu.
Membagikan URL pemindaian
Anda dapat membagikan atau mem-bookmark URL hasil 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 pemindaian Key Visualizer adalah peta panas, yang menunjukkan nilai metrik dari waktu ke waktu, yang dibagi menjadi hingga 1.000 kelompok utama yang berdekatan.
Untuk peta panas kunci entity, sumbu x peta panas mewakili waktu, dan sumbu y mewakili kunci entity, sedangkan untuk peta panas kunci indeks, sumbu x peta panas mewakili waktu, dan sumbu y mewakili kunci indeks.
Setiap pemindaian Key Visualizer untuk Firestore dalam mode Datastore 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 tampil sebagai warna cerah. Nilai tertinggi muncul dalam warna putih.
Berbagai jenis penggunaan menghasilkan pola visual yang berbeda dalam peta panas, yang memungkinkan masalah didiagnosis secara sekilas. Lihat Pola peta panas untuk kunci entity atau Pola peta panas untuk kunci indeks untuk melihat contoh beberapa pola umum.
Key Visualizer menyediakan alat untuk membantu Anda memahami data dalam setiap pemindaian. Lihat Mulai menggunakan Key Visualizer dan Menjelajahi peta panas.
Bucket utama
Key Visualizer membagi semua kunci dalam database Anda menjadi hingga 1.000 rentang yang berdekatan, dengan jumlah kunci dan Ops/s yang hampir sama di setiap rentang. Rentang ini dikenal sebagai bucket kunci.
Key Visualizer menggunakan total Ops/s database untuk membagi bucket kunci sehingga setiap bucket mencakup jumlah Ops/s yang kira-kira sama dengan ukuran minimum yang dimaksudkan sebesar 50 Ops/s per bucket kunci. Untuk database dengan total Ops/s yang lebih tinggi, setiap bucket utama dapat merekam lebih dari 50 Ops/s. Database dengan kurang dari 50 Ops/s menghasilkan pemindaian dengan satu bucket kunci.
Laporan Key Visualizer menampilkan sebagian besar metrik sebagai rata-rata di setiap key bucket, atau sebagai nilai maksimum dalam setiap key bucket.
Metrik
Metrik berikut tersedia untuk kunci entitas dalam pemindaian Key Visualizer:
| Metrik | Deskripsi |
|---|---|
| Metrik aktivitas | |
| Operasi/dtk | Jumlah rata-rata operasi entitas per detik. Rata-rata sama dengan jumlah penulisan, pencarian, dan kueri per detik. Metrik ini dapat menunjukkan kunci mana yang populer. |
| Operasi tulis/dtk | Jumlah rata-rata operasi entitas per detik untuk penulisan dan penghapusan. |
| Operasi pencarian/dtk | Jumlah rata-rata operasi entitas per detik untuk pencarian. |
| Operasi kueri/dtk | Jumlah rata-rata operasi entitas 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. |
| Tulis latensi ekor | Latensi penulisan atau penghapusan maksimum yang diamati dalam data yang diproses di bucket. |
| Mencari latensi tail | Latensi penelusuran 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 Penulisan Indeks/dtk | Jumlah rata-rata penulisan indeks per detik. |
Rata-rata performa
Metrik latensi rata-rata mengambil rata-rata di seluruh kunci dalam key bucket. Karena pengukuran ini dilakukan di lapisan penyimpanan, latensi yang dilaporkan di sini mungkin lebih rendah daripada total latensi yang dialami panggilan API.
Batas
Meskipun Key Visualizer menampilkan berbagai metrik, Key Visualizer tidak menampilkan setiap metrik yang dapat memengaruhi performa mode Datastore. Misalnya:
- Masalah jaringan antara aplikasi dan Google Cloud mungkin tidak terlihat. Masalah ini mungkin muncul sebagai deretan vertikal di semua kunci di Key Visualizer yang hanya memberi Anda petunjuk tentang kapan masalah terjadi.
Durasi data
Data yang dikumpulkan oleh Key Visualizer untuk Firestore dalam mode Datastore 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 menandai atau membagikan URL untuk pemindaian Key Visualizer, URL tersebut memiliki masa aktif maksimum 14 hari.
Langkah berikutnya
- Pelajari cara memulai Key Visualizer.
- Pahami pola kunci entity atau pola kunci indeks yang mungkin Anda lihat dalam peta panas Key Visualizer.
- Cari tahu cara menjelajahi peta panas secara mendetail.