Geschwindigkeitswarnungen anpassen

Mit Geschwindigkeitswarnungen können Sie Ihr Team benachrichtigen, wenn ein einzelnes Problem einen schwerwiegenden Fehler in Ihrer App verursacht. Bei Crashlytics ist ein Problem eine Gruppierung ähnlicher Abstürze oder ANR-Ereignisse (Application Not Responding, Anwendung reagiert nicht).

Wann wird eine Benachrichtigung ausgelöst?

Geschwindigkeitswarnungen werden ausgelöst, wenn ein Problem in Ihrer App bestimmte Grenzwerte überschreitet, die Sie in der Firebase-Konsole konfigurieren.

Sie definieren den Grenzwert für Geschwindigkeitswarnungen als Prozentsatz der Nutzer und die Mindestanzahl der Nutzer, die vom Absturz oder ANR-Fehler betroffen waren. Sie können den prozentualen Grenzwert zwischen 0% und 100% der Sitzungen festlegen. Der Mindestschwellenwert für Nutzer kann auf eine beliebige Zahl größer oder gleich 10 festgelegt werden. Der Standard-Schwellenwert für Geschwindigkeitsbenachrichtigungen liegt bei 1% der Sitzungen und 25 Nutzern.

Eine Warnung wird ausgelöst, wenn innerhalb eines Zeitraums von 30 Minuten alle der folgenden Bedingungen erfüllt sind:

  • Ein Problem in einer App überschreitet den definierten Prozentsatz und die für diese App festgelegte Mindestanzahl an Nutzern.
  • Die App hat in diesem Zeitraum mindestens 10 Nutzer.
  • Für das Problem in der App wurde in dieser Version zuvor keine Warnung ausgegeben.

Schwellenwerte für Geschwindigkeitswarnungen konfigurieren

Zum Konfigurieren von Schwellenwerten für Geschwindigkeitswarnungen benötigen Sie die Berechtigung firebasecrashlytics.config.update. Die folgende Rolle enthält diese erforderliche Berechtigung standardmäßig: Firebase Crashlytics-Administrator, Firebase Quality-Administrator, Firebase-Administrator oder Projektinhaber oder -bearbeiter.

Konfigurieren Sie für jede Ihrer registrierten Apps Schwellenwerte für Geschwindigkeitsbenachrichtigungen. Für jede App kann ein anderer Benachrichtigungsschwellenwert festgelegt werden.

  1. Melden Sie sich in der Firebase-Console an und wählen Sie Ihr Projekt aus.

  2. Klicken Sie auf  und wählen Sie Projekteinstellungen aus. Wählen Sie den Tab Benachrichtigungen aus.

  3. Rufen Sie die Karte Crashlytics – Benachrichtigungen auf und wählen Sie den Tab Geschwindigkeitsbenachrichtigungen aus.

  4. Konfigurieren Sie die Benachrichtigungsgrenzwerte für die App.

Benachrichtigungen erhalten

Standardbenachrichtigungen erhalten

Standardmäßig kann Firebase Crashlytics-Benachrichtigungen per E-Mail senden. Bei Geschwindigkeitswarnungen und ‑regressionen können diese Warnungen auch in der Firebase-Konsole angezeigt werden.

Damit Sie Crashlytics-Benachrichtigungen über diesen Standardmechanismus erhalten, benötigen Sie die Berechtigung firebase.projects.update. Die folgenden Rollen enthalten diese erforderliche Berechtigung standardmäßig: Firebase-Administrator oder Projektinhaber oder -bearbeiter.

Standardmäßig erhält jedes Projektmitglied (mit den erforderlichen Berechtigungen zum Empfangen von Benachrichtigungen) eine E-Mail, wenn eine Benachrichtigung von Crashlytics ausgelöst wird.

Benachrichtigungen für Ihr eigenes Konto aktivieren oder deaktivieren

Für Ihr eigenes Konto können Sie Crashlytics-Benachrichtigungen aktivieren oder deaktivieren, ohne dass sich dies auf andere Projektmitglieder auswirkt. Sie benötigen weiterhin die erforderlichen Berechtigungen, um Benachrichtigungen zu erhalten.

  1. Melden Sie sich in der Firebase-Console an und wählen Sie Ihr Projekt aus.

  2. Klicken Sie auf  und wählen Sie Projekteinstellungen aus. Wählen Sie den Tab Benachrichtigungen aus.

  3. Rufen Sie die Karte Crashlytics – Benachrichtigungen auf und wählen Sie den Tab Geschwindigkeitsbenachrichtigungen aus.

  4. Legen Sie Ihre Kontoeinstellungen für Crashlytics-Benachrichtigungen fest.

Einfache Benachrichtigungen für Drittanbieterdienste einrichten

Für Crashlytics-Benachrichtigungen bietet Firebase einen Mechanismus zum Senden von Benachrichtigungen an die folgenden Drittanbieterdienste: Slack, Jira oder PagerDuty.

  1. Richten Sie diese grundlegenden Benachrichtigungsoptionen über geführte Workflows auf dem Tab Integrationen in den Projekteinstellungen ein.

  2. 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 Ihren Projekteinstellungen.

Wenn Sie mehr Kontrolle und Anpassungsmöglichkeiten für das Senden von Benachrichtigungen an einen beliebigen Drittanbieterdienst (nicht nur Slack, Jira oder PagerDuty) benötigen, lesen Sie den Abschnitt Erweiterte Benachrichtigungen für Drittanbieterdienste einrichten, in dem erweiterte Benachrichtigungsoptionen beschrieben werden.

Erweiterte Benachrichtigungen für Drittanbieterdienste einrichten

Mit Cloud Functions for Firebase können Sie Crashlytics-Benachrichtigungen an den bevorzugten Benachrichtigungskanal Ihres Teams 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 die an den Drittanbieterdienst gesendeten Informationen vollständig anpassen. Sie können beispielsweise hilfreiche Deeplinks zur Firebase-Konsole oder unternehmensspezifische Informationen zur Fehlerbehebung hinzufügen.

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

  1. Cloud Functions for Firebase einrichten. 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 zu Crashlytics-Benachrichtigungen.