Özel uyarıları ayarlama ve özel bildirim kanallarına gönderme

Firebase, varsayılan Crashlytics uyarıları sunar (uyarıya genel bakış sayfasına bakın). Ancak bu varsayılan uyarılar ve bildirim kanalları ihtiyaçlarınız için yeterli olmayabilir.

Bu gibi durumlarda, Cloud Logging'teki Crashlytics verilerine göre özel bildirim kanallarına özel uyarılar göndermek için Cloud Monitoring kullanabilirsiniz. Bu veriler, web uygulamaları için otomatik olarak firebase-telemetry paketine yönlendirilir veya mobil uygulamalar için Cloud Logging'e aktarılır (isteğe bağlı Firebase oturum verileriyle birlikte).

Özel uyarılar için Cloud Monitoring hizmetini kullanmak istiyorsanız hangi durumlarda ve nasıl uyarılmak istediğinizi açıklayan bir uyarı politikası oluşturmanız gerekir.

Örneğin, kilitlenme sorunu yaşamayan kullanıcıların oranı belirli bir eşiğin altına düşerse veya web uygulamanızın hata oranı ani bir artış gösterirse Cloud Monitoring, belirli bir e-posta adresine özelleştirilmiş bir uyarı mesajı gönderebilir veya bu mesajı Discord, Slack, PagerDuty ya da Jira gibi üçüncü taraf hizmetlerinde yayınlayabilir. Ayrıca, uyarıda gönderilen bilgileri tamamen özelleştirebilirsiniz. Örneğin, Firebase konsoluna faydalı derin bağlantılar veya şirkete özel sorun giderme bilgileri ekleyebilirsiniz.

Google Cloud belgelerinde, fiyatlandırma dahil olmak üzere Cloud Monitoring ve uyarılar hakkında daha fazla bilgi edinebilirsiniz.

Ön koşullar

1. Firebase projenizin kullandıkça öde Blaze fiyatlandırma planında olduğundan emin olun.

2. Crashlytics günlüklerinizin Cloud Logging içinde bulunduğundan emin olun:

   • Mobil uygulamalar için: Crashlytics verilerinin ve (isteğe bağlı olarak) Firebase oturum verilerinin Cloud Logging platformuna aktarılmasını ayarlayın.
   • Web uygulamaları için: Web uygulamanızda Crashlytics ayarını yaptığınızda günlükler otomatik olarak firebase-telemetry paketine (firebasetelemetry.googleapis.com/events) gönderilir.

3. Bildirim kanalları oluşturun.

Uyarı politikası oluşturma

Aşağıda üst düzey talimatlar verilmiştir. Ayrıntılı talimatlar için Google Cloud belgelerine bakın (örneğin: Metrik eşiği uyarı politikaları oluşturma veya Uyarı politikaları oluşturmak için PromQL kullanma).

Sorgu çalıştırma kapsamında, günlüğe dayalı bir uyarı veya SQL tabanlı bir uyarı ayarlayabilirsiniz:

• Günlüğe dayalı uyarı oluşturma:

  1. Logs Explorer içinde sorgu çalıştırma

  2. Gösterilen Uyarı ekle düğmesini tıklayın.

  3. Günlüğe dayalı uyarı eklemek için ekrandaki talimatları uygulayın.

• SQL tabanlı uyarı oluşturma:

  1. Günlük Analizi'nde sorgu çalıştırma

  2. Gösterilen Uyarı ekle düğmesini tıklayın.

  3. SQL tabanlı uyarı eklemek için ekrandaki talimatları uygulayın.

Alternatif olarak, Google Cloud konsolundaki politika yapılandırma aracını kullanarak günlüğe dayalı metrikleriniz için uyarılar ayarlayabilirsiniz. Bu araçta aşağıdaki seçeneklerden birini belirleyebilirsiniz:

• Oluşturucu: Konsol kullanıcı arayüzü, uyarı politikasını oluşturmak için adım adım açıklamalı bir iş akışı sunar.

  Örnek: Web uygulaması hata artışlarıyla ilgili uyarı

  Web uygulamaları için firebase-telemetry Cloud Logging paketinde günlüğe dayalı bir sayaç metriği oluşturabilir ve Oluşturucu'yu kullanarak bir eşik uyarısı yapılandırabilirsiniz:

  1. Google Cloud konsolunda Günlük Kaydı > Günlüğe Dayalı Metrikler'e gidin ve Metrik Oluştur'u tıklayın.
  2. Metrik türü olarak Sayaç'ı seçin ve metriğinizi adlandırın (ör. web_crashlytics_errors).

  3. Filtre oluştur kutusuna, gelen web hatası kayıtlarını saymak için aşağıdaki LQL sorgusunu girin:

     logName="projects/PROJECT_ID/logs/firebasetelemetry.googleapis.com%2Fevents"
     severity=ERROR
     

  4. Metrik Oluştur'u tıklayın.

  5. Yeni oluşturulan metriğin İşlemler menüsünden (üç dikey nokta) Metrikten uyarı oluştur'u seçin.

  6. Kayan pencere (ör. 5 min) ve Kayan pencere işlevi (rate veya count) ayarlarını yapın, koşul türü olarak Eşik değerin üzerinde'yi seçin ve bildirim kanallarınızı (ör. e-posta, Slack, PagerDuty veya webhook'lar) belirleyin.

• PromQL: Uyarı politikanız için bir PromQL sorgusu sağlarsınız.

  Örnek PromQL sorgusu

  Örneğin, dışa aktarılan Crashlytics ve Firebase oturum verileriniz için iki günlük tabanlı metrik oluşturduğunuzu varsayalım:

  • firebase/crashlytics_events adlı bir metrik, errorType etiketine sahip ve şu şekilde tanımlanıyor:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"

  • firebase/session_events adlı başka bir metrik, eventType etiketine sahip ve şu şekilde tanımlanmış:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fsession_events"

  Kilitlenme yaşanmayan oturum oranınız %70'in altına düştüğünde uyarı göndermek için bu günlüğe dayalı metrikleri kullanan örnek bir PromQL sorgusu:

  1 - (sum by (project_id) (rate({__name__="logging.googleapis.com/user/firebase/crashlytics_events", errorType="FATAL"}[5m])) /
  sum by (project_id) (rate({__name__="logging.googleapis.com/user/firebase/session_events", eventType="SESSION_START"}[5m]))
  ) < 0.7