Bu sayfada, Cloud Firestore için Key Visualizer teşhis aracı hakkında genel bilgiler verilmektedir.
Key Visualizer nedir?
Key Visualizer, Cloud Firestorekullanım kalıplarınızı analiz etmenize yardımcı olan bir araçtır. Eriştiğiniz dokümanlara veya dokümanlar değiştirildikçe yazılan ya da silinen dizin girişlerine göre kullanımınızı ayrıntılı olarak gösteren görsel raporlar oluşturur.
Key Visualizer, kullanım kalıpları hakkında geniş ölçekli analizler sağlayabilir. Key Visualizer'ın kullanım alanları şunlardır:
- Performans sorunlarını giderme Key Visualizer, veritabanınızda sıralı doküman veya dizin anahtarlarından ya da ani trafik artışlarından kaynaklanan performans sorunlarını belirlemenize yardımcı olur.
- Cloud Firestore içinde depolanan verilere nasıl eriştiğinizi daha iyi anlama.
- Veri modelini yinelemeli olarak tasarlama veya mevcut bir veri modelinin tasarımını iyileştirme. Her yinelemede, veri modelinizin neden olduğu sorunları tespit etmek için Key Visualizer'ı kontrol edebilirsiniz.
Key Visualizer, bu hedeflere ulaşmak için aşağıdaki görevleri tamamlamanıza yardımcı olabilir:
- Okuma veya yazma işlemlerinizin belirli belge aralıklarında yoğun ilgi alanları oluşturup oluşturmadığını kontrol edin.
- Trafikteki ani artışın gecikmeyi nasıl etkilediğini görün.
- Erişim kalıplarınızın veritabanınızda dengeli olup olmadığına bakın.
- Dizin yükleme sorunlarına neden olan dizin tanımlarını belirlemek için dizin anahtarlarının yapısını kontrol edin.
- Daha iyi iş yükü kalıbı tahminleri yapmak için dizin anahtarları görselleştirmesini kullanın.
Tarama uygunluğu
Her Key Visualizer taraması iki saatlik bir süreyi 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.
Tarama uygunluğu tamamen veritabanı etkinliğine bağlıdır. Veritabanınızdaki veri miktarına veya veri türüne bağlı değildir.
Key Visualizer taramaları
Aşağıdaki resimde bir Key Visualizer taraması gösterilmektedir. Her tarama, zaman içinde bir grup belge anahtarı veya dizin anahtarı için erişim kalıplarını ya da performans metriklerini gösteren bir ısı haritası içerir.
Tarama URL'lerini paylaşma
Key Visualizer taramasının URL'sini paylaşabilir veya yer işaretlerine ekleyebilirsiniz. URL, aynı Key Visualizer taramasını açar ve aynı metriği seçer. Bu URL, tarama verilerinin süresi dolana kadar geçerlidir.
Isı haritaları
Anahtar görselleştirici taramasının temelini, bir metriğin zaman içindeki değerini gösteren ısı haritası oluşturur. Bu değer, 1.000'e kadar bitişik anahtar pakete ayrılır.
Doküman anahtarları ısı haritasında, ısı haritasının x ekseni zamanı, y ekseni ise doküman anahtarlarını temsil eder. Dizin anahtarları ısı haritasında ise ısı haritasının x ekseni zamanı, y ekseni ise dizin anahtarlarını temsil eder.
Cloud Firestore için her Key Visualizer taraması, 10 saniyelik segmentlere bölünmüş iki saatlik etkinliği kapsar.
Bir metriğin düşük değeri "soğuk" olarak kabul edilir ve koyu bir renkte görünür. Yüksek değerler "sıcak" olarak kabul edilir ve parlak bir renkte gösterilir. En yüksek değerler beyaz renkte görünür.
Farklı kullanım türleri, ısı haritasında farklı görsel desenlere neden olur. Bu sayede sorunları bir bakışta teşhis etmek mümkün olabilir. Bazı yaygın kalıpların örnekleri için Belge anahtarları için ısı haritası kalıpları veya Dizin anahtarları için ısı haritası kalıpları başlıklı makalelere bakın.
Key Visualizer, her taramadaki verileri anlamanıza yardımcı olacak araçlar sunar. Key Visualizer'ı kullanmaya başlama ve Isı haritalarını keşfetme başlıklı makaleleri inceleyin.
Anahtar kelime paketleri
Key Visualizer, veritabanınızdaki tüm anahtarları 1.000'e kadar bitişik aralığa böler. Her aralıkta yaklaşık olarak aynı sayıda anahtar ve saniye başına işlem sayısı bulunur. Bu aralıklara önemli gruplar denir.
Key Visualizer, anahtar paketlerini bölmek için bir veritabanının toplam işlem/sn değerini kullanır. Böylece her paket, anahtar paketi başına en az 50 işlem/sn olacak şekilde yaklaşık olarak aynı sayıda işlem/sn değerini yakalar. Toplam işlem/sn değeri daha yüksek olan veritabanlarında, anahtar paketleri her biri 50'den fazla işlem/sn yakalayabilir. 50 işlem/sn'den az olan veritabanları, tek anahtar paketiyle taramalara neden olur.
Key Visualizer, çoğu metriği her anahtar paketindeki ortalamalar veya her anahtar paketindeki maksimum değerler olarak raporlar.
Metrikler
Key Visualizer taramalarındaki doküman anahtarları için aşağıdaki metrikler kullanılabilir:
| Metrikler | Açıklama |
|---|---|
| Etkinlik metrikleri | |
| İşlem/sn | Saniyede ortalama belge işlemi sayısı. Saniye başına yazma, arama ve saniyedeki sorgu sayısı işlemlerinin toplam sayısına yaklaşık olarak eşittir. Bu metrik, hangi anahtarların popüler olduğunu gösterebilir. |
| Yazma işlemi sayısı/sn | Yazma ve silme işlemleri için saniyede ortalama belge işlemi sayısı. |
| Arama işlemleri/sn | Aramalar için saniyede ortalama belge işlemi sayısı. |
| Sorgu işlemleri/sn | Sorgular için saniyede ortalama belge işlemi sayısı. |
| Performans metrikleri | |
| Ortalama yazma gecikmesi | Paketteki işlenmiş verilerde yazma ve silme işlemlerinin ortalama gecikmesi. |
| Ortalama arama gecikmesi | Paketteki işlenmiş verilerde arama için ortalama gecikme. |
| Ortalama sorgu gecikmesi | Paketteki işlenmiş verilerde sorgular için ortalama gecikme. |
| Kuyruk gecikmesini yazma | Paketteki işlenmiş verilerde gözlemlenen maksimum yazma veya silme gecikmesi. |
| Arama kuyruğu gecikmesi | Paketteki işlenmiş verilerde gözlemlenen maksimum arama gecikmesi. |
| Sorgu kuyruk gecikmesi | Paketteki işlenmiş verilerde gözlemlenen maksimum sorgu gecikmesi. |
Key Visualizer taramalarındaki dizin anahtarları için aşağıdaki metrik kullanılabilir:
| Metrikler | Açıklama |
|---|---|
| Dizin Yazma İşlemi Sayısı/sn | Saniye başına ortalama dizin yazma sayısı. |
Performans ortalamaları
Ortalama gecikme metrikleri, anahtar paketindeki anahtarların ortalamasını alır. Bu ölçüm depolama katmanında yapıldığından, burada bildirilen gecikme süresi, bir API çağrısının yaşadığı toplam gecikme süresinden daha düşük olabilir.
Sınırlar
Key Visualizer çeşitli metrikler gösterse de Cloud Firestore performansını etkileyebilecek her metriği göstermez. Örneğin:
- Uygulamanız ile Google Cloud arasındaki ağ sorunları görünür olmayabilir. Bu sorunlar, Key Visualizer'daki tüm anahtarlarda dikey bantlar olarak görünebilir. Bu durumda, sorunların ne zaman oluştuğu hakkında yalnızca ipuçları verilir.
Veri süresi
Key Visualizer'ın Cloud Firestore için topladığı veriler 14 gün sonra silinir.
Key Visualizer verileri son 14 gün için kullanılabilir. Örneğin, 19 Aralık saat 12:45'te Key Visualizer'ı başlatırsanız 2 saatlik bir zaman aralığı için seçebileceğiniz en erken başlangıç zamanı 5 Aralık saat 13:00'dır.
Bu sınır, Key Visualizer taraması için URL'yi yer işaretlerine eklemeniz veya paylaşmanız durumunda URL'nin maksimum kullanım süresinin 14 gün olacağı anlamına da gelir.
Sırada ne var?
- Key Visualizer'ı kullanmaya nasıl başlayacağınızı öğrenin.
- Key Visualizer ısı haritalarında görebileceğiniz doküman anahtarı kalıplarını veya dizin anahtarı kalıplarını anlayın.
- Isı haritasını ayrıntılı olarak incelemeyi öğrenin.