Firebase kann verschiedene Standardbenachrichtigungen für Crashlytics senden (siehe Übersichtsseite zu Benachrichtigungen). Firebase bietet grundlegende Benachrichtigungsintegrationen, mit denen die Standardbenachrichtigungen Crashlytics an Slack, Jira und PagerDuty gesendet werden können.
So richten Sie diese Integrationen in der Firebase-Konsole ein und konfigurieren sie:
Folgen Sie dem geführten Workflow für jeden Dienst auf dem Tab Einbindungen in den
Projekteinstellungen .Wählen Sie aus, welche Konfiguration für einzelne Apps verwendet wird, und konfigurieren Sie das Ziel anderer Benachrichtigungen auf der Karte Crashlytics auf dem Tab Benachrichtigungen in den
Projekteinstellungen .
Im Rest dieses Dokuments wird detailliert beschrieben, wie Sie die einzelnen grundlegenden Benachrichtigungsintegrationen einrichten.
Slack: Integration mit Slack einrichten
Nachdem Sie die Firebase-Integration mit Slack eingerichtet haben, kann Ihr Projekt als Reaktion auf Ereignisse, die von Crashlytics gemeldet werden, in Ihrem Slack-Workspace posten, z. B. bei neuen, bereits behobenen oder sich schnell häufenden Problemen.
Schritt 1: Slack-Webhook einrichten
Bevor Sie die Integration in Firebase einrichten, müssen Sie in Slack einen eingehenden Webhook hinzufügen, um die Kommunikation von Firebase zu verarbeiten.
Weitere Informationen dazu finden Sie in der Slack-Dokumentation unter Nachrichten mit eingehenden Webhooks senden.
Schritt 2: Slack-Integration in der Firebase-Konsole einrichten
Nachdem Sie den entsprechenden Webhook eingerichtet haben, können Sie die Integration für Crashlytics einrichten:
Melden Sie sich in der Firebase Console an und wählen Sie Ihr Projekt aus.
Klicken Sie auf und wählen Sie Projekteinstellungen aus.
Wählen Sie den Tab Integrationen aus.
Klicken Sie auf der Karte für die Slack-Integration auf Installieren.
Richten Sie die Integration ein, indem Sie Werte in den folgenden Feldern festlegen:
Webhook URL (Webhook-URL): Fügen Sie die Webhook-URL von der Seite mit den Slack-Einstellungen ein.
Standardchannel: Geben Sie einen Channelnamen ein. Sie können diese Standardeinstellung später pro App oder pro Benachrichtigung überschreiben.
Name des Nutzers, der die Beiträge verfasst: Geben Sie einen Namen ein, unter dem die Nachrichten gesendet werden sollen.
Klicken Sie auf Bestätigen und speichern.
Nachdem Sie die Slack-Integration bestätigt und gespeichert haben, sollte im ausgewählten Standardkanal eine Bestätigungsmeldung angezeigt werden.
Schritt 3: Benachrichtigungseinstellungen für Slack konfigurieren
Sie können Benachrichtigungen nach App und Ereignistyp konfigurieren. Sie können beispielsweise Benachrichtigungen in Ihrer Test-App deaktivieren oder Benachrichtigungen mit hoher Priorität in Ihrer Produktions-App an einen #urgent-Kanal weiterleiten.
Ereignistypen
Durch die Firebase-Integration mit Slack können Sie Benachrichtigungen als Reaktion auf die folgenden Ereignistypen senden:
Neue schwerwiegende Probleme: Wird ausgelöst, wenn in Ihrer App ein Absturz oder ANR-Fehler auftritt, den es bislang in Crashlytics noch nicht gab.
Neue nicht schwerwiegende Probleme: Wird ausgelöst, wenn in Ihrer App ein nicht schwerwiegendes Problem Crashlytics auftritt, das es bislang in Crashlytics noch nicht gab.
Regressed issues (Wieder aufgetretene Probleme): werden ausgelöst, wenn in Ihrer App ein Absturz auftritt, den Sie zuvor als behoben markiert haben.
Aktuelle Probleme: Werden ausgelöst, wenn ein Problem neu oder häufiger auftritt.
Probleme mit zunehmender Geschwindigkeit: Werden ausgelöst, wenn ein einzelner Absturz- oder ANR-Typ innerhalb von 30 Minuten bei einem bestimmten Prozentsatz der Nutzer einer bestimmten App-Version auftritt.
Einstellungen für jede App konfigurieren
So konfigurieren Sie Benachrichtigungen für jede App in Ihrem Firebase-Projekt:
Melden Sie sich in der Firebase Console an und wählen Sie Ihr Projekt aus.
Klicken Sie auf und wählen Sie Projekteinstellungen aus.
Wählen Sie den Tab Benachrichtigungen aus.
Rufen Sie die Karte mit den Crashlytics-Benachrichtigungen auf. Wählen Sie im Drop-down-Menü die App aus, die Sie konfigurieren möchten.
Wählen Sie den Slack-Kanal aus, an den Sie Benachrichtigungen für diese App senden möchten.
Wählen Sie für jeden Benachrichtigungstyp im Drop-down-Menü aus, ob Sie diesen Benachrichtigungstyp an Slack senden möchten.
Wiederholen Sie diese Schritte für jede App, die Sie konfigurieren möchten.
Geschafft! Firebase sendet Benachrichtigungen an die von Ihnen angegebenen Slack-Kanäle, wenn in Ihren Apps neue oder bereits behobene Probleme auftreten oder die Geschwindigkeitsprobleme zunehmen.
Jira: Integration mit Jira einrichten
Nachdem Sie die Firebase-Integration mit Jira eingerichtet haben, kann Ihr Firebase-Projekt als Reaktion auf von Crashlytics gemeldete Ereignisse in ein Jira-Projekt posten, z. B. bei neuen, zurückgegangenen oder sich schnell entwickelnden Problemen. Sie können auch einzelne Crashlytics-Probleme mit Jira-Vorgängen verknüpfen.
Schritt 1: Jira für die Integration mit Firebase vorbereiten
API-Token erstellen (nur Jira Cloud)
Bevor Sie die Integration in Firebase einrichten können, müssen Sie in Jira Cloud ein API-Token generieren.
Öffnen Sie in der Jira-Konsole die API-Token-Einstellungen.
Klicken Sie auf API-Token erstellen.
Speichern Sie dieses API-Token an einem sicheren Ort, da Sie es später benötigen.
Fehler-Vorgangstyp erstellen
Bei der Firebase-Integration mit Jira werden Probleme vom Typ Bug erstellt. Sie müssen diesen Vorgangstyp in Ihrem Jira-Projekt erstellen, falls er noch nicht vorhanden ist.
Rufen Sie in der Jira-Konsole die Projekteinstellungen auf.
Klicken Sie auf Probleme.
Klicken Sie auf Problemtyp hinzufügen.
Wählen Sie „Fehler“ aus oder geben Sie es manuell ein.
Schritt 2: Jira-Integration in der Firebase-Konsole einrichten
Richten Sie die Jira-Integration für Jira Cloud oder für Jira Server ein.
Jira Cloud
Melden Sie sich in der Firebase Console an und wählen Sie Ihr Projekt aus.
Klicken Sie auf und wählen Sie Projekteinstellungen aus.
Wählen Sie den Tab Integrationen aus.
Klicken Sie auf der Integrationskarte Jira auf Installieren.
Klicken Sie auf Jira-Integration einrichten.
Geben Sie die URL Ihres Jira-Projekts im folgenden Format ein:
https://WORKSPACE_NAME.atlassian.net/projects/PROJECT_KEYGeben Sie Ihre Jira-Anmelde-E-Mail-Adresse und Ihr API-Token ein.
Klicken Sie auf Bestätigen und speichern.
Jira Server
Melden Sie sich in der Firebase Console an und wählen Sie Ihr Projekt aus.
Klicken Sie auf und wählen Sie Projekteinstellungen aus.
Wählen Sie den Tab Integrationen aus.
Klicken Sie auf der Integrationskarte Jira auf Installieren.
Klicken Sie auf Jira-Integration einrichten.
Geben Sie die URL Ihres Jira-Projekts im folgenden Format ein:
https://SERVER_NAME.com/projects/PROJECT_KEYGeben Sie Ihre Jira-Anmelde-E-Mail-Adresse und Ihr API-Token ein.
Klicken Sie auf Bestätigen und speichern.
Schritt 3: Benachrichtigungseinstellungen für Jira konfigurieren
Sie können Benachrichtigungen nach App und Ereignistyp konfigurieren. Sie können beispielsweise Benachrichtigungen in Ihrer Test-App deaktivieren oder Benachrichtigungen zu verschiedenen Apps an verschiedene Jira-Projekte weiterleiten.
Ereignistypen
Mit der Firebase-Integration in Jira können Sie Benachrichtigungen als Reaktion auf die folgenden Ereignistypen senden:
Neue schwerwiegende Probleme: Wird ausgelöst, wenn in Ihrer App ein Absturz oder ANR-Fehler auftritt, den es bislang in Crashlytics noch nicht gab.
Neue nicht schwerwiegende Probleme: Wird ausgelöst, wenn in Ihrer App ein nicht schwerwiegendes Problem Crashlytics auftritt, das es bislang in Crashlytics noch nicht gab.
Regressed issues (Wieder aufgetretene Probleme): werden ausgelöst, wenn in Ihrer App ein Absturz auftritt, den Sie zuvor als behoben markiert haben.
Aktuelle Probleme: Werden ausgelöst, wenn ein Problem neu oder häufiger auftritt.
Probleme mit zunehmender Geschwindigkeit: Werden ausgelöst, wenn ein einzelner Absturz- oder ANR-Typ innerhalb von 30 Minuten bei einem bestimmten Prozentsatz der Nutzer einer bestimmten App-Version auftritt.
Einstellungen für jede App konfigurieren
So konfigurieren Sie Benachrichtigungen für jede App in Ihrem Firebase-Projekt:
Melden Sie sich in der Firebase Console an und wählen Sie Ihr Projekt aus.
Klicken Sie auf und wählen Sie Projekteinstellungen aus.
Wählen Sie den Tab Benachrichtigungen aus.
Rufen Sie die Karte mit den Crashlytics-Benachrichtigungen auf. Wählen Sie im Drop-down-Menü die App aus, die Sie konfigurieren möchten.
Wählen Sie das Jira-Projekt aus, in dem Sie Benachrichtigungen für diese App erhalten möchten.
Wählen Sie für jeden Benachrichtigungstyp im Drop-down-Menü aus, ob Sie diesen Benachrichtigungstyp an Jira senden möchten.
Wiederholen Sie diese Schritte für jede App, die Sie konfigurieren möchten.
Geschafft! Firebase sendet Benachrichtigungen an die von Ihnen angegebenen Jira-Projekte, wenn in Ihren Apps neue oder bereits behobene Probleme auftreten oder die Geschwindigkeit von Problemen zunimmt.
(Optional) Crashlytics-Vorgänge und Jira-Vorgänge verknüpfen
Zusätzlich zu den automatisch erstellten Jira-Problemen, die von Firebase erstellt werden, können Sie Ihre Crashlytics-Probleme mit vorhandenen Jira-Problemen verknüpfen. Sie können auch über die Firebase-Konsole einen neuen Jira-Vorgang erstellen. Sie müssen die Jira-Integration aktivieren, bevor Sie diese Funktion verwenden können.
Rufen Sie das Crashlytics-Problem auf, das Sie mit einem Jira-Problem verknüpfen möchten.
Klicken Sie auf Mit Jira verknüpfen.
Klicken Sie entweder auf Vorgang im Projekt erstellen oder fügen Sie die URL oder den Vorgangsschlüssel des Jira-Vorgangs in das dafür vorgesehene Feld ein.
Verknüpfung eines Crashlytics-Problems mit einem Jira-Vorgang aufheben
Rufen Sie das Crashlytics-Problem auf, dessen Verknüpfung mit Jira Sie aufheben möchten.
Klicken Sie auf Verknüpftes Problem.
Klicken Sie auf Mehr und wählen Sie Verknüpfung aufheben aus.
PagerDuty: Integration mit PagerDuty einrichten
Nachdem Sie die Firebase-Integration mit PagerDuty eingerichtet haben, kann PagerDuty über Ihr Firebase-Projekt Bereitschaftsdienstmitarbeiter als Reaktion auf von Crashlytics gemeldete Ereignisse benachrichtigen, z. B. bei neuen, bereits behobenen oder sich schnell entwickelnden Problemen.
Schritt 1: PagerDuty-Integration in der Firebase-Konsole einrichten
Melden Sie sich in der Firebase Console an und wählen Sie Ihr Projekt aus.
Klicken Sie auf und wählen Sie Projekteinstellungen aus.
Wählen Sie den Tab Integrationen aus.
Klicken Sie auf der Integrationskarte PagerDuty auf Installieren.
Folgen Sie der Anleitung auf dem Bildschirm, um die Integration einzurichten.
Klicken Sie auf Bestätigen und speichern.
Schritt 2: Benachrichtigungseinstellungen für PagerDuty konfigurieren
Sie können Benachrichtigungen nach App und Ereignistyp konfigurieren. Sie können beispielsweise Benachrichtigungen in Ihrer Test-App deaktivieren oder Benachrichtigungen zu verschiedenen Apps an unterschiedliche PagerDuty-Projekte weiterleiten.
Ereignistypen
Durch die Firebase-Integration mit PagerDuty können Sie Benachrichtigungen als Reaktion auf die folgenden Ereignistypen senden:
Neue schwerwiegende Probleme: Wird ausgelöst, wenn in Ihrer App ein Absturz oder ANR-Fehler auftritt, den es bislang in Crashlytics noch nicht gab.
Neue nicht schwerwiegende Probleme: Wird ausgelöst, wenn in Ihrer App ein nicht schwerwiegendes Problem Crashlytics auftritt, das es bislang in Crashlytics noch nicht gab.
Regressed issues (Wieder aufgetretene Probleme): werden ausgelöst, wenn in Ihrer App ein Absturz auftritt, den Sie zuvor als behoben markiert haben.
Aktuelle Probleme: Werden ausgelöst, wenn ein Problem neu oder häufiger auftritt.
Probleme mit zunehmender Geschwindigkeit: Werden ausgelöst, wenn ein einzelner Absturz- oder ANR-Typ innerhalb von 30 Minuten bei einem bestimmten Prozentsatz der Nutzer einer bestimmten App-Version auftritt.
Einstellungen für jede App konfigurieren
So konfigurieren Sie Benachrichtigungen für jede App in Ihrem Firebase-Projekt:
Melden Sie sich in der Firebase Console an und wählen Sie Ihr Projekt aus.
Klicken Sie auf und wählen Sie Projekteinstellungen aus.
Wählen Sie den Tab Benachrichtigungen aus.
Rufen Sie die Karte mit den Crashlytics-Benachrichtigungen auf. Wählen Sie im Drop-down-Menü die App aus, die Sie konfigurieren möchten.
Wählen Sie den PagerDuty-Dienst aus, an den Sie Benachrichtigungen für diese App senden möchten.
Wählen Sie für jeden Benachrichtigungstyp im Drop-down-Menü aus, ob Sie diesen Benachrichtigungstyp an PagerDuty senden möchten.
Wiederholen Sie diese Schritte für jede App, die Sie konfigurieren möchten.
Geschafft! Firebase sendet Fehler an den von Ihnen angegebenen PagerDuty-Dienst, wenn in Ihren Apps neue, bereits behobene oder sich schnell entwickelnde Probleme auftreten.