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 zu senden, die auf Crashlytics-Daten in Cloud Logging basieren. Diese werden automatisch an den firebase-telemetry-Bucket für Web-Apps weitergeleitet oder für mobile Apps nach Cloud Logging exportiert (zusammen mit optionalen Firebase-Sitzungsdaten).

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

Wenn beispielsweise die Rate der Nutzer ohne Absturz unter einen bestimmten Schwellenwert fällt oder die Fehlerrate Ihrer Web-App stark ansteigt, kann Cloud Monitoring eine benutzerdefinierte Benachrichtigung an eine bestimmte E-Mail-Adresse senden oder sie in einem Drittanbieterdienst wie Discord, Slack, PagerDuty 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. Prüfen Sie, ob Ihre Crashlytics-Logs in Cloud Logging verfügbar sind:

   • Für mobile Apps: Richten Sie den Export von Crashlytics-Daten und (optional) Firebase-Sitzungsdaten nach Cloud Logging ein.
   • Für Web-Apps: Logs werden automatisch an den Bucket firebase-telemetry (firebasetelemetry.googleapis.com/events) gesendet, wenn Sie Crashlytics in Ihrer Web-App 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.

• So richten Sie eine SQL-basierte Benachrichtigung ein:

  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.

  Beispiel: Benachrichtigung bei Fehlerspitzen in Webanwendungen

  Für Webanwendungen können Sie einen logbasierten Zählermesswert für den Bucket firebase-telemetry Cloud Logging erstellen und mit dem Builder eine Schwellenwertbenachrichtigung konfigurieren:

  1. Rufen Sie in der Google Cloud-Konsole Logging > Logbasierte Messwerte auf und klicken Sie dann auf Messwert erstellen.
  2. Wählen Sie Zähler als Messwerttyp aus und benennen Sie den Messwert (z. B. web_crashlytics_errors).

  3. Geben Sie im Feld Filter erstellen die folgende LQL-Abfrage ein, um eingehende Webfehlerdatensätze zu zählen:

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

  4. Klicken Sie auf Messwert erstellen.

  5. Wählen Sie im Menü Aktionen (Dreipunkt-Menü) des neu erstellten Messwerts die Option Benachrichtigung mit dem Messwert erstellen aus.

  6. Legen Sie das rollierende Zeitfenster (z. B. 5 min) und die Funktion für rollierendes Zeitfenster (rate oder count) fest, wählen Sie Über Schwellenwert als Bedingungstyp aus und wählen Sie Ihre Benachrichtigungskanäle (z. B. E-Mail, Slack, PagerDuty oder Webhooks) aus.

• 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 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, 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