Mit Performance Monitoring Benachrichtigungen können Sie Projektmitglieder benachrichtigen, wenn Codeänderungen oder Netzwerk anfragen 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 für ein bestimmtes Perzentil (falls zutreffend) in der Firebase Console definieren. Benachrichtigungen werden nur ausgelöst, wenn Ihre App eine mit Echtzeit kompatible 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:
- Firebase hat in der letzten Stunde mindestens
100 Stichproben des_app_startTraces für die neueste Version Ihrer App erfasst. - Die Dauer des
_app_start-Traces hat in der letzten Stunde und für das konfigurierte Perzentil den definierten Grenzwert der App überschritten. - Für denselben Grenzwert in der neuesten Version Ihrer App wurde zuvor keine Benachrichtigung ausgelöst.
Benutzerdefinierte Code-Traces
Wenn Sie eine Benachrichtigung für einen benutzerdefinierten Code-Trace-Messwert konfigurieren, wird sie 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 neueste Version Ihrer App erfasst. - Die Dauer des Traces 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 Grenzwert in der neuesten Version Ihrer App wurde zuvor keine Benachrichtigung ausgelöst.
- (Nur für das Web) Für denselben Grenzwert wurde in den letzten
drei Tagen keine Benachrichtigung ausgelöst.
Netzwerkanfragen
Wenn Sie eine Benachrichtigung für einen Messwert für Netzwerkanfragen konfigurieren, wird sie ausgelöst, wenn alle folgenden Bedingungen erfüllt sind:
- Firebase hat in der letzten Stunde mindestens
100 Stichproben erfasst, die über alle Versionen Ihrer App hinweg mit dem URL Muster übereinstimmen. - Der aggregierte Wert des Messwerts hat in der letzten Stunde den definierten Grenzwert überschritten:
- Antwortzeit: Der aggregierte Wert hat den festgelegten Grenzwert für das konfigurierte Perzentil überschritten.
- Erfolgsrate: (Nur für iOS+/Android) Der aggregierte Wert ist für alle Nutzer unter den festgelegten Grenzwert gefallen.
- Für denselben Grenzwert wurde in den letzten
drei Tagen keine Benachrichtigung ausgelöst.
Bildschirm-Rendering
Wenn Sie eine Benachrichtigung für einen Messwert für das Bildschirm-Rendering konfigurieren, wird sie ausgelöst, wenn alle folgenden Bedingungen erfüllt sind:
- Firebase hat in der letzten Stunde mindestens
100 Stichproben des Bildschirm Renderings für die neueste Version Ihrer App erfasst. - Der aggregierte 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.
- Für denselben Grenzwert in der neuesten Version Ihrer App wurde zuvor keine Benachrichtigung ausgelöst.
Seitenladevorgänge
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 Seitenladevorgangs für Ihre App erfasst. - Der aggregierte Wert des Messwerts hat in der letzten Stunde und für das konfigurierte Perzentil den definierten Grenzwert ü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.
- Für denselben Grenzwert wurde in den letzten
drei Tagen keine Benachrichtigung ausgelöst.
Weitere Informationen zum Konfigurieren von Benachrichtigungen, Standardperzentilen, 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 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.
Wenn Sie Performance Monitoring Benachrichtigungen über diesen Standardmechanismus erhalten möchten, benötigen Sie die
firebaseperformance.config.update Berechtigung. Die folgenden Rollen enthalten diese erforderliche Berechtigung standardmäßig:
- Firebase Performance-Administrator
- Firebase Quality-Administrator
- Firebase-Administrator
- Projektinhaber oder -bearbeiter
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 Ihr eigenes Konto aktivieren/deaktivieren
Für Ihr eigenes Konto können Sie Performance Monitoring Benachrichtigungen aktivieren oder deaktivieren, ohne dass sich dies auf andere Projektmitglieder auswirkt. Sie benötigen jedoch weiterhin die erforderlichen Berechtigungen, um Benachrichtigungen zu erhalten.
So aktivieren oder deaktivieren Sie -Benachrichtigungen:Performance Monitoring
- Rufen Sie in der Firebase Console rechts oben die
Firebase alerts auf. - Rufen Sie dann die
Einstellungen auf und legen Sie Ihre Kontoeinstellungen 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:
Richten Sie Cloud Functions for Firebase ein, dazu gehören die folgenden Aufgaben:
- Richten Sie eine Entwicklungsumgebung für Node.js oder Python ein.
- Installieren Sie die Firebase CLI und melden Sie sich an.
- Initialisieren Sie Cloud Functions for Firebase mit der Firebase CLI.
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 Performance Monitoring-Benachrichtigungen.
Ungültige Benachrichtigungen automatisch entfernen
Performance Monitoring validiert Benachrichtigungen, um sicherzustellen, dass die Daten gültig sind und die Benachrichtigungen in aktiv verwendet werden. Benachrichtigungen gelten als gültig, wenn eine der folgenden Bedingungen erfüllt ist:
- Die Benachrichtigung wurde für eine Ressourcen-ID erstellt, für die Performance Monitoring Daten in den letzten 90 Tagen 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, Daten für dieses Muster zu senden. Wenn innerhalb des 90-Tage-Zeitraums keine Daten gesendet werden, Performance Monitoring entfernt diese Benachrichtigung. Weitere Informationen zu benutzerdefinierten URL-Mustern finden Sie unter Daten unter benutzerdefinierten URL-Mustern zusammenfassen.
Wenn eine dieser Bedingungen nicht erfüllt ist, Performance Monitoring entfernt die Benachrichtigung.
Benachrichtigung konfigurieren
Zum Konfigurieren von Performance Monitoring Benachrichtigungen benötigen Sie die
firebaseperformance.config.update Berechtigung. Die folgenden Rollen enthalten diese
erforderliche Berechtigung standardmäßig:
Firebase Performance-Administrator,
Firebase Quality-Administrator,
Firebase-Administrator,
und ProjektInhaber oder -bearbeiter.
Fügen Sie Ihrer App das aktuelle Performance Monitoring SDK hinzu, falls noch nicht geschehen. Weitere Informationen finden Sie in den Leitfäden für die ersten Schritte für die Plattformen Web, Android, Apple und Flutter.
Konfigurieren Sie in jeder Ihrer registrierten Apps in der Tabelle „Traces “ oder auf der Berichtskarte des Dashboards eine Benachrichtigung für jeden Messwert, den Sie beobachten möchten. Jede App kann eine andere Reihe von Benachrichtigungen mit unterschiedlichen Grenzwerten haben oder auch gar keine Benachrichtigungen.
Benachrichtigung in der Tabelle „Traces“ konfigurieren
Rufen Sie in der Firebase Console den Performance Monitoring Dashboard Tab auf und wählen Sie dann die App aus, für die Sie eine Benachrichtigung konfigurieren möchten.
Scrollen Sie unten auf dem Bildschirm zur Tabelle „Traces“.
Wählen Sie den Tab des Trace-Typs aus, für den Sie eine Benachrichtigung einrichten möchten, und suchen Sie dann die entsprechende Zeile.
Öffnen Sie ganz rechts in der Zeile das Dreipunkt-Menü () und wählen Sie Benachrichtigungseinstellungen aus.
Folgen Sie der Anleitung auf dem Bildschirm, um den Benachrichtigungsgrenzwert 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 auf dem Dashboard im Blick behalten.
Benachrichtigung auf der Berichtskarte des Dashboards konfigurieren
Rufen Sie in der Firebase Console den Performance Monitoring Dashboard Tab auf und wählen Sie dann die App aus, für die Sie eine Benachrichtigung konfigurieren möchten.
Suchen Sie auf dem Tab „Berichtskarte“ die Messwertkarte, für die Sie eine Benachrichtigung konfigurieren möchten.
Öffnen Sie auf der gewünschten Messwertkarte das Dreipunkt-Menü () und wählen Sie Benachrichtigungseinstellungen aus.
Folgen Sie der Anleitung auf dem Bildschirm, um den Benachrichtigungsgrenzwert 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 auf dem Dashboard im Blick behalten.
Best Practices für das Festlegen einer Leistungsbenachrichtigung
Netzwerkanfragen
Firebase fasst die Daten aus ähnlichen Netzwerkanfragen unter URL-Mustern zusammen. Diese können Folgendes sein:
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.
Benachrichtigungen für Ihre benutzerdefinierten 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 konsistenter demselben URL-Muster zugeordnet. Dadurch sind Benachrichtigungen für ein benutzerdefiniertes URL-Muster aussagekräftiger und effektiver für Ihr Team, da Sie dieses bestimmte Muster von Anfragen bereits als wichtig für Ihre App identifiziert haben.
Benachrichtigungen für automatische URL-Muster einrichten
Wenn Sie eine Benachrichtigung 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 und Benachrichtigungskonfigurationen werden nicht auf neue URL-Muster übertragen. Dies kann zu falschen oder fehlenden Benachrichtigungen für die Muster führen, die für Sie wichtig sind. Sie können auch ein benutzerdefiniertes URL-Muster erstellen, um sicherzustellen, dass dieses Muster stabil ist.
Webseitenladevorgänge
Empfohlene Grenzwerte für die Messung von Webmesswerten finden Sie in der Dokumentation zu Core Web Vitals.
Bildschirm-Rendering
Für eine optimale App-Nutzung sollten Nutzersitzungen keine langsamen oder eingefrorenen Frames enthalten. Performance Monitoring empfiehlt, Benachrichtigungen für eingefrorene Frames einzurichten, die mehr als 1% betragen, und Benachrichtigungen für langsame Frames, die 5 % überschreiten. Diese Werte sind bei der Konfiguration von Leistungsbenachrichtigungen als Standardeinstellungen vorhanden. Weitere Informationen zu übermäßig vielen langsamen oder eingefrorenen Frames und anderen Best Practices für die App-Leistung finden Sie in den Google Play-Richtlinien.