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.

API'leri etkinleştirmek için gereken roller

API'leri etkinleştirmek için serviceusage.services.enable iznine sahip olmanız gerekir. Projeyi siz oluşturduysanız muhtemelen Sahip rolü (roles/owner) aracılığıyla bu izne zaten sahipsinizdir. Aksi takdirde bu izni Hizmet Kullanımı Yöneticisi rolü (roles/serviceusage.serviceUsageAdmin) aracılığıyla alabilirsiniz. Rolleri nasıl vereceğinizi öğrenin.

API'yi etkinleştirme

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 özel bir rol de tanımlayabilirsiniz.

Belirli bir döneme ait taramayı görüntüleme

Her Key Visualizer taraması iki saatlik bir dönemi kapsar. Belirli bir dönem için tarama, o dönemdeki 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 gidin

  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 yapı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 işlenmesi ve kullanılabilir hale gelmesi 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ülemek istediğiniz metriği seçin. Key Visualizer, varsayılan olarak doküman anahtarları için İşlem/sn metriğinde ve dizin anahtarları için 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ında bağlantı bulma bölümüne bakın.

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

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

Aşağıdaki örnekte, farklı anahtar aralıkları için 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 renkli aralıklarda çok daha fazla etkinlik vardır.
  • Ortadaki parlak beyaz aralıkta çok yüksek etkinlik vardır.

Key Visualizer taraması örneği

Doküman 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, bir ı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 incelemenize devam edebilirsiniz. Daha fazla bilgi

Dizin anahtarları taraması

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

Sırada ne var?