Bu sayfada, sorgu performansını tespit etmek ve analiz etmek için Query Insights kontrol panelinin nasıl kullanılacağı açıklanmaktadır.
Sorgu Analizleri'ne 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.
Sorgu analizleri verileri
Sorgu analizleri, aşağıdaki API yöntemlerinden alınan verileri içerir:
findaggregate
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 belgeler, 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ük | Toplam faturalandırılabilir okuma işlemlerine göre en çok kullanılan sorguları filtrelemeye yardımcı olacak veriler. |
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.
Sınırlamalar
Sorgu analizleri verileri bir ila iki saat gecikmeli olarak gösterilir.
Fiyatlandırma
Sorgu analizleri için ek ücret alınmaz.
Gerekli roller
Query Insights kontrol panelini görüntülemek için gereken izni almak üzere yöneticinizden projenizde size Datastore Görüntüleyici (roles/datastore.viewer) IAM rolünü vermesini isteyin.
Önceden tanımlanmış bu rol, Query Insights kontrol panelini görüntülemek için gereken datastore.insights.get iznini içerir.
Bu izni özel roller veya diğer önceden tanımlanmış roller ile de alabilirsiniz.
Sorgu Analizleri'ni görüntüleme
Firebase konsolu
- Bir Cloud Firestore veritabanının Query Insights verilerini görüntülemek için Google Cloud Console'da veritabanının Query Insights bölmesini açın.
Firebase konsolunda Firestore Database sayfasına gidin.
- Veritabanları listesinden bir veritabanı seçin.
- 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.