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
  • Penampil Key Visualizer Cloud Datastore
  • Editor
  • Owner

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 selama jangka waktu tertentu

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.

Untuk meluncurkan Key Visualizer:

  1. Di konsol Google Cloud, buka halaman Databases.

    BUka Database

  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 Date dan Time Span.

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

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

    3. Klik Perbarui.

  5. Pilih metrik untuk dianalisis:

    Klik drop-down metrik di kiri atas dan pilih metrik yang akan dilihat. Visualizer Kunci terbuka di metrik Ops/dtk untuk kunci dokumen dan metrik Operasi Tulis Indeks 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 menampilkan peta panas yang memiliki perbedaan besar dalam pola penggunaan untuk berbagai rentang kunci:

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

Contoh pemindaian Key Visualizer

Pemindaian kunci dokumen

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

Setelah mengetahui keseluruhan aktivitas dalam database, Anda dapat melanjutkan investigasi dengan melihat metrik lain dan berfokus pada rentang utama yang mungkin menyebabkan masalah. Pelajari lebih lanjut.

Pemindaian kunci indeks

Metrik Operasi Tulis Indeks pada sel tertentu mengukur penulisan indeks rata-rata per detik dalam interval waktu 10 detik dan rentang kunci yang sesuai.

Langkah selanjutnya