Benachrichtigungen bei Leistungsproblemen einrichten

Mit Performance Monitoring-Benachrichtigungen können Sie Projektmitglieder benachrichtigen, wenn sich die Leistung Ihrer App durch Codeänderungen oder Netzwerkanfragen verschlechtert.

Sie können Benachrichtigungen für Ihre App einrichten und anpassen, um benachrichtigt zu werden, wenn die Leistung eines Ereignisses einen festgelegten Grenzwert überschreitet.

Wann wird eine Benachrichtigung ausgelöst?

Eine Benachrichtigung wird ausgelöst, wenn ein Messwert für Ihre App einen Grenzwert überschreitet, den Sie für ein bestimmtes Perzentil (falls zutreffend) in der Firebase Console definieren. Benachrichtigungen werden nur ausgelöst, wenn in Ihrer App eine echtzeitkompatible SDK-Version verwendet wird.

App-Startzeit

Wenn Sie eine Benachrichtigung für die App-Startzeit konfigurieren, wird sie ausgelöst, wenn alle folgenden Bedingungen erfüllt sind:

  • Firebase hat in der letzten Stunde mindestens 100 Proben des _app_start-Traces für die aktuelle Version Ihrer App erfasst.
  • Die Dauer des _app_start-Traces hat in der letzten Stunde und für das konfigurierte Perzentil den für die App definierten Grenzwert überschritten.
  • Für denselben Grenzwert wurde in der aktuellen Version Ihrer App noch keine Benachrichtigung ausgelöst.

Traces für benutzerdefinierten Code

Wenn Sie eine Benachrichtigung für einen benutzerdefinierten Messwert für den Code-Trace konfigurieren, wird die Benachrichtigung ausgelöst, wenn alle folgenden Bedingungen erfüllt sind:

  • Firebase hat in der letzten Stunde mindestens 100 Stichproben des benutzerdefinierten Code-Traces für die aktuelle Version Ihrer App erfasst.
  • Die Dauer des Traces hat in der letzten Stunde und für das konfigurierte Perzentil den für die App definierten Schwellenwert überschritten.
  • (Nur für iOS+ und Android) Für denselben Grenzwert wurde in der aktuellen Version Ihrer App bisher keine Benachrichtigung ausgegeben.
  • (Nur für das Web) In den letzten 3 Tagen wurde keine Warnung für denselben Grenzwert ausgegeben.

Netzwerkanfragen

Wenn Sie eine Benachrichtigung für eine Messwert für Netzwerkanfragen konfigurieren, wird die Benachrichtigung ausgelöst, wenn alle folgenden Bedingungen erfüllt sind:

  • Firebase hat in der letzten Stunde mindestens 100 Proben erfasst, die mit dem URL-Muster für alle Versionen Ihrer App übereinstimmen.
  • Der aggregierte Wert des Messwerts hat den definierten Grenzwert in der letzten Stunde überschritten:
    • Reaktionszeit: Der aggregierte Wert hat den festgelegten Schwellenwert für das konfigurierte Perzentil überschritten.
    • Erfolgsrate: (nur für iOS+/Android) Der aggregierte Wert ist für alle Nutzer unter den festgelegten Schwellenwert gesunken.
  • In den letzten 3 Tagen wurde für denselben Grenzwert keine Benachrichtigung ausgelöst.

Bildschirm-Rendering

Wenn Sie eine Benachrichtigung für eine Messwert für das Rendern von Bildschirmen konfigurieren, wird die Benachrichtigung ausgelöst, wenn alle folgenden Bedingungen erfüllt sind:

  • Firebase hat in der letzten Stunde mindestens 100 Proben für das Rendern von Bildschirmen für die aktuelle Version Ihrer App erfasst.
  • Der aggregierte Wert des Messwerts hat den definierten Grenzwert in der letzten Stunde überschritten:
    • Eingefrorene Frames: Der aggregierte Wert hat den festgelegten Grenzwert überschritten.
    • Langsame Frames: Der aggregierte Wert hat den festgelegten Grenzwert überschritten.
  • Für denselben Grenzwert wurde in der aktuellen Version Ihrer App noch keine Benachrichtigung ausgelöst.

Seitenaufrufe

Wenn Sie eine Benachrichtigung für einen Messwert für das Laden von Seiten konfigurieren, wird die Benachrichtigung ausgelöst, wenn alle folgenden Bedingungen erfüllt sind:

  • Firebase hat in der letzten Stunde mindestens 100 Proben für das Laden der Seite für Ihre App erfasst.
  • Der aggregierte Wert des Messwerts hat den definierten Grenzwert in der letzten Stunde und für das konfigurierte Perzentil überschritten:
    • First Input Delay: Der aggregierte Wert hat den festgelegten Grenzwert und das konfigurierte Perzentil überschritten.
    • First Contentful Paint: Der aggregierte Wert hat den festgelegten Grenzwert und das konfigurierte Perzentil überschritten.
    • First Paint: Der aggregierte Wert hat den festgelegten Grenzwert und das konfigurierte Perzentil überschritten.
  • In den letzten 3 Tagen wurde für denselben Grenzwert keine Benachrichtigung ausgelöst.

