Veritabanı metriklerini izleme

Bu sayfada, veritabanınızı izlemek için Cloud Firestore'de Cloud Monitoring metriklerinin nasıl kullanılacağı açıklanmaktadır.

Cloud Monitoring metrik için Cloud Firestore

Aşağıdaki bölümlerde, 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 kontrol paneli 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'si kullanılarak, Cloud Firestore performansı aşağıdaki kaynakla izlenir:

Metrikler

Cloud Firestore ile ilgili metriklerin tam listesi için Cloud Firestore metrikleri başlıklı makaleyi inceleyin. Aşağıdaki bölümde, kullanılabilen metriklerden bazıları açıklanmaktadır.

Hizmet çalışma zamanı metrikleri

serviceruntime metrikleri, bir projenin trafiğiyle ilgili üst düzey genel bakış bilgileri sunar. Bu metrikler çoğu Google Cloud API'sinde 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, çağrılan temel 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 belgelerine bakın.

api/request_latencies

api/request_latencies metriği, tamamlanan tüm isteklerdeki gecikme dağılımlarını sağlar.

Cloud Firestore, Cloud Firestore Hizmeti bileşeninden metrikleri kaydeder. Gecikme metrikleri, depolama katmanıyla etkileşimler de dahil olmak üzere Cloud Firestore'nın isteği aldığı andan Cloud Firestoreyanıtı göndermeyi bitirdiği ana kadar geçen süreyi içerir. 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.

Aşağıdaki metrikler, 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 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 işlemlerinin 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_realtime_read_units: Anlık güncellemelerden elde edilen faturalandırılabilir anlık güncelleme birimlerinin sayısı. Bu yalnızca yerel modda Cloud Firestore için geçerlidir.
• 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 elde edilen faturalandırılabilir yazma birimi sayısı.

Dizin metrikleri

Dizin yayılımını anlamak için dizin yazma hızları document/write_ops_count metriğiyle karşılaştırılabilir.

• index/write_count: Dizin yazma sayısı.

TTL Metrikleri

Cloud Firestore metriklerinin TTL metrikleri, zorunlu kılınan 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: TTL'si 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

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.listIdentity and Access Management (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 aşağıdakileri yapın.

1. Google Cloud Console'da Veritabanları sayfasına gidin.

   Veritabanları'na gidin

2. Veritabanları listesinden gerekli veritabanını seçin.

3. 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 ani 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, fatura 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:

1. Google Cloud Console'da Cloud Firestore Veritabanları sayfasını açın.

   Veritabanları'na gidin

2. Listeden bir veritabanı seçin.

3. 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 sayesinde sizin için önemli 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 bölümünde, bir metrik koşulunda değişiklik olduğunda sizi bilgilendirecek uyarılar oluşturabilirsiniz. Bu uyarıları, olası 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 inceleyin. Uyarı politikası, 5 dakikalık hareketli bir aralıkta p99 gecikmesini kontrol eder. Gecikme, 5 dakika boyunca 250 ms'den yüksek kalırsa uyarı tetiklenir.

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'