Sorgu performansı istatistiklerini analiz etme

Bu sayfada, sorgu performansını tespit etmek ve analiz etmek için Query Insights kontrol panelinin nasıl kullanılacağı açıklanmaktadır.

Query Insights'a genel bakış

Metriklerle ilgili sorguları izlemek için Query Insights kontrol panelini kullanın. Metriklere göre, en sık kullanılan sorguları ve optimizasyon gerektirebilecek yüksek gecikme süresine sahip sorguları belirleyebilirsiniz. Sorgu Analizleri kontrol panelini kullanarak şunları yapabilirsiniz:

  • Sorgu performansı optimizasyonu: Gecikme süresi yüksek olan ve optimizasyon gerektirebilecek sorguları belirleyin.
  • Sorgu maliyeti yönetimi: Yüksek maliyetli sorguları keşfedin ve maliyetleri azaltmak için bunları optimize edin.
  • Sorgu istatistiklerini izleme: Sorgu istatistiklerini zaman içinde takip edin.
  • Dizin önerileri: Eksik veya optimum olmayan bileşik dizinleri belirleyin ve önerilen dizinleri doğrudan kontrol panelinden oluşturun (Enterprise sürümü).

Query Insights verileri

Sorgu analizleri, aşağıdaki API yöntemlerinden alınan verileri içerir:

  • find
  • aggregate

Belirli bir proje, veritabanı ve 10 dakika ile 30 gün arasında değişen süreler için bu yöntemleri kullanan sorgularla ilgili verileri görüntüleyebilirsiniz. Eşdeğer yapılara sahip sorgularla ilgili veriler, tek bir normalleştirilmiş sorgu altında yakalanır.

Sorgu Analizleri, bir sorgu hakkında aşağıdaki bilgileri döndürür:

Normalleştirilmiş sorgu metni Metin olarak temsil edilen sorgu yapısı.
Yürütme sayısı Seçilen zaman aralığındaki yürütme sayısı.
Hata sayısı Seçilen zaman aralığındaki hata sayısı.
Ortalama yürütme süresi (ms) Veritabanının sorguyu işlemek için harcadığı ortalama süre (milisaniye cinsinden).
Döndürülen ortalama sonuç sayısı Sorgu tarafından döndürülen sonuç sayısı. Sonuçlar arasında dokümanlar, koleksiyon kimlikleri ve toplu gruplar yer alır.
Taranan ortalama doküman sayısı Bir sorguda taranan doküman sayısı.
Taranan dizin girişlerinin ortalama sayısı Sorguyu yürütmek için incelenen dizin girişlerinin sayısı.
Ortalama süreye göre yükleme Ortalama gecikmeye göre en iyi sorguları filtrelemeye yardımcı olan veriler.
Toplam (faturalandırılabilir) okuma işlemlerine göre yükleme Toplam faturalandırılabilir okuma işlemlerine göre en çok kullanılan sorguları filtrelemeye yardımcı olan veriler.
Dizin önerileri Enterprise sürümü veritabanlarındaki sorgular için önerilen bileşik dizinler, kullanılan dizinler ve tahmini iş yükü etkisi.

Veri ayrıntı düzeyi ve saklama

Veri ayrıntı düzeyi, belirtilen süreye bağlıdır:

  • 4 gün öncesine kadar olan aralıklar için 10 dakikalık ayrıntı düzeyi
  • 30 gün öncesine kadar olan aralıklar için 1 saatlik ayrıntı düzeyi

Sorgu Analizleri için maksimum veri saklama süresi 30 gündür. 10 dakikalık veriler 4 gün, saatlik veriler ise 30 gün boyunca saklanır.

Sorgu Analizleri'ni görüntüleme

Firebase konsolu
  1. Bir Cloud Firestore veritabanının sorgu analizlerini görüntülemek için Google Cloud Console'da veritabanının Sorgu analizleri bölmesini açın.
  2. Firebase konsolunda Firestore Database sayfasına gidin.

    Firestore Veritabanı'na gidin

  3. Veritabanları listesinden bir veritabanı seçin.
  4. Sekme listesinden Sorgu Analizleri'ni tıklayın.

    Gecikme süresine veya okuma işlemlerinin sayısına göre en çok kullanılan sorguları bulmak için Gecikme süresi'ni veya Okuma işlemleri'ni tıklayın.

Dizin önerileri

Sorgu Analizleri için dizin önerileri, Firestore Enterprise sürümü veritabanlarında sık yürütülen sorgu şekilleri için eksik veya optimum olmayan bileşik dizin yapılandırmalarını otomatik olarak tanımlar.

