Mulai menggunakan Key Visualizer

Halaman ini menjelaskan cara menggunakan Key Visualizer untuk memeriksa masalah performa yang terkait dengan pola penggunaan Firestore Anda.

Sebelum memulai

Untuk menggunakan Key Visualizer untuk Firestore, Anda harus mengaktifkan Firestore Key Visualizer API.

Enable the API

Peran yang diperlukan

Pastikan akun Anda diberi salah satu peran IAM berikut:

  • Cloud Datastore Owner
  • Cloud Datastore Key Visualizer Viewer
  • Editor
  • Pemilik

Peran ini mencakup izin IAM berikut yang diperlukan untuk mengakses Key Visualizer:

  • datastore.keyVisualizerScans.get
  • datastore.keyVisualizerScans.list
  • datastore.databases.getMetadata
  • resourcemanager.projects.get

Anda juga dapat menentukan peran khusus dengan izin yang diperlukan.

Melihat pemindaian untuk jangka waktu tertentu

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.

Untuk meluncurkan Key Visualizer:

  1. Di konsol Google Cloud, buka halaman Databases.

    Buka Databases

  2. Pilih database yang diperlukan dari daftar database.

  3. Di menu navigasi, klik Key Visualizer.

  4. Pilih rentang waktu dan metrik dari pemindaian Key Visualizer yang tersedia:

    1. Klik ikon Pensil di kanan atas. Pilih Tanggal dan Rentang Waktu.

      Pemindaian tersedia berdasarkan kelayakan pemindaian. Anda tidak dapat memilih rentang waktu yang tidak memenuhi kelayakan pemindaian atau yang masih diproses. Dua pemindaian terbaru dalam sehari akan memerlukan waktu untuk diproses sebelum tersedia.

    2. Pilih Semua data dokumen atau Semua data indeks sebagai sumber.

    3. Klik Perbarui.

  5. Pilih metrik yang akan dianalisis:

    Klik dropdown metrik di kiri atas, lalu pilih metrik yang ingin dilihat. Visualisator Kunci akan terbuka di metrik Ops/s untuk kunci dokumen dan metrik Index Write Ops/s untuk kunci indeks secara default.

Untuk membandingkan metrik atau mencari korelasi data, Anda dapat menampilkan beberapa metrik Key Visualizer secara bersamaan. Lihat Menemukan hubungan antara berbagai metrik.

Melihat ringkasan aktivitas

Untuk mendapatkan ringkasan aktivitas selama jangka waktu dua jam yang dipilih, tinjau peta panas untuk metrik default.

Contoh berikut menunjukkan peta panas dengan perbedaan utama dalam pola penggunaan untuk berbagai rentang kunci:

  • Rentang yang ditampilkan dalam warna gelap memiliki sedikit atau tidak ada aktivitas.
  • Rentang dalam warna cerah memiliki aktivitas yang jauh lebih banyak.
  • Rentang putih yang bersinar di tengah memiliki aktivitas yang sangat tinggi.

Contoh pemindaian Key Visualizer

Pemindaian kunci dokumen

Metrik Ops/s mengukur jumlah permintaan per detik untuk setiap rentang kunci. Metrik ini adalah jumlah permintaan operasi tulis, pencarian, dan kueri. Key Visualizer menampilkan metrik ini secara default saat Anda membuka peta panas.

Setelah mendapatkan gambaran tentang keseluruhan aktivitas di database, Anda dapat melanjutkan penyelidikan dengan melihat metrik lain dan berfokus pada rentang utama yang mungkin menyebabkan masalah. Pelajari lebih lanjut.

Pemindaian kunci indeks

Metrik Index Write Ops/s di sel tertentu mengukur operasi tulis indeks rata-rata per detik dalam interval waktu 10 detik dan rentang kunci yang sesuai.

Langkah selanjutnya