Weitere Informationen zum Konfigurieren von Benachrichtigungen, Standardprozentilen und Best Practices für das Einrichten von Benachrichtigungen für bestimmte Arten von Traces und Messwerten

Benachrichtigungen für andere Leistungsmesswerte oder für integrierte Firebase-Integrationen mit Slack, Jira und PagerDuty sind für Performance Monitoring-Benachrichtigungen nicht verfügbar.

Benachrichtigungen erhalten

Standardbenachrichtigungen erhalten

Standardmäßig kann Firebase Performance Monitoring-Benachrichtigungen per E-Mail senden.

Damit Sie Performance Monitoring-Benachrichtigungen über diesen Standardmechanismus erhalten, benötigen Sie die Berechtigung firebaseperformance.config.update. Die folgenden Rollen enthalten diese erforderliche Berechtigung standardmäßig:

Benachrichtigungen und ihre Einstellungen gelten für das gesamte Projekt. Das bedeutet, dass standardmäßig jedes Projektmitglied eine E-Mail erhält, wenn eine Leistungsbenachrichtigung ausgelöst wird. Benachrichtigungen werden nur an Projektmitglieder mit den erforderlichen Berechtigungen zum Empfangen von Benachrichtigungen und an einzelne E‑Mail-Adressen gesendet, nicht an Gruppen von Konten wie Google-Gruppen oder Google Workspace-Konten.

Benachrichtigungen für das eigene Konto aktivieren/deaktivieren

Sie können Performance Monitoring-Benachrichtigungen für Ihr eigenes Konto aktivieren oder deaktivieren, ohne andere Projektmitglieder zu beeinträchtigen. Sie benötigen weiterhin die erforderlichen Berechtigungen, um Benachrichtigungen zu erhalten.

So aktivieren oder deaktivieren Sie Performance Monitoring-Benachrichtigungen:

  1. Rufen Sie in der FirebaseConsole rechts oben Firebase-Benachrichtigungen auf.
  2. Gehen Sie dann zu den Einstellungen und legen Sie Ihre Kontoeinstellung für Performance Monitoring-Benachrichtigungen fest.

Erweiterte Benachrichtigungen für Drittanbieterdienste einrichten

Mit Cloud Functions for Firebase können Sie auch Performance Monitoring-Benachrichtigungen an den bevorzugten Benachrichtigungskanal Ihres Teams senden. Sie können beispielsweise eine Funktion schreiben, die ein Benachrichtigungsereignis für eine langsame App-Startzeit erfasst und die Benachrichtigungsinformationen an einen Drittanbieterdienst wie Discord, Slack oder Jira sendet.

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 Performance Monitoring erfasst und die Ereignisnutzlast verarbeitet (z. B. die Benachrichtigungsinformationen in einer Nachricht auf Discord postet).

Informationen zu allen Ereignissen für Leistungsbenachrichtigungen, die Sie erfassen können, finden Sie in der Referenzdokumentation zu Leistungsbenachrichtigungen.

Automatisches Entfernen ungültiger Warnungen

Performance Monitoring validiert Benachrichtigungen, um sicherzustellen, dass die Daten gültig sind und die Benachrichtigungen aktiv verwendet werden. Benachrichtigungen gelten als gültig, wenn eine der folgenden Bedingungen zutrifft:

  • Die Benachrichtigung wird für eine Ressourcen-ID erstellt, für die Performance Monitoring in den letzten 90 Tagen Daten empfangen hat.
  • Die Benachrichtigung wurde vor Kurzem für ein benutzerdefiniertes URL-Muster erstellt. Nachdem Sie ein benutzerdefiniertes URL-Muster erstellt und eine Benachrichtigung eingerichtet haben, haben Sie 90 Tage Zeit, Daten für dieses Muster zu senden. Wenn innerhalb des 90‑Tage-Zeitraums keine Daten gesendet werden, wird die Benachrichtigung von Performance Monitoring entfernt. Weitere Informationen zu benutzerdefinierten URL-Mustern finden Sie unter Daten unter benutzerdefinierten URL-Mustern aggregieren.

Wenn eine dieser Bedingungen nicht erfüllt ist, wird die Benachrichtigung von Performance Monitoring entfernt.

Benachrichtigung konfigurieren

Zum Konfigurieren von Performance Monitoring-Benachrichtigungen benötigen Sie die Berechtigung firebaseperformance.config.update. Die folgende Rolle enthält diese erforderliche Berechtigung standardmäßig: Firebase Performance-Administrator, Firebase-Qualitätsadministrator, Firebase-Administrator, und Projektinhaber oder -bearbeiter.

Wenn Sie es noch nicht getan haben, fügen Sie Ihrer App das aktuelle Performance Monitoring SDK hinzu. Weitere Informationen finden Sie in den Anleitungen für die Web-, Android-, Apple- und Flutter-Plattformen.

Konfigurieren Sie in jeder Ihrer registrierten Apps mithilfe der Traces table (Tabelle mit Traces) oder der Dashboard report card (Berichtskarte im Dashboard) einen Alert für jeden Messwert, den Sie beobachten möchten. Jede App kann unterschiedliche Warnungen mit unterschiedlichen Grenzwerten haben oder auch gar keine Warnungen.

Benachrichtigung in der Tabelle „Traces“ konfigurieren

  1. Rufen Sie in der Firebase-Konsole den Tab Performance Monitoring Dashboard auf und wählen Sie dann die App aus, für die Sie eine Benachrichtigung konfigurieren möchten.

  2. Scrollen Sie zum unteren Bildschirmrand zur Tabelle „Traces“.

  3. Wählen Sie den Tab des Tracetyp aus, für den Sie eine Benachrichtigung einrichten möchten, und suchen Sie dann die entsprechende Zeile.

  4. Öffnen Sie ganz rechts in der Zeile das Dreipunkt-Menü  und wählen Sie Benachrichtigungseinstellungen aus.

  5. Folgen Sie der Anleitung auf dem Bildschirm, um den Benachrichtigungsschwellenwert und das Perzentil (falls zutreffend) für die App festzulegen oder die Benachrichtigung zu aktivieren bzw. zu deaktivieren. Die Standardperzentile sind das 90. Perzentil für Android und iOS und das 75. Perzentil für Web. Weitere Informationen zu Standardprozentilen finden Sie unter Wichtige Messwerte in Ihrem Dashboard im Blick behalten.

Benachrichtigung in der Dashboard-Berichtskarte konfigurieren

  1. Rufen Sie in der Firebase-Konsole den Tab Performance Monitoring Dashboard auf und wählen Sie dann die App aus, für die Sie eine Benachrichtigung konfigurieren möchten.

  2. Suchen Sie auf dem Tab „Berichtskarte“ die Messwertkarte, für die Sie eine Benachrichtigung konfigurieren möchten.

  3. Öffnen Sie in der gewünschten Messwertkarte das Dreipunkt-Menü () und wählen Sie Benachrichtigungseinstellungen aus.

  4. Folgen Sie der Anleitung auf dem Bildschirm, um den Benachrichtigungsschwellenwert und das Perzentil (falls zutreffend) für die App festzulegen oder die Benachrichtigung zu aktivieren bzw. zu deaktivieren. Die Standardperzentile sind das 90. Perzentil für Android und iOS und das 75. Perzentil für Web. Weitere Informationen zu Standardprozentilen finden Sie unter Wichtige Messwerte in Ihrem Dashboard im Blick behalten.

Best Practices für das Einrichten von Leistungsbenachrichtigungen

Netzwerkanfragen

Firebase fasst die Daten aus ähnlichen Netzwerkanfragen unter URL-Mustern zusammen, die Folgendes sein können:

  • Benutzerdefinierte Muster, die als benutzerdefinierte URL-Muster bezeichnet werden.

  • Von Firebase abgeleitete Muster, die als automatische URL-Muster bezeichnet werden.
    Diese Muster können sich im Laufe der Zeit ändern, je nachdem, wie Ihre App zuletzt verwendet wurde.

Warnungen für benutzerdefinierte URL-Muster einrichten

Wir empfehlen, Benachrichtigungen für alle benutzerdefinierten URL-Muster einzurichten, die Sie konfiguriert haben. Da Firebase zuerst versucht, eine Anfrage einem benutzerdefinierten URL-Muster zuzuordnen, werden ähnliche Anfragen konsistenter demselben URL-Muster zugeordnet. So sind Benachrichtigungen für ein benutzerdefiniertes URL-Muster für Ihr Team aussagekräftiger und effektiver, da Sie dieses bestimmte Anfragemuster bereits als wichtig für Ihre App identifiziert haben.

Benachrichtigungen für automatische URL-Muster einrichten

Wenn Sie einen Alert für ein automatisches URL-Muster einrichten, sollte das automatische URL-Muster einige Tage lang stabil sein. Automatische URL-Muster können sich im Laufe der Zeit ändern. Außerdem werden Benachrichtigungskonfigurationen nicht auf neue URL-Muster übertragen. Das kann dazu führen, dass Sie für die Muster, die für Sie wichtig sind, falsche oder keine Benachrichtigungen erhalten. Sie können auch ein benutzerdefiniertes URL-Muster erstellen, um sicherzustellen, dass dieses Muster stabil ist.

Webseite wird geladen

Empfohlene Grenzwerte für die Messung von Webmesswerten finden Sie in der Dokumentation zu Core Web Vitals.

Bildschirm-Renderings

Für eine optimale App-Nutzung sollten Nutzersitzungen keine langsamen oder eingefrorenen Frames enthalten. Performance Monitoring empfiehlt, Benachrichtigungen für eingefrorene Frames mit einem Anteil von mehr als 1% und für langsame Frames mit einem Anteil von mehr als 5 % einzurichten. Diese Werte sind bei der Konfiguration von Leistungsbenachrichtigungen als Standardeinstellungen vorhanden. Weitere Informationen zu übermäßig langsamen oder eingefrorenen Frames und anderen Best Practices für die App-Leistung finden Sie in der Google Play-Anleitung.