Verwenden Sie Leistungsüberwachungswarnungen, um Projektmitglieder zu benachrichtigen, wenn Codeänderungen oder Netzwerkanforderungen die Leistung Ihrer App beeinträchtigen.
Sie können Warnungen für Ihre App einrichten und anpassen, die Sie benachrichtigen, wenn die Leistung eines Ereignisses einen festgelegten Schwellenwert überschreitet.
Was löst eine Warnung aus?
Eine Warnung wird ausgelöst, wenn eine Metrik für Ihre App einen Schwellenwert überschreitet, den Sie für ein bestimmtes Perzentil (falls zutreffend) in der Firebase-Konsole definieren. Warnungen werden nur ausgelöst, wenn Ihre App eine echtzeitkompatible SDK-Version verwendet.
App-Startzeit
Wenn Sie eine Warnung für die Startzeit der App konfigurieren, wird die Warnung ausgelöst, wenn alle der folgenden Bedingungen zutreffen:
- Firebase hat in der letzten Stunde mindestens
100 Beispiele des_app_startTrace für die neueste Version Ihrer App aufgezeichnet. - Die Dauer des
_app_startTrace hat den definierten Schwellenwert der App während der letzten Stunde und für das konfigurierte Perzentil überschritten. - In der neuesten Version Ihrer App wurde zuvor keine Warnung für denselben Schwellenwert ausgelöst.
benutzerdefinierte Codespuren
Wenn Sie eine Warnung für eine Ablaufverfolgungsmetrik für benutzerdefinierten Code konfigurieren, wird die Warnung ausgelöst, wenn alle der folgenden Bedingungen zutreffen:
- Firebase hat in der letzten Stunde mindestens
100 Beispiele des benutzerdefinierten Code-Trace für die neueste Version Ihrer App aufgezeichnet. - Die Dauer der Ablaufverfolgung hat den definierten Schwellenwert der App während der letzten Stunde und für das konfigurierte Perzentil überschritten.
- (Nur für iOS+ und Android) In der neuesten Version Ihrer App wurde zuvor keine Warnung für denselben Schwellenwert ausgelöst.
- (Nur für das Internet) In den letzten
3 Tagen wurde für denselben Schwellenwert keine Warnung ausgelöst .
Netzwerkanfragen
Wenn Sie eine Warnung für eine Netzwerkanforderungsmetrik konfigurieren, wird die Warnung ausgelöst, wenn alle der folgenden Bedingungen zutreffen:
- Firebase hat in der letzten Stunde in allen Versionen Ihrer App mindestens
100 Beispiele aufgezeichnet, die mit dem URL-Muster übereinstimmten. - Der aggregierte Wert der Metrik hat den definierten Schwellenwert während der letzten Stunde überschritten:
- Reaktionszeit : Der aggregierte Wert hat den eingestellten Schwellenwert für das konfigurierte Perzentil überschritten
- Erfolgsquote : (nur für iOS+/Android) Der aggregierte Wert hat den festgelegten Schwellenwert für alle Benutzer unterschritten
- In den letzten
3 Tagen wurde für denselben Schwellenwert keine Warnung ausgelöst .
Bildschirmwiedergabe
Wenn Sie eine Warnung für eine Bildschirmdarstellungsmetrik konfigurieren, wird die Warnung ausgelöst, wenn alle der folgenden Bedingungen zutreffen:
- Firebase hat in der letzten Stunde mindestens
100 Beispiele der Bildschirmwiedergabe für die neueste Version Ihrer App aufgezeichnet. - Der aggregierte Wert der Metrik hat den definierten Schwellenwert während der letzten Stunde überschritten:
- Eingefrorene Frames : Der aggregierte Wert hat den festgelegten Schwellenwert überschritten
- langsame Frames : Der aggregierte Wert hat den festgelegten Schwellenwert überschritten
- In der neuesten Version Ihrer App wurde zuvor keine Warnung für denselben Schwellenwert ausgelöst.
Seite lädt
Wenn Sie eine Warnung für eine Seitenlademetrik konfigurieren, wird die Warnung ausgelöst, wenn alle der folgenden Bedingungen zutreffen:
- Firebase hat in der letzten Stunde mindestens
100 Beispiele für das Laden der Seite für Ihre App aufgezeichnet. - Der aggregierte Wert der Metrik hat den definierten Schwellenwert während der letzten Stunde und für das konfigurierte Perzentil überschritten:
- erste Eingabeverzögerung : Der aggregierte Wert hat den eingestellten Schwellenwert und das konfigurierte Perzentil überschritten
- first contentful paint : Der aggregierte Wert hat den eingestellten Schwellenwert und das konfigurierte Perzentil überschritten
- first paint : Der aggregierte Wert hat den eingestellten Schwellenwert und das konfigurierte Perzentil überschritten
- In den letzten
3 Tagen wurde für denselben Schwellenwert keine Warnung ausgelöst .
Erfahren Sie mehr über das Konfigurieren von Warnungen , Standardperzentilen und Best Practices zum Einrichten von Warnungen für bestimmte Arten von Ablaufverfolgungen und Metriken.
Warnungen für andere Leistungsmetriken oder für integrierte Firebase-Integrationen mit Slack , Jira und PagerDuty sind für Leistungsüberwachungswarnungen nicht verfügbar.
Meldungen erhalten
Erhalten Sie Standardbenachrichtigungen
Standardmäßig kann Firebase Leistungsüberwachungswarnungen per E-Mail senden.
Um Leistungsüberwachungswarnungen über diesen Standardmechanismus zu erhalten, müssen Sie über die Berechtigung firebaseperformance.config.update verfügen. Die folgenden Rollen enthalten diese erforderliche Berechtigung standardmäßig:
- Firebase-Leistungsadministrator
- Firebase-Qualitätsadministrator
- Firebase-Administrator
- Projekteigentümer oder Bearbeiter
Warnungen und ihre Einstellungen gelten projektweit. Das bedeutet, dass standardmäßig jedes Projektmitglied (das keiner E-Mail-Gruppe angehört und über die erforderlichen Berechtigungen zum Empfangen von Benachrichtigungen verfügt) eine E-Mail erhält, wenn eine Leistungswarnung ausgelöst wird.
Benachrichtigungen für Ihr eigenes Konto ein-/ausschalten
Für Ihr eigenes Konto können Sie Leistungsüberwachungswarnungen ein- und ausschalten, ohne andere Projektmitglieder zu beeinträchtigen. Beachten Sie, dass Sie immer noch die erforderlichen Berechtigungen benötigen, um Benachrichtigungen zu erhalten.
Führen Sie die folgenden Schritte aus, um Leistungsüberwachungswarnungen ein- oder auszuschalten:
- Gehen Sie in der Firebase-Konsole oben rechts zu Firebase-Warnungen .
- Gehen Sie dann zu Einstellungen und legen Sie Ihre Kontoeinstellungen für Leistungsüberwachungswarnungen fest.
Richten Sie erweiterte Benachrichtigungen für Dienste von Drittanbietern ein
Mit Cloud Functions for Firebase können Sie auch Leistungsüberwachungswarnungen an den bevorzugten Benachrichtigungskanal Ihres Teams senden. Sie können beispielsweise eine Funktion schreiben, die ein Warnereignis für eine langsame App-Startzeit erfasst und die Warninformationen an einen Drittanbieterdienst wie Discord, Slack oder Jira sendet.
Führen Sie die folgenden Schritte aus, um erweiterte Benachrichtigungsfunktionen mit Cloud Functions for Firebase einzurichten:
Richten Sie Cloud Functions for Firebase ein , was die folgenden Aufgaben umfasst:
- Laden Sie Node.js und npm herunter.
- Installieren Sie die Firebase-Befehlszeilenschnittstelle und melden Sie sich an.
- Initialisieren Sie Cloud Functions for Firebase mit der Firebase-CLI.
Schreiben und implementieren Sie eine Funktion , die ein Warnungsereignis aus der Leistungsüberwachung erfasst und die Ereignisnutzlast verarbeitet (z. B. die Warnungsinformationen in einer Nachricht auf Discord postet).
Informationen zu allen Leistungswarnungsereignissen, die Sie erfassen können, finden Sie in der Referenzdokumentation für Leistungsüberwachungswarnungen .
Automatisches Entfernen ungültiger Warnungen
Die Leistungsüberwachung validiert Warnungen, um sicherzustellen, dass die Daten gültig sind und Warnungen aktiv verwendet werden. Warnungen gelten als gültig, wenn einer der folgenden Punkte zutrifft:
- Die Warnung wird für eine Ressourcen-ID erstellt, für die Performance Monitoring in den letzten 90 Tagen Daten empfangen hat.
- Die Benachrichtigung wurde kürzlich 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 Zeitraums von 90 Tagen keine Daten gesendet werden, entfernt die Leistungsüberwachung diese Warnung. Weitere Informationen zu benutzerdefinierten URL-Mustern finden Sie unter Aggregierte Daten unter Kunden-URL-Muster .
Wenn eine dieser Bedingungen nicht erfüllt ist, entfernt die Leistungsüberwachung die Warnung.
Konfigurieren Sie eine Warnung
Um Leistungsüberwachungswarnungen zu konfigurieren, müssen Sie über die Berechtigung firebaseperformance.config.update verfügen. Die folgenden Rollen beinhalten diese erforderliche Berechtigung standardmäßig: Firebase Performance Admin , Firebase Quality Admin , Firebase Admin und Project Owner or Editor .
Fügen Sie Ihrer App das neueste Leistungsüberwachungs-SDK hinzu, falls Sie dies noch nicht getan haben. Weitere Informationen finden Sie in den Erste-Schritte-Leitfäden für die Plattformen Web , Android , Apple und Flutter .
Verwenden Sie in jeder Ihrer registrierten Apps die Traces-Tabelle oder die Dashboard-Berichtskarte, um eine Warnung für jede Metrik zu konfigurieren, die Sie überwachen möchten. Jede App kann einen anderen Satz von Warnungen haben, jede mit einem anderen Schwellenwert (oder überhaupt keine Warnungen haben).
Konfigurieren Sie eine Warnung in der Traces-Tabelle
Wechseln Sie in der Firebase-Konsole zur Registerkarte Leistungsüberwachungs- Dashboard und wählen Sie dann die App aus, für die Sie eine Warnung konfigurieren möchten.
Scrollen Sie nach unten zur Traces-Tabelle am unteren Rand des Bildschirms.
Wählen Sie die Registerkarte des Ablaufverfolgungstyps aus, für den Sie eine Warnung festlegen möchten, und suchen Sie dann die entsprechende Zeile.
Öffnen Sie ganz rechts in der Zeile das Überlaufmenü ( ) und wählen Sie Benachrichtigungseinstellungen aus.
Befolgen Sie die Anweisungen auf dem Bildschirm, um den Alarmschwellenwert und das Perzentil (falls zutreffend) für die App festzulegen oder den Alarm ein-/auszuschalten. Die Standardperzentile sind 90. für Android und iOS und 75. für Web. Weitere Informationen zu Standardperzentilen finden Sie unter Verfolgen von Schlüsselmetriken in Ihrem Dashboard .
Konfigurieren Sie eine Warnung in der Dashboard-Berichtskarte
Wechseln Sie in der Firebase-Konsole zur Registerkarte Leistungsüberwachungs- Dashboard und wählen Sie dann die App aus, für die Sie eine Warnung konfigurieren möchten.
Suchen Sie auf der Registerkarte Berichtskarte die Metrikkarte, für die Sie eine Warnung konfigurieren möchten.
Öffnen Sie in der gewünschten Messwertkarte das Überlaufmenü ( ) und wählen Sie Benachrichtigungseinstellungen aus.
Befolgen Sie die Anweisungen auf dem Bildschirm, um den Alarmschwellenwert und das Perzentil (falls zutreffend) für die App festzulegen oder den Alarm ein-/auszuschalten. Die Standardperzentile sind 90. für Android und iOS und 75. für Web. Weitere Informationen zu Standardperzentilen finden Sie unter Verfolgen von Schlüsselmetriken in Ihrem Dashboard .
Best Practices zum Festlegen einer Leistungswarnung
Netzwerkanfragen
Firebase aggregiert die Daten von ähnlichen Netzwerkanfragen unter URL-Mustern, die eines der folgenden 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 je nach aktuellem Nutzungsverhalten Ihrer App im Laufe der Zeit ändern.
Richten Sie Benachrichtigungen für Ihre benutzerdefinierten URL-Muster ein
Wir empfehlen, Benachrichtigungen für alle benutzerdefinierten URL-Muster einzurichten, die Sie konfiguriert haben. Da Firebase versucht, eine Anfrage zuerst einem benutzerdefinierten URL-Muster zuzuordnen, werden ähnliche Anfragen konsistenter demselben URL-Muster zugeordnet. Dadurch werden Warnungen für ein benutzerdefiniertes URL-Muster für Ihr Team aussagekräftiger und effektiver, da Sie dieses spezifische Anforderungsmuster bereits als wichtig für Ihre App identifiziert haben.
Richten Sie Benachrichtigungen für automatische URL-Muster ein
Stellen Sie beim Einrichten einer Benachrichtigung für ein automatisches URL-Muster sicher, 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 Warnungskonfigurationen nicht auf neue URL-Muster übertragen werden. Dies kann zu falschen oder fehlenden Warnungen für die Muster führen, die Ihnen wichtig sind. Sie können auch erwägen, ein benutzerdefiniertes URL-Muster zu erstellen, um sicherzustellen, dass dieses Muster stabil ist.
Webseite lädt
Informationen zu empfohlenen Schwellenwerten zum Messen von Webmetriken finden Sie in der Core Web Vitals- Dokumentation.
Bildschirmdarstellungen
Um ein optimales App-Erlebnis zu gewährleisten, sollten Benutzersitzungen frei von langsamen und eingefrorenen Frames sein. Die Leistungsüberwachung empfiehlt, Warnungen für eingefrorene Frames von mehr als 1 % und Warnungen für langsame Frames von mehr als 5 % einzurichten. Sie werden feststellen, dass diese Werte während der Konfiguration von Leistungswarnungen als Standardeinstellungen vorhanden sind. 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 .