Benachrichtigungen bei Leistungsproblemen einrichten

Mit Performance Monitoring-Benachrichtigungen können Sie Projektmitglieder informieren, wenn Codeänderungen oder Netzwerkanfragen die Leistung Ihrer App beeinträchtigen.

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

Was löst eine Benachrichtigung aus?

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

App-Startzeit

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

  • In der letzten Stunde wurden in Firebase mindestens 100 Stichproben des _app_start-Traces für die neueste Version Ihrer App erfasst.
  • Die Dauer des _app_start-Traces hat in der letzten Stunde und für den konfigurierten Prozentsatz den für die App festgelegten Grenzwert überschritten.
  • Für denselben Grenzwert wurde in der letzten Version Ihrer App noch keine Benachrichtigung ausgegeben.

Traces mit benutzerdefiniertem Code

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

  • In der letzten Stunde wurden in Firebase mindestens 100 Beispiele der benutzerdefinierten Code-Spur für die neueste Version Ihrer App erfasst.
  • Die Dauer des Tracings hat in der letzten Stunde und für den konfigurierten Prozentsatz den für die App festgelegten Grenzwert überschritten.
  • (Nur für iOS und Android) In der neuesten Version Ihrer App wurde für denselben Grenzwert noch keine Benachrichtigung ausgegeben.
  • (Nur Web) In den letzten 3 Tagen gab es keine Benachrichtigung für denselben Grenzwert.

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:

  • In der letzten Stunde wurden in Firebase mindestens 100 Proben erfasst, die mit dem URL-Muster in allen Versionen Ihrer App übereinstimmten.
  • Der zusammengefasste Wert des Messwerts hat in der letzten Stunde den festgelegten Grenzwert überschritten:
    • Antwortzeit: Der aggregierte Wert hat den festgelegten Grenzwert für den konfigurierten Prozentsatz überschritten.
    • Erfolgsquote: (nur für iOS + Android) Der aggregierte Wert ist für alle Nutzer unter den festgelegten Grenzwert gesunken.
  • In den letzten 3 Tagen wurde für denselben Grenzwert keine Benachrichtigung ausgegeben.

Bildschirm-Rendering

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

  • In der letzten Stunde wurden in Firebase mindestens 100 Proben für das Bildschirm-Rendering der aktuellen Version Ihrer App erfasst.
  • Der zusammengefasste Wert des Messwerts hat in der letzten Stunde den definierten Grenzwert überschritten:
    • Eingefrorene Frames: Der aggregierte Wert hat den festgelegten Grenzwert überschritten.
    • Langsame Frames: Der aggregierte Wert hat den festgelegten Grenzwert überschritten.
  • In der neuesten Version Ihrer App wurde für denselben Grenzwert noch keine Benachrichtigung ausgegeben.

Seitenaufbauvorgänge

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

  • In der letzten Stunde wurden in Firebase mindestens 100 Stichproben für das Laden der Seite Ihrer App erfasst.
  • Der aggregierte Wert des Messwerts hat in der letzten Stunde und für den konfigurierten Prozentsatz den definierten Grenzwert überschritten:
    • First Input Delay: Der zusammengefasste Wert hat den festgelegten Grenzwert und den konfigurierten Prozentrang überschritten.
    • First Contentful Paint: Der aggregierte Wert hat den festgelegten Grenzwert und den konfigurierten Prozentrang überschritten.
    • First Paint: Der aggregierte Wert hat den festgelegten Grenzwert und den konfigurierten Prozentrang überschritten.
  • In den letzten 3 Tagen wurde für denselben Grenzwert keine Benachrichtigung ausgegeben.

Weitere Informationen finden Sie unter Benachrichtigungen konfigurieren, Standardprozentilen und Best Practices für die Einrichtung von Benachrichtigungen für bestimmte Arten von Protokollen und Messwerten.

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

Benachrichtigungen erhalten

Standardbenachrichtigungen erhalten

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

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

Benachrichtigungen und ihre Einstellungen sind 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 Gruppen von Konten wie Google-Gruppen oder Google Workspace-Konten).

Benachrichtigungen für Ihr eigenes Konto aktivieren/deaktivieren

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

So aktivieren oder deaktivieren Sie Performance Monitoring-Benachrichtigungen:

  1. Klicken Sie in der Firebase Console oben rechts auf Firebase-Benachrichtigungen.
  2. Rufe dann Einstellungen auf und lege deine Kontoeinstellungen für Performance Monitoring-Benachrichtigungen fest.