Firestore Enterprise sürümünde sorgular, eşleşen bileşik dizinler olmadan da çalıştırılabilir. Bu durum, tüm koleksiyonun taranmasının yavaşlamasına veya bellek içi sıralama işlemlerine neden olabilir. Sorgu Analizleri kontrol paneli, geçmiş sorgu yürütme istatistiklerini analiz eder ve sorgu gecikmesini optimize etmek ve faturalandırılabilir taranan belgeleri azaltmak için hedeflenen bileşik dizinler önerir.

Dizin önerilerinin işleyiş şekli

Çevrimdışı bir toplu ardışık düzen, geçmişteki en popüler sorguları düzenli olarak değerlendirir:

  • Sorgu yapısı analizi: Sık yürütülen sorgulardan eşitlik, sıralama ve aralık yüklemlerini ayıklar.
  • Aday dizin oluşturma: Dizin sıralama buluşsal yöntemlerini (Eşitlik > Sıralama > Aralık) kullanarak olası bileşik dizin tanımları oluşturur.
  • Optimize edici değerlendirmesi: Temel sorgu yürütme maliyetlerini varsayımsal dizine eklenmiş yürütme planlarıyla karşılaştırmak için aday dizinleri sorgu motorunun maliyet modeline ekler.
  • İş yükü etkisi sıralaması: Önerilen dizinleri, toplam tahmini iş yükü maliyet tasarrufuna göre etki katmanlarına ayırır:
    • YÜKSEK: Tüm koleksiyon taramalarını seçmeli dizin aramalarına dönüştürerek belge okuma sayısını ve yürütme gecikmesini önemli ölçüde azaltır.
    • ORTA: Önceden sıralanmış dizin sonuçları sağlayarak bellek içi sıralama gibi pahalı işlemleri ortadan kaldırır.
    • DÜŞÜK: İleri/geri sarmada küçük iyileştirmeler sunar.
Dizin önerilerini görüntülemek ve Firebase konsolundan önerilen dizinler oluşturmak için:

  1. Firebase konsolunda Firestore Database sayfasına gidin.

    Firestore Veritabanı'na gidin

  2. Veritabanları listesinden bir Enterprise sürümü veritabanı seçin.

  3. Sorgu Analizleri sekmesini tıklayın.

  4. Sorgular tablosunda, öneriler içeren bir sorgu şekli bulun ve satırda veya popover'da Önerileri İncele'yi tıklayın.

  5. Dizin önerisi iletişim kutusunda bileşik dizin tanımını, alan sıralamasını ve tahmini iş yükü etki katmanını (YÜKSEK, ORTA veya DÜŞÜK) inceleyin.

  6. Kaydet'i tıklayın. Dizin oluşturma ilerleme durumunu takip etmek için Uzun Süreli İşlemler (LRO) çekmecesi açılır.

  7. Derleme tamamlandığında dizin, Dizinler sekmesinde listelenir ve öneri göstergesi sorgu satırından kaybolur.

Desteklenen sürümler

Dizin önerileri yalnızca Firestore Enterprise sürümü veritabanlarında desteklenir. Standard Edition veritabanları desteklenmez.

Sınırlamalar

  • Sorgu analizleri verileri bir ila iki saat gecikmeli olarak gösterilir.
  • Dizin önerileri, gerçek zamanlı olarak değil, geçmiş sorgu verilerine göre düzenli olarak oluşturulur.
  • Dizin önerileri, yeni bileşik dizinler önerir. Mevcut dizinlerin değiştirilmesini veya silinmesini önermez.
  • Otomatik dizin oluşturma desteklenmez. Önerilen dizinlerin manuel olarak oluşturulması gerekir.
  • Sorgu normalleştirme, değişmez değerleri yer tutucularla değiştirir. Dizin önerileri, belirli çalışma zamanı değerleri yerine normalleştirilmiş sorgu şablonlarını temel alır.
  • Maliyet değerlendirmesinde canlı veri örnekleme yerine sezgisel yöntemler kullanılır. Önerilen dizinler her senaryoda performansı artırmayabilir. Ayrıca dizin oluşturmak, yazma ve depolama ek yükü getirir.

Fiyatlandırma

Sorgu Analizleri veya dizin önerileri için ek ücret alınmaz.

Gerekli roller

Sorgu Analizleri kontrol panelini görüntülemek ve önerilen dizinleri oluşturmak için gereken izinleri almak üzere yöneticinizden projenizde size aşağıdaki IAM rollerini vermesini isteyin:

Önceden tanımlanmış bu roller, datastore.insights.get ve datastore.indexes.create izinlerini içerir.

Bu izinleri özel roller veya diğer önceden tanımlanmış roller aracılığıyla da alabilirsiniz.

Sırada ne var?