Erweiterte Benachrichtigungen für benutzerdefinierte Benachrichtigungskanäle einrichten

Firebase bietet zwei Optionen zum Konfigurieren von Benachrichtigungen und zum Senden an benutzerdefinierte Benachrichtigungskanäle.

• (Empfohlen) Benutzerdefinierte Benachrichtigungen einrichten und an benutzerdefinierte Benachrichtigungskanäle senden

  Mit Cloud Monitoring können Sie vollständig benutzerdefinierte Benachrichtigungen an benutzerdefinierte Benachrichtigungskanäle senden. Diese basieren auf Crashlytics-Daten und (optional) Firebase-Sitzungsdaten, die Sie nach Cloud Logging exportiert haben.

• Standardmäßige Crashlytics-Benachrichtigungen an benutzerdefinierte Benachrichtigungskanäle senden

  Mit Cloud Functions können Sie die Crashlytics-Standardbenachrichtigungen an benutzerdefinierte Benachrichtigungskanäle senden.

---

(Empfohlen) 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 mit Cloud Monitoring benutzerdefinierte Benachrichtigungen an benutzerdefinierte Benachrichtigungskanäle senden, die auf Crashlytics-Daten (und optional Firebase-Sitzungsdaten) basieren, die Sie nach Cloud Logging exportiert haben.

Wenn Sie Cloud Monitoring für benutzerdefinierte Benachrichtigungen verwenden möchten, richten Sie eine Benachrichtigungsrichtlinie ein. Darin wird beschrieben, unter welchen Umständen und wie Sie benachrichtigt werden möchten.

Wenn die Rate der Nutzer ohne Absturz beispielsweise unter einen bestimmten Schwellenwert fällt, 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 in der Benachrichtigung 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 der Preise.

Vorbereitung

1. Achten Sie darauf, dass für Ihr Firebase-Projekt das Blaze-Preismodell (Pay as you go) gilt.

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

3. Richten Sie Benachrichtigungskanäle ein.

Benachrichtigungsrichtlinie einrichten

Im Folgenden finden Sie eine allgemeine Anleitung. Eine ausführliche Anleitung finden Sie in der Dokumentation zu Google Cloud (z. B. Benachrichtigungsrichtlinien mit Messwertschwellen erstellen oder Benachrichtigungsrichtlinien mit PromQL erstellen).

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 den angezeigten Button 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 den angezeigten Button Benachrichtigung hinzufügen.

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

Alternativ können Sie Benachrichtigungen für Ihre logbasierten Messwerte mit dem Richtlinienkonfigurationstool in der Google Cloud Console einrichten. Dort können Sie eine der folgenden Optionen auswählen:

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

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

  Beispiel für eine PromQL-Abfrage

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

  • Ein Messwert mit dem Namen firebase/crashlytics_events und 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, der so definiert ist:

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

  Hier ist ein Beispiel für eine PromQL-Abfrage, die diese logbasierten Messwerte verwendet, um eine Benachrichtigung zu senden, wenn der Anteil der absturzfreien Sitzungen unter 70 % fällt:

  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

---

Standardmäßige Crashlytics-Benachrichtigungen an benutzerdefinierte Benachrichtigungskanäle senden

Firebase bietet standardmäßige Crashlytics-Benachrichtigungen (siehe Liste auf der Übersichtsseite zu Benachrichtigungsoptionen). Die Informationen in diesen Standardbenachrichtigungen und deren Benachrichtigungskanälen reichen jedoch möglicherweise nicht für Ihre Anforderungen aus.

In diesen Fällen können Sie Cloud Functions for Firebase verwenden, um diese Crashlytics-Standardbenachrichtigungen an benutzerdefinierte Benachrichtigungskanäle zu senden. Sie können beispielsweise eine Funktion schreiben, die ein Benachrichtigungsereignis für Geschwindigkeitswarnungen erfasst und die Benachrichtigungsinformationen an einen Drittanbieterdienst wie Discord, Slack oder Jira sendet.

Mit diesem erweiterten Benachrichtigungsmechanismus können Sie auch die Informationen anpassen, die an den Drittanbieterdienst gesendet werden. Zusätzlich zu den von Firebase bereitgestellten Standardinformationen können Sie beispielsweise hilfreiche Deeplinks in die Firebase-Konsole oder unternehmensspezifische Informationen zur Fehlerbehebung einfügen.

So richten Sie erweiterte Benachrichtigungsfunktionen mit Cloud Functions for Firebase ein:

1. Richten Sie Cloud Functions for Firebase ein. Dazu gehören die folgenden Aufgaben:

   1. Richten Sie eine Entwicklungsumgebung für Node.js oder Python ein.
   2. Installieren Sie die Firebase-Befehlszeile und melden Sie sich an.
   3. Initialisieren Sie Cloud Functions for Firebase mit der Firebase-Befehlszeile.

2. Schreiben und stellen Sie eine Funktion bereit, die ein Benachrichtigungsereignis von Crashlytics erfasst und die Ereignisnutzlast verarbeitet (z. B. die Benachrichtigungsinformationen in einer Nachricht auf Discord postet).

Informationen zu allen Crashlytics-Benachrichtigungsereignissen, die Sie erfassen können, finden Sie in der Referenzdokumentation für Crashlytics-Benachrichtigungen.

Crashlytics-Benachrichtigungen mit Cloud Functions for Firebase verarbeiten