Bu sayfada, Cloud Firestore kullanımınızı nasıl izleyebileceğiniz ve uygulamanızdaki olası sorunları nasıl tespit edebileceğiniz açıklanmaktadır.
Kullanım kontrol paneli
Zaman içinde belge okuma, yazma ve silme işlemlerini görüntülemek için Google Cloud Console ve Firebase konsolundaki kullanım kontrol panellerini kullanın.
Erişim denetimi
Kullanım kontrol panelleri için monitoring.timeSeries.list Cloud IAM izni gerekir.
Proje Sahibi, Düzenleyici ve Görüntüleyici rolleri bu izni verir. Bu izni Cloud Monitoring rolü veya özel rol aracılığıyla da verebilirsiniz.
Veritabanı kullanımı kontrol paneli
Bir Cloud Firestore veritabanının kullanım metriklerini görüntülemek için Google Cloud Console'da veritabanının Kullanım sayfasını açın.
Google Cloud Console'da Veritabanları sayfasına gidin.
Veritabanları listesinden gerekli veritabanını seçin.
Gezinme menüsünde Kullanım'ı tıklayın.
Veritabanı kullanımınızı görüntülemek için sayfada görünen mesajdaki bağlantıyı tıklayın.

Birleştirilmiş kullanım kontrol paneli
Projenizde birden fazla Cloud Firestore veritabanı varsa toplu kullanım metriklerini Google Cloud Console'da veya Firebase konsolunda görüntüleyebilirsiniz.
Google Cloud konsolu
Google Cloud Console'da Proje kullanımı sayfasına gidin.
Google Cloud projesi kullanımına gitme
Proje kullanımı kontrol panelinde, zaman içindeki doküman işlemleri aşağıdaki gibi gösterilir:

Firebase konsolu
Cloud Firestore kullanım sayfasına (Firebase konsolu) gidin

Kullanım kontrol paneli ve fatura raporları
Firebase ve Cloud konsollarındaki Cloud Firestore kullanım kontrol panelleri, kullanımın tahmini bir değerini gösterir. Kullanımdaki ani artışları belirlemenize yardımcı olabilirler. Ancak kontrol paneli, faturalandırılan işlemlerin tam bir görünümü değildir. Faturalandırılan kullanım büyük olasılıkla daha yüksektir. Tüm tutarsızlık durumlarında fatura raporu, kullanım kontrol paneline göre önceliklidir.
Kullanım kontrol paneli ile faturalandırılan kullanım arasında tutarsızlıklara neden olan işlemler şunlardır:
- İçe ve dışa aktarma işlemleri. Bu işlemler tarafından gerçekleştirilen okuma ve yazma işlemleri, kullanım kontrol panelinde gösterilmez.
- Yalnızca doğrulama amaçlı yazma işlemleri için işlem yapılmaz. Yalnızca bir belgenin varlığını veya yokluğunu doğrulayan yazma işlemleri, faturalandırılan okuma işlemlerine katkıda bulunur ancak yazma kullanımı kontrol panelinde sırasıyla
UPDATE_NOOPveDELETE_NOOPolarak gösterilir. - İşlemsiz yazma işlemleri. Veritabanında değişikliğe yol açmayan işlemler (ör. alan değerlerini değiştirmeyen bir güncelleme veya silinmiş bir dokümana yazma işlemi), kullanım kontrol panelinde
UPDATE_NOOPveyaDELETE_NOOPolarak gösterilebilir.NOOPolarak gösterilseler de faturalandırılan işlemlere katkıda bulunurlar. Daraltılmış yazma işlemleri. Aynı dokümana hızlı bir şekilde art arda birden fazla yazma işlemi yapıldığında kullanım kontrol paneli, birden fazla yazma işlemini birleştirip tek bir işlem olarak sayabilir. Kullanım faturalandırılırken her yazma işlemi ayrı ayrı sayılır.
Kullanım kontrol panelinde, sunucu zaman damgaları, sayısal artışlar ve dizi birleştirme işlemleri gibi alan dönüşümleri için yazma işlemleri de daraltılır. Alan dönüşümleri için kullanım kontrol paneli, birden fazla işlemi tek bir işlem olarak sayabilir.
- Sıfır sonuç döndüren sorgular. Sıfır sonuç döndüren sorgular, bir okuma işlemi maliyetine neden olur. Bu kullanım faturalandırılır ancak kullanım kontrol panelinde görünmez.
- Okunan dizin girişleri'nden okuma işlemleri. Bu kullanım faturalandırılır ancak kullanım kontrol panelinde görünmez. Örneğin, toplama sorguları okunan dizin girişleri için faturalandırılır ancak bu kullanım, kullanım kontrol panelinde görünmez.
- Koleksiyon kimliklerini listeleme istekleri. Kullanım kontrol paneli, koleksiyon kimliği başına bir okuma işlemi bildirir. Bu, faturalandırmadan farklıdır.
Silme işlemlerine yönelik kullanım kontrol paneli, geçerlilik süresi (TTL) politikaları tarafından gerçekleştirilen otomatik geçerlilik süresi sona erme işlemlerini yakalamaz. Lütfen Cloud Monitoring adresindeki TTL metriklerine bakın.
Güvenlik kuralı kullanımı
Ayrıca Firebase konsolu, kural çağrılarının kullanışlı ve hızlı bir görünümünü sunan bir Firebase Güvenlik Kuralları değerlendirme kontrol paneli sağlar. Firebase Güvenlik Kuralları kullanımını Cloud Monitoring üzerinden de izleyebilirsiniz. Bu sayede, aynı kural değerlendirme metriklerini elde etmenin yanı sıra özel kontrol panelleri oluşturabilir, trendleri analiz edebilir ve uyarıları (örneğin, reddedilen istekler arttığında) yapılandırabilirsiniz. Kullanılabilir metriklerin tam listesi için Cloud Monitoring metrik referansına bakın.

