| Yalnızca Cloud Firestore Enterprise sürümü için geçerlidir. |
Bu sayfada, veritabanınızı izlemek için Cloud Monitoring metriklerini MongoDB uyumlu Cloud Firestore ile nasıl kullanacağınız açıklanmaktadır.
MongoDB uyumluluğu ile Cloud Firestore için Cloud Monitoring metrikleri
Aşağıdaki bölümlerde, MongoDB uyumluluğu ile Cloud Firestore için kullanılabilen metriklere genel bir bakış sunulmaktadır.
İzlenen Kaynaklar
Cloud Monitoring içindeki izlenen bir kaynak, sanal makine, veritabanı veya uygulama gibi mantıksal ya da fiziksel bir öğeyi temsil eder. İzlenen kaynaklar, incelenebilen, bir gösterge tablosu aracılığıyla raporlanabilen veya uyarı oluşturmak için kullanılabilen benzersiz bir metrik grubu içerir. Her kaynağın, kaynakla ilgili ek bilgiler içeren anahtar/değer çiftleri olan bir dizi kaynak etiketi de vardır. Kaynak etiketleri, kaynakla ilişkili tüm metrikler için kullanılabilir.
Cloud Monitoring API'yi kullanarak, MongoDB uyumluluğu ile Cloud Firestore'un performansı aşağıdaki kaynakla izlenir:
| Kaynaklar | Açıklama |
firestore.googleapis.com/Database | project,
location ve database_id için dökümler sağlayan izlenen kaynak türü. |
Metrikler
Cloud Firestore ile ilgili metriklerin tam listesi için Cloud Firestore metrikleri başlıklı makaleye bakın. Aşağıdaki bölümde, kullanılabilen metriklerden bazıları açıklanmaktadır.
Hizmet çalışma zamanı metrikleri
serviceruntime
Metrikler, bir projenin trafiğiyle ilgili üst düzey bir genel bakış sunar. Bu metrikler çoğu Google Cloud API'si için kullanılabilir. consumed_api
izlenen kaynak türü bu yaygın metrikleri içerir. Bu metrikler 30 dakikada bir örneklenir ve verilerin düzeltilmesine neden olur.
serviceruntime metrikleri için önemli bir kaynak etiketi method'dir. Bu etiket, temel alınan UPÇ yöntemini temsil eder. Çağırdığınız SDK yöntemi, temel alınan RPC yöntemiyle aynı ada sahip olmayabilir. Bunun nedeni, SDK'nın üst düzey API özeti sağlamasıdır. Ancak uygulamanızın Cloud Firestore ile nasıl etkileşim kurduğunu anlamaya çalışırken RPC yönteminin adına göre metrikleri anlamak önemlidir.
Belirli bir SDK yöntemi için temel RPC yönteminin ne olduğunu öğrenmeniz gerekiyorsa API dokümanlarına bakın.
api/request_latencies
api/request_latencies metriği, tamamlanan tüm isteklerdeki gecikme süresi dağılımlarını sağlar.
Cloud Firestore, Cloud Firestore Hizmeti bileşeninden metrikleri kaydeder. Gecikme metrikleri, Cloud Firestore'nın isteği aldığı andan Cloud Firestore'nın yanıtı göndermeyi bitirdiği ana kadar geçen süreyi (depolama katmanıyla etkileşimler dahil) kapsar. Bu nedenle, istemci ile Cloud Firestore hizmet arasındaki gidiş dönüş gecikmesi (rtt) bu metriklere dahil edilmez.
Belge işlemi metrikleri
Cloud Firestore okuma, yazma ve silme sayılarını sağlar. Yazma metriği, "CREATE" (OLUŞTUR) ve "UPDATE" (GÜNCELLE) işlemleri arasındaki dökümü sağlar. Bu metrikler, CRUD işlemleriyle uyumludur.
Veritabanınızın okuma ağırlıklı mı yoksa yazma ağırlıklı mı olduğunu ve yeni dokümanların silinen dokümanlara oranını anlamak için aşağıdaki metrikler kullanılabilir.
document/delete_ops_count: Başarıyla silinen belge sayısı.document/read_ops_count: Sorgulardan veya aramalardan elde edilen başarılı belge okuma sayısı.document/write_ops_count: Başarılı belge yazma sayısı.
Faturalandırma metrikleri
Faturalandırma kullanımını anlamak için bu metrikleri kullanın. Bu metrikler, yönetici işlemlerinden (dizin oluşturma, içe aktarma, dışa aktarma ve toplu silme) kaynaklanan faturalandırmayı içermez.
api/billable_read_units: Faturalandırılabilir okuma birimi sayısıdır. Kullanım, hizmet adına ve API yöntemine göre ayrılabilir.api/billable_write_units: Faturalandırılabilir yazma birimi sayısı. Kullanım, hizmet adına ve API yöntemine göre ayrılabilir.document/billable_managed_delete_write_units: TTL gibi yönetilen silme hizmetlerinden gelen faturalandırılabilir yazma birimlerinin sayısı.
Dizin metrikleri
Dizin yazma hızları, dizin dağıtımını anlamak için document/write_ops_count metriğiyle karşılaştırılabilir.
index/write_count: Dizin yazma sayısı.
TTL Metrikleri
MongoDB uyumluluğu metrikleriyle Cloud Firestore'un TTL metrikleri, uygulanan TTL politikasının etkisini izlemek için kullanılır.
document/ttl_deletion_count: TTL<0x0A>hizmetleri tarafından silinen toplam belge sayısı.document/ttl_expiration_to_deletion_delays: Geçerlilik süresi (TTL) sona eren bir dokümanın silinmesi ile gerçekten silinmesi arasında geçen süre.
Önceden tanımlanmış kontrol panellerini görüntüleme ve özel kontrol panelleri oluşturma
MongoDB uyumlu Cloud Firestore, Cloud Monitoring metriklerini kullanan önceden tanımlanmış kontrol panellerini destekler. Özel kontrol panelleri de oluşturabilirsiniz.
Veritabanı kullanım metriklerini görüntüleme
Zaman içindeki doküman okuma, yazma ve silme işlemlerini görüntülemek için Google Cloud Console'da kullanım kontrol panellerini açın.
Erişim denetimi
Kullanım kontrol panelleri için monitoring.timeSeries.list Kimlik ve Erişim Yönetimi (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
MongoDB uyumluluğu olan bir Cloud Firestore veritabanının kullanım metriklerini görüntülemek için aşağıdakileri yapı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.
Kullanım kontrol paneli ve fatura raporları
Konsoldaki Cloud Firestore kullanım kontrol panelleri, kullanım tahmini sağlar. Kullanımdaki artışları belirlemenize yardımcı olabilirler. Ancak kontrol paneli, faturalandırılan işlemlerin tam görünümü değildir. Faturalandırılan kullanımın daha yüksek olması muhtemeldir. Faturalandırmayı izlemek için faturalandırma metrikleri başlıklı makaleyi inceleyin.
Tüm tutarsızlık durumlarında, faturalandırma raporu kullanım kontrol panelinden önceliklidir.
İçe ve dışa aktarma işlemleri, kullanım kontrol paneli ile faturalandırılan kullanım arasında tutarsızlıklara neden olur. Bu işlemler tarafından gerçekleştirilen okuma ve yazma işlemleri, kullanım kontrol panelinde gösterilmez.
Veritabanı performans metriklerini görüntüleme
Google Cloud Console'un Cloud Firestore bölümündeki İzleme sayfasında İstek gecikmeleri (P50 ve P99), Yanıt kodları ve Sorgu istatistikleri (P50) gibi önceden tanımlanmış izleme kontrol panelleri bulunur. Ayrıca en fazla bir özel kontrol paneli oluşturabilirsiniz. Bir veritabanının izleme sayfasına erişmek için aşağıdaki adımları uygulayın:
Google Cloud Console'da Cloud Firestore Veritabanları sayfasını açın.
Listeden bir veritabanı seçin.
Bir kontrol paneli açmak için gezinme menüsünde Monitoring'i (İzleme) tıklayın.
Özel Cloud Monitoring kontrol panelleri oluşturma
Cloud Monitoring, özel kontrol panelleri, sizin için alakalı olan bilgileri düzenli bir şekilde görüntülemenize olanak tanır. Örneğin, üretim ortamınızdaki projenizin performans metriklerini ve uyarı politikalarını görüntülemek için bir kontrol paneli oluşturabilirsiniz.
Özel kontrol paneli oluşturma hakkında daha fazla bilgi için Özel kontrol panelini yönetme ve Kontrol paneli widget'ları ekleme başlıklı makaleleri inceleyin.
Uyarı politikası oluşturma
Cloud Monitoring içinde, bir metrik koşulunda değişiklik olduğunda sizi bilgilendirecek uyarılar oluşturabilirsiniz. Bu uyarıları, potansiyel sorunlar kullanıcılarınızı etkilemeden önce bildirim almak için kullanabilirsiniz.
Uyarı oluşturma hakkında daha fazla bilgi için Metrik eşiği uyarı politikaları oluşturma başlıklı makaleyi inceleyin.
Gecikme uyarı politikası oluşturduğumuz aşağıdaki örneği inceleyelim. Uyarı politikası, 5 dakikalık hareketli bir zaman aralığında %99 gecikmeyi kontrol eder. Gecikmenin 99. yüzdelik dilimi 5 dakika boyunca 250 ms'den yüksek kalırsa uyarı tetiklenir.
Konsol
Google Cloud Console'da İzleme sayfasına gidin ve notifications Uyarılar'ı seçin.
Politika oluştur'u seçin.
Tüketilen API kaynağında İstek Gecikmeleri metriğini seçin.
Cloud Firestore standart veritabanları için
firestore.googleapis.comhizmet filtresi ekleyin.Tetikleyiciyi yapılandırmak için Sonraki'yi tıklayın.
Koşul Türleri'ni Eşik olarak seçin.
Eşik koşulu, 250 ms eşik değerine ayarlanır. P99 gecikme değeri, hareketli pencerenin (5 dakika) tamamı boyunca aynı kaldığında uyarı tetiklenir.
Eşik değerini 250 olarak ayarlayın.
Bildirimleri yapılandırmak için Sonraki'yi tıklayın.
Uyarı politikası adını ayarlayın ve Sonraki'yi tıklayın.
Uyarı yapılandırmalarını inceleyin ve Politika Oluştur'u tıklayın.
MQL (use in paranthesis next to TR long form in the first instance)
Aynı gecikme uyarı politikasını bir izleme sorgu dili (MQL) sorgusu kullanarak uygulayabilirsiniz. MQL kullanımına dair daha fazla örnek için Örnek MQL sorguları bölümüne bakın.
fetch consumed_api
| metric 'serviceruntime.googleapis.com/api/request_latencies'
| filter (resource.service == 'firestore.googleapis.com')
| group_by 5m,
[value_request_latencies_percentile:
percentile(value.request_latencies, 99)]
| every 5m
| condition val() > 0.25 's'