Key Visualizer'ı kullanmaya başlama

Bu sayfada, Cloud Firestore kullanım kalıplarınızla ilgili performans sorunlarını kontrol etmek için Key Visualizer'ın nasıl kullanılacağı açıklanmaktadır.

Başlamadan önce

Cloud Firestore için Key Visualizer'ı kullanmak istiyorsanız Firestore Key Visualizer API'yi etkinleştirmeniz gerekir.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Gerekli roller

Hesabınıza aşağıdaki IAM rollerinden birinin verildiğinden emin olun:

  • Cloud Datastore Sahibi
  • Cloud Datastore Key Visualizer Görüntüleyicisi
  • Düzenleyici
  • Sahip

Bu roller, Key Visualizer'a erişmek için gereken aşağıdaki IAM izinlerini içerir:

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

Gerekli izinlere sahip bir özel rol de tanımlayabilirsiniz.

Belirli bir dönem için tarama görüntüleme

Her Key Visualizer taraması iki saatlik bir dönemi kapsar. Belirli bir dönem için tarama, bu dönemde herhangi bir dakikada 3.000 belge işlemini aşan trafiğe sahip veritabanları için kullanılabilir.

Key Visualizer'ı başlatmak için:

  1. Google Cloud Console'da Veritabanları sayfasına gidin.

    Veritabanları'na git

  2. Veritabanları listesinden gerekli veritabanını seçin.

  3. Gezinme menüsünde Key Visualizer'ı tıklayın.

  4. Mevcut Key Visualizer taramalarından bir zaman aralığı ve metrik seçin:

    1. Sağ üstteki kalem simgesini tıklayın. Tarih ve Zaman Aralığı seçin.

      Taramalar, tarama uygunluğuna göre kullanılabilir. Tarama uygunluğunu karşılamayan veya hâlâ işlenmekte olan zaman aralıklarını seçemezsiniz. Günün en son iki taramasının kullanıma sunulmadan önce işlenmesi biraz zaman alır.

    2. Kaynak olarak Tüm doküman verileri veya Tüm dizin verileri'ni seçin.

    3. Güncelle'yi tıklayın.

  5. Analiz edilecek bir metrik seçin:

    Sol üstteki metrikler açılır listesini tıklayın ve görüntülenecek bir metrik seçin. Key Visualizer, varsayılan olarak belge anahtarları için Ops/s metriğinde, dizin anahtarları için ise Dizin Yazma İşlemi/sn metriğinde açılır.

Metrikleri karşılaştırmak veya veri korelasyonlarını aramak için birden fazla Key Visualizer metriğini birlikte görüntüleyebilirsiniz. Farklı metrikler arasındaki bağlantıları bulma başlıklı makaleyi inceleyin.

Etkinliğe genel bakış görüntüleme

Seçilen iki saatlik dönemdeki etkinliklere genel bir bakış için varsayılan metriğin ısı haritasını inceleyin.

Aşağıdaki örnekte, farklı anahtar aralıklarının kullanım düzeninde büyük farklılıklar olan bir ısı haritası gösterilmektedir:

  • Koyu renklerle gösterilen aralıklarda çok az etkinlik vardır veya hiç etkinlik yoktur.
  • Parlak renklerdeki aralıklar önemli ölçüde daha fazla etkinlik gösterir.
  • Ortadaki parlak beyaz aralıkta etkinlik çok yüksek.

Key Visualizer taraması örneği

Belge anahtarlarını tarama

İşlem/sn metriği, her anahtar aralığı için saniye başına istek sayısını ölçer. Bu metrik, yazma, arama ve sorgu isteklerinin toplamıdır. Key Visualizer, ısı haritası açtığınızda bu metriği varsayılan olarak gösterir.

Veritabanınızdaki genel etkinlik hakkında fikir edindikten sonra, diğer metriklere bakarak ve sorunlara neden olabilecek önemli aralıklara odaklanarak araştırmanıza devam edebilirsiniz. Daha fazla bilgi

Dizin anahtarlarını tarama

Belirli bir hücredeki Dizin Yazma İşlemleri/sn metriği, ilgili 10 saniyelik zaman aralığı ve anahtar aralığındaki saniye başına ortalama dizin yazma işlemlerini ölçer.

Sırada ne var?