Cloud Monitoring metrik
Cloud Monitoring, Google Cloud ürünlerinden metrikleri, etkinlikleri ve meta verileri toplar. Cloud Firestore konsolundaki kullanım kontrol paneli de aynı metrik verilerini raporlar. Özel kontrol panelleri ve kullanım uyarıları ayarlamak için Cloud Monitoring kullanın.
Cloud Monitoring aşağıdaki Cloud Firestore metrikleri içerir:
| Metrik Adı | Açıklama |
|---|---|
| Belge Okuma Sayısı |
Başarılı belge okuma sayısı. Bu metriği okuma türüne göre (LOOKUP veya QUERY) dökümünü alabilirsiniz. Bu metrik, yönetilen dışa aktarma veya toplu silme işlemlerinden okumaları içermez. |
| Belge Yazma Sayısı |
Başarılı doküman yazma işlemlerinin sayısı. Metriği yazma türüne göre (CREATE veya UPDATE) dökümünü alabilirsiniz. Bu metrik, yönetilen içe aktarma işlemlerinden gelen yazma işlemlerini içermez. |
| Belge Silme Sayısı | Başarıyla silinen doküman sayısı. |
| Etkin Bağlantılar |
Veritabanınıza yapılan etkin bağlantıların sayısı. Etkin her mobil ve web SDK'sı, birden fazla anlık görüntü dinleyicisi arasında paylaşılabilen tek bir bağlantı sürdürür. Sunucu istemci kitaplıkları, anlık görüntü dinleyici başına bir bağlantı oluşturur. |
| Anlık görüntü işleyiciler (SnapshotListener) |
Tüm etkin bağlantılardaki anlık görüntü dinleyicilerinin sayısı. |
| Geçerlilik süresi silme sayısı |
Geçerlilik süresi (TTL) politikaları tarafından silinen dokümanların toplam sayısı. |
| Yaşam süresinin dolmasından silme işlemine kadar geçen süre |
Bir dokümanın geçerlilik süresi (TTL) politikası kapsamında süresinin dolması ile gerçekten silinmesi arasında geçen süre. |
- Gerçek zamanlı güncelleme kullanımı
Gerçek zamanlı güncellemeleri kullanımınızı ölçmek için etkin bağlantılar ve anlık görüntü dinleyicileri metriklerini kullanın.
Bir kullanıcının telefonunda uygulamanızı açtığını varsayalım. Uygulama daha sonra Cloud Firestore hizmetine bağlanır ve 10 sorguya abone olur. Bu işlem, metriklerinizi 1 etkin bağlantı ve 10 anlık görüntü dinleyicisi artırır.
- Örnekleme hızı
Cloud Firestore metrikleri her dakika örneklenir ancak güncellemelerin kontrol panellerinizde gösterilmesi 4 dakikayı bulabilir.
Gecikme metrikleri
Arka uç gecikme metrikleri, yaygın Google Cloud firestore metrikleri aracılığıyla kullanılabilir.
Örneğin, Cloud Console'un metrik gezgini görünümünde p50 gecikme süresi grafiği bulunabilir.
Cloud Monitoring kontrol paneli oluşturma
Önceden tanımlanmış bir kontrol panelini görüntülemek veya kontrol paneli oluşturmak için İzleme kontrol panelini kullanma başlıklı makaleyi inceleyin.
Sırada ne var?
- Cloud Monitoring hakkında daha fazla bilgi edinin.
- Firestore performansını izlemeyle ilgili en iyi uygulamalar hakkında bilgi edinin.