Benutzerdefinierte Benachrichtigungen einrichten und an benutzerdefinierte Benachrichtigungskanäle senden

Firebase bietet standardmäßige Crashlytics-Benachrichtigungen (siehe Übersichtsseite zu Benachrichtigungen). Diese Standardbenachrichtigungen und ihre Benachrichtigungskanäle reichen jedoch möglicherweise nicht für Ihre Anforderungen aus.

In diesen Fällen können Sie Cloud Monitoring verwenden, um benutzerdefinierte Benachrichtigungen an benutzerdefinierte Benachrichtigungskanäle basierend auf Crashlytics-Daten (und optional Firebase-Sitzungsdaten) zu senden, die Sie in Cloud Logging exportiert haben.

Wenn Sie Cloud Monitoring für benutzerdefinierte Benachrichtigungen verwenden möchten, richten Sie eine Benachrichtigungsrichtlinie ein, in der die Umstände beschrieben werden, unter denen Sie benachrichtigt werden möchten und wie Sie benachrichtigt werden möchten.

Wenn die Rate ohne Abstürze beispielsweise unter einen bestimmten Schwellenwert sinkt, kann Cloud Monitoring eine benutzerdefinierte Benachrichtigung an eine bestimmte E-Mail-Adresse senden oder sie in einem Drittanbieterdienst wie Discord, Slack oder Jira posten. Sie können die im Hinweis gesendeten Informationen auch vollständig anpassen, z. B. hilfreiche Deeplinks zur Firebase-Konsole oder unternehmensspezifische Informationen zur Fehlerbehebung einfügen.

In der Google Cloud-Dokumentation finden Sie weitere Informationen zu Cloud Monitoring und Benachrichtigungen, einschließlich Preisen.

Vorbereitung

1. Ihr Firebase-Projekt muss den Blaze-Tarif (Pay as you go) verwenden.

2. Export von Crashlytics-Daten und (optional) Firebase-Sitzungsdaten nach Cloud Logging einrichten

3. Benachrichtigungskanäle einrichten

Benachrichtigungsrichtlinie einrichten

Im Folgenden finden Sie eine allgemeine Anleitung. Eine detaillierte Anleitung finden Sie in der Google Cloud-Dokumentation, z. B. unter Benachrichtigungsrichtlinien mit Messwertschwellen erstellen oder PromQL zum Erstellen von Benachrichtigungsrichtlinien verwenden.

Im Rahmen der Ausführung von Abfragen können Sie entweder eine logbasierte oder eine SQL-basierte Benachrichtigung einrichten:

• Logbasierte Benachrichtigung einrichten:

  1. Führen Sie eine Abfrage in Logs Explorer aus.

  2. Klicken Sie auf die Schaltfläche Benachrichtigung hinzufügen.

  3. Folgen Sie der Anleitung auf dem Bildschirm, um eine logbasierte Benachrichtigung hinzuzufügen.

• SQL-basierte Benachrichtigung einrichten:

  1. Führen Sie eine Abfrage in Loganalysen aus.

  2. Klicken Sie auf die Schaltfläche Benachrichtigung hinzufügen.

  3. Folgen Sie der Anleitung auf dem Bildschirm, um einen SQL-basierten Alert hinzuzufügen.

Alternativ können Sie Benachrichtigungen für Ihre logbasierten Messwerte über das Tool zur Richtlinienkonfiguration in der Google Cloud-Konsole einrichten. Dort haben Sie folgende Möglichkeiten:

• Builder: Die Console-Benutzeroberfläche bietet einen geführten Workflow zum Erstellen der Benachrichtigungsrichtlinie.

• PromQL: Sie geben eine PromQL-Abfrage für Ihre Benachrichtigungsrichtlinie an.

  Beispiel für PromQL-Abfrage

  Angenommen, Sie haben zwei logbasierte Messwerte für Ihre exportierten Crashlytics- und Firebase-Sitzungsdaten erstellt:

  • Ein Messwert namens firebase/crashlytics_events mit dem Label errorType, der so definiert ist:

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

  • Ein weiterer Messwert namens firebase/session_events mit dem Label eventType wird so definiert:

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

  Hier ist ein Beispiel für eine PromQL-Abfrage, mit der Sie mithilfe dieser logbasierten Messwerte eine Benachrichtigung erhalten, wenn die Absturzfreiheit unter 70 % sinkt:

  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