Firebase bietet grundlegende Benachrichtigungsintegrationen, mit denen Crashlytics-Benachrichtigungen 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 dieser Seite wird detailliert beschrieben, wie Sie die einzelnen grundlegenden Benachrichtigungsintegrationen einrichten.
Einfache Integration mit Slack einrichten
Nachdem Sie die Firebase-Integration mit Slack eingerichtet haben, kann Ihr Projekt als Reaktion auf von Crashlytics gemeldete Ereignisse in Ihrem Slack-Workspace posten, z. B. bei neuen, bereits behobenen oder sich schnell entwickelnden 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 Integrationskarte Slack 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 Standardchannel 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-Channel weiterleiten.
Ereignistypen
Durch die Firebase-Integration in 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.
Häufig auftretende Probleme: Wird 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 diese Art von Benachrichtigung 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.
Basisintegration mit Jira einrichten
Nachdem Sie die Firebase-Integration mit Jira eingerichtet haben, kann Ihr Firebase-Projekt als Reaktion auf von Crashlytics gemeldete Ereignisse, z. B. neue, zurückgegangene oder sich schnell entwickelnde Probleme, in einem Jira-Projekt posten. 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.
Fehlerbericht 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 Console die Projekteinstellungen auf.
Klicken Sie auf Problemtypen.
Klicken Sie auf Problemtyp hinzufügen.
Wählen Sie „Fehler“ aus oder geben Sie den Begriff 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
Durch die Firebase-Integration mit 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.
Häufig auftretende Probleme: Wird 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-Probleme und Jira-Vorgänge verknüpfen
Zusätzlich zu den automatisch erstellten Jira-Vorgängen, die von Firebase erstellt werden, können Sie Ihre Crashlytics-Probleme mit vorhandenen Jira-Vorgängen 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 aufgehoben werden soll.
Klicken Sie auf Verknüpftes Problem.
Klicken Sie auf Mehr und wählen Sie Verknüpfung aufheben aus.
Einfache Integration in PagerDuty einrichten
Nachdem Sie die Firebase-Integration mit PagerDuty eingerichtet haben, kann PagerDuty über Ihr Firebase-Projekt Ihre 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
Mit der Firebase-Integration in 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.
Häufig auftretende Probleme: Wird 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 häufende Probleme auftreten.