Benachrichtigungen bei Leistungsproblemen einrichten

Verwenden Sie Performance Monitoring-Benachrichtigungen, um Projektmitglieder zu informieren, wenn Codeänderungen oder Netzwerkanfragen die Leistung Ihrer App beeinträchtigen.

Sie können benutzerdefinierte Benachrichtigungen für Ihre App einrichten und anpassen, die Sie informieren, wenn die Leistung eines Ereignisses einen festgelegten Schwellenwert überschreitet.

Was löst eine Benachrichtigung aus?

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. Warnungen werden nur ausgelöst, wenn Ihre App eine mit Echtzeit kompatible SDK-Version verwendet.

Startzeit der App

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

  • Firebase hat in der letzten Stunde mindestens 100 Stichproben des Traces _app_start für die aktuelle Version Ihrer App aufgezeichnet.
  • Die Dauer des Traces „_app_start“ hat in der letzten Stunde und für das konfigurierte Perzentil den für die App definierten Grenzwert überschritten.
  • Für denselben Schwellenwert wurde in der neuesten Version Ihrer App zuvor keine Warnung ausgegeben.

benutzerdefinierte Code-Traces

Wenn Sie eine Benachrichtigung für einen benutzerdefinierten Code-Trace-Messwert 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-Trace für die aktuelle Version Ihrer App aufgezeichnet.
  • Die Dauer des Trace hat in der letzten Stunde und für das konfigurierte Perzentil den definierten Grenzwert der App überschritten.
  • (Nur für iOS+ und Android) Für denselben Schwellenwert wurde in der aktuellen Version Ihrer App zuvor keine Benachrichtigung ausgelöst.
  • (Nur für das Web) In den letzten 3 Tagen wurde keine Benachrichtigung für denselben Grenzwert ausgelöst.

Netzwerkanfragen

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

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

Bildschirm-Rendering

Wenn Sie eine Benachrichtigung für einen Messwert zum Bildschirm-Rendering konfigurieren, wird die Benachrichtigung ausgelöst, wenn alle der folgenden Bedingungen erfüllt sind:

  • Firebase hat in der letzten Stunde mindestens 100 Stichproben des Bildschirm-Renderings für die aktuelle Version Ihrer App aufgezeichnet.
  • Der aggregierte Wert des Messwerts hat den definierten Schwellenwert 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 Schwellenwert wurde in der neuesten Version Ihrer App zuvor keine Warnung ausgegeben.

Seitenaufbau

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

  • Firebase hat in der letzten Stunde mindestens 100 Stichproben des Seitenaufbaus für Ihre App aufgezeichnet.
  • Der aggregierte Wert des Messwerts hat den definierten Schwellenwert 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 Schwellenwert 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 keine Benachrichtigung für denselben Schwellenwert ausgelöst.

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

Benachrichtigungen für andere Leistungsmesswerte oder für in der Firebase Console konfigurierte Integrationen mit Slack, Jira oder 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 projektweit. 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 Gruppierungen von Konten wie Google-Gruppen oder Google Workspace-Konten).

Benachrichtigungen für Ihr eigenes Konto aktivieren/deaktivieren

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

So aktivieren oder deaktivieren Sie Performance Monitoring-Benachrichtigungen:

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

Erweiterte Benachrichtigungen für Drittanbieterdienste einrichten

Sie können Performance Monitoring-Benachrichtigungen auch über Cloud Functions for Firebase 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. Richten Sie Cloud Functions for Firebase ein. 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 Leistungsbenachrichtigungsereignissen, die Sie erfassen können, finden Sie in der Referenzdokumentation zu Performance Monitoring-Benachrichtigungen.

Automatische Entfernung ungültiger Meldungen

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

  • Die Benachrichtigung wird für eine Ressourcen-ID erstellt, für die Performance Monitoring in den letzten 90 Tagen Daten erhalten 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, um Daten für dieses Muster zu senden. Wenn innerhalb des 90-tägigen Zeitraums keine Daten gesendet werden, wird die Benachrichtigung von Performance Monitoring entfernt. Weitere Informationen zu benutzerdefinierten URL-Mustern finden Sie unter Daten unter Kunden-URL-Mustern zusammenfassen.

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 folgenden Rollen enthalten diese erforderliche Berechtigung standardmäßig: Firebase Performance Admin, Firebase Quality Admin, Firebase Admin und Projektinhaber oder ‑bearbeiter.

Fügen Sie Ihrer App das neueste Performance Monitoring SDK hinzu, falls noch nicht geschehen. Weitere Informationen finden Sie in den Startleitfäden für die Plattformen Web, Android, Apple und Flutter.

Verwenden Sie in jeder Ihrer registrierten Apps die Tabelle „Traces“ oder die Dashboard-Berichtskarte, um eine Benachrichtigung für jeden Messwert zu konfigurieren, den Sie beobachten möchten. Für jede Anwendung kann ein anderer Satz von Benachrichtigungen mit jeweils einem anderen Schwellenwert festgelegt werden (oder gar keine Benachrichtigungen).

Benachrichtigung in der Tabelle „Traces“ konfigurieren

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

  2. Scrollen Sie nach unten zur Tabelle „Traces“ am unteren Bildschirmrand.

  3. Wählen Sie den Tab des Trace-Typs aus, für den Sie eine Benachrichtigung festlegen 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 Schwellenwert für die Benachrichtigung 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 das Web. Weitere Informationen zu Standardperzentilen finden Sie unter Wichtige Messwerte im 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 die Anwendung 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 auf der gewünschten Messwertkarte das Dreipunkt-Menü () und wählen Sie Benachrichtigungseinstellungen aus.

  4. Folgen Sie der Anleitung auf dem Bildschirm, um den Schwellenwert für die Benachrichtigung 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 das Web. Weitere Informationen zu Standardperzentilen finden Sie unter Wichtige Messwerte im Dashboard im Blick behalten.

Best Practices für das Einrichten von Leistungsbenachrichtigungen

Netzwerkanfragen

Firebase aggregiert die Daten aus ähnlichen Netzwerkanfragen unter URL-Mustern, 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 genutzt wurde.

Benachrichtigungen 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. Dadurch werden Benachrichtigungen für ein benutzerdefiniertes URL-Muster für Ihr Team aussagekräftiger und effektiver, da Sie dieses spezifische Anfragemuster bereits als wichtig für Ihre Anwendung identifiziert haben.

Benachrichtigungen für automatische URL-Muster einrichten

Wenn Sie eine Benachrichtigung für ein automatisches URL-Muster einrichten, achten Sie darauf, dass sich das automatische URL-Muster einige Tage lang stabilisiert hat. Beachten Sie, dass sich automatische URL-Muster im Laufe der Zeit ändern können und Benachrichtigungskonfigurationen nicht auf neue URL-Muster übertragen werden. Dies kann zu falschen oder fehlenden Benachrichtigungen für die Muster führen, die für Sie relevant sind. Sie können auch ein benutzerdefiniertes URL-Muster erstellen, um sicherzustellen, dass dieses Muster stabil ist.

Webseitenaufrufe

Informationen zu den empfohlenen Grenzwerten für die Messung von Webmesswerten finden Sie in der Dokumentation zu Core Web Vitals.

Bildschirm-Renderings

Für eine optimale Nutzerfreundlichkeit der App sollten Nutzersitzungen frei von langsamen und eingefrorenen Frames sein. Performance Monitoring empfiehlt, Benachrichtigungen für eingefrorene Frames von mehr als 1 % und für langsame Frames 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 findest du im Google Play-Leitfaden.