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 angepasste Benachrichtigungen an benutzerdefinierte Benachrichtigungskanäle senden. Die Benachrichtigungen basieren auf Crashlytics Daten und optional auf Firebase-Sitzungsdaten, die Sie in Cloud Logging exportiert haben.
Standard-CrashlyticsBenachrichtigungen an benutzerdefinierte Benachrichtigungskanäle senden

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

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

Firebase bietet Standard-Crashlytics Benachrichtigungen (siehe die Seite Übersicht über Benachrichtigungen). Diese Standardbenachrichtigungen und ihre Benachrichtigungskanäle sind jedoch möglicherweise nicht ausreichend für Ihre Anforderungen.

In diesen Fällen können Sie mit Cloud Monitoring benutzerdefinierte Benachrichtigungen an benutzerdefinierte Benachrichtigungskanäle senden. Die Benachrichtigungen basieren auf Crashlytics Daten und optional auf Firebase-Sitzungsdaten, die Sie in Cloud Logging exportiert haben.

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

Wenn beispielsweise die Absturzrate unter einen bestimmten Schwellenwert fällt, Cloud Monitoring kann eine benutzerdefinierte Benachrichtigung an eine bestimmte E-Mail Adresse senden oder sie in einem Drittanbieterdienst wie Discord, Slack oder Jira posten. Sie können auch die in der Benachrichtigung gesendeten Informationen vollständig anpassen, z. B. hilfreiche Deeplinks zur Firebase Console 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

Achten Sie darauf, dass Ihr Firebase-Projekt den Blaze-Tarif (Pay as you go) verwendet.
Richten Sie den Export von Crashlytics Daten und optional von Firebase-Sitzungsdaten nach Cloud Logging ein.
Richten Sie Benachrichtigungskanäle ein.

Benachrichtigungsrichtlinie einrichten

Im Folgenden finden Sie eine allgemeine Anleitung. Eine detaillierte Anleitung finden Sie in der Google Cloud Dokumentation (z. B.: 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 eine SQL-basierte Benachrichtigung hinzuzufügen.

Alternativ können Sie Benachrichtigungen für Ihre logbasierten Messwerte mit dem Tool zur Richtlinienkonfiguration in derGoogle CloudConsole einrichten. Dort haben Sie folgende Möglichkeiten:

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. Er ist so definiert:
  
  logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"
- Ein weiterer Messwert mit dem Namen firebase/session_events und dem Label eventType. Er ist so definiert:
  
  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 die Absturzrate 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
```

Standard-Crashlytics Benachrichtigungen an benutzerdefinierte Benachrichtigungskanäle senden

Firebase bietet Standard-Crashlytics Benachrichtigungen (siehe die Liste auf der Seite Übersicht über Benachrichtigungsoptionen). Die Informationen in diesen Standardbenachrichtigungen und ihre Benachrichtigungskanäle sind jedoch möglicherweise nicht ausreichend für Ihre Anforderungen.

In diesen Fällen können Sie mit Cloud Functions for Firebase diese Standard Crashlytics Benachrichtigungen an benutzerdefinierte Benachrichtigungskanäle senden. Sie können beispielsweise eine Funktion schreiben, die ein Benachrichtigungsereignis für Geschwindigkeitsbenachrichtigungen erfasst und die Benachrichtigungsinformationen in einem Drittanbieterdienst wie Discord, Slack oder Jira postet.

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

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

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 CLI und melden Sie sich an.
3. Initialisieren Sie Cloud Functions for Firebase mit der Firebase CLI.
Schreiben und stellen Sie eine Funktion bereit, die ein Benachrichtigungsereignis aus Crashlytics erfasst und die Ereignis nutzlast verarbeitet (z. B. die Benachrichtigungsinformationen in einer Nachricht auf Discord postet).

Alle Crashlytics Benachrichtigungsereignisse, die Sie erfassen können, finden Sie in der Referenzdokumentation zu Crashlytics Benachrichtigungen.

Weitere Informationen zum Verarbeiten von Crashlytics Benachrichtigungen mit Cloud Functions for Firebase