Erweiterte Benachrichtigungen für Drittanbieterdienste einrichten

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

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

  1. Cloud Functions für Firebase einrichten, einschließlich der 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. Erstellen und bereitstellen einer Funktion, die ein Benachrichtigungsereignis von Performance Monitoring erfasst und die Ereignisnutzlast verarbeitet (z. B. die Benachrichtigungsinformationen in einer Nachricht in Discord postet).

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

Automatisches Entfernen ungültiger Benachrichtigungen

Performance Monitoring prüft Benachrichtigungen, um sicherzustellen, dass die Daten gültig sind und dass 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 in den letzten 90 Tagen Daten vom Typ Performance Monitoring empfangen wurden.
  • 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 von 90 Tagen keine Daten gesendet werden, wird diese Benachrichtigung von Performance Monitoring entfernt. Weitere Informationen zu benutzerdefinierten URL-Mustern finden Sie unter Daten nach benutzerdefinierten URL-Mustern aggregieren.

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

Benachrichtigung konfigurieren

Zum Konfigurieren von Performance Monitoring-Benachrichtigungen benötigen Sie die Berechtigung firebaseperformance.config.update. Die folgenden Rollen umfassen diese erforderliche Berechtigung standardmäßig: Firebase-Leistungsadministrator, Firebase-Qualitätsadministrator, Firebase-Administrator und Projektinhaber oder ‑bearbeiter.

Fügen Sie Ihrer App das aktuelle Performance Monitoring SDK hinzu, falls Sie dies noch nicht getan haben. Weitere Informationen finden Sie in den Leitfäden für die Plattformen Web, Android, Apple und Flutter.

Konfigurieren Sie in jeder Ihrer registrierten Apps in der Tabelle „Traces“ oder auf der Karte „Dashboard-Bericht“ eine Benachrichtigung für jeden Messwert, den Sie beobachten möchten. Für jede App können unterschiedliche Warnungen mit jeweils einem anderen Grenzwert festgelegt werden (oder es können auch gar keine Warnungen festgelegt werden).

Benachrichtigung in der Tabelle „Traces“ konfigurieren

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

  2. Scrollen Sie unten auf dem Bildschirm zur Tabelle „Traces“ (Spuren).

  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 Benachrichtigungsgrenzwert und den Prozentrang (falls zutreffend) für die App festzulegen oder die Benachrichtigung zu aktivieren oder zu deaktivieren. Die Standardperzentile sind das 90. Perzentil für Android und iOS und das 75. Perzentil für das Web. Weitere Informationen zu den Standardprozentilen finden Sie unter Wichtige Messwerte in Ihrem Dashboard erfassen.

Benachrichtigung in der Dashboard-Berichtskarte konfigurieren

  1. Rufen Sie in der Firebase-Konsole den Tab Performance Monitoring Dashboard auf und wählen Sie 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 auf der gewünschten Messwertkarte das Dreipunkt-Menü  und wählen Sie Benachrichtigungseinstellungen aus.

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

Best Practices für die Einrichtung einer Leistungsbenachrichtigung

Netzwerkanfragen

Firebase fasst die Daten aus ähnlichen Netzwerkanfragen in URL-Mustern zusammen. Dabei kann es sich um eines der folgenden Muster handeln:

  • Benutzerdefinierte Muster, die benutzerdefinierte URL-Muster genannt werden.

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

Benachrichtigungen für benutzerdefinierte URL-Muster einrichten

Wir empfehlen, Benachrichtigungen für alle von Ihnen konfigurierten benutzerdefinierten URL-Muster einzurichten. Da Firebase zuerst versucht, eine Anfrage mit einem benutzerdefinierten URL-Muster abzugleichen, werden ähnliche Anfragen einheitlicher 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 eingestuft 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 seit einigen Tagen 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 für Sie wichtigen Muster führen. Sie können auch ein benutzerdefiniertes URL-Muster erstellen, um dafür zu sorgen, dass dieses Muster stabil ist.

Webseite wird geladen

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

Bildschirmdarstellungen

Für eine optimale App-Nutzung sollten Nutzersitzungen keine langsamen und eingefrorenen Frames enthalten. Performance Monitoring empfiehlt, Benachrichtigungen für mehr als 1% eingefrorene Frames und für mehr als 5 % langsame Frames 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.