Richten Sie Warnungen für Leistungsprobleme ein

Verwenden Sie Leistungsüberwachungswarnungen, um Projektmitglieder zu benachrichtigen, wenn Codeänderungen oder Netzwerkanforderungen 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 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.

Startzeit der App

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_start Trace für die neueste Version Ihrer App aufgezeichnet.
  • Die Dauer der _app_start Ablaufverfolgung hat in der letzten Stunde und für das konfigurierte Perzentil den definierten Schwellenwert der App überschritten.
  • In der neuesten Version Ihrer App wurde zuvor keine Warnung für denselben Schwellenwert ausgelöst.

benutzerdefinierte Code-Traces

Wenn Sie eine Warnung für eine Trace-Metrik 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 in der letzten Stunde und für das konfigurierte Perzentil den von der App definierten Schwellenwert ü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 Web) In den letzten drei Tagen wurde zuvor keine Warnung für denselben Schwellenwert 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 in der letzten Stunde den definierten Schwellenwert überschritten:
    • Antwortzeit : Der aggregierte Wert hat den festgelegten Schwellenwert für das konfigurierte Perzentil überschritten
    • Erfolgsquote : (nur für iOS+/Android) Der aggregierte Wert fiel bei allen Benutzern unter den festgelegten Schwellenwert
  • Für denselben Schwellenwert wurde in den letzten drei Tagen noch keine Warnung ausgelöst.

Bildschirmdarstellung

Wenn Sie eine Warnung für eine Bildschirmwiedergabemetrik konfigurieren, wird die Warnung ausgelöst, wenn alle der folgenden Bedingungen zutreffen:

  • Firebase hat in der letzten Stunde mindestens 100 Beispiele für Bildschirmdarstellungen für die neueste Version Ihrer App aufgezeichnet.
  • Der aggregierte Wert der Metrik hat in der letzten Stunde den definierten Schwellenwert ü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 Seitenladevorgänge für Ihre App aufgezeichnet.
  • Der aggregierte Wert der Metrik hat in der letzten Stunde und für das konfigurierte Perzentil den definierten Schwellenwert überschritten:
    • erste Eingabeverzögerung : Der aggregierte Wert hat den eingestellten Schwellenwert und das konfigurierte Perzentil überschritten
    • erster Contentful Paint : Der aggregierte Wert hat den festgelegten Schwellenwert und das konfigurierte Perzentil überschritten
    • Erster Malvorgang : Der aggregierte Wert hat den festgelegten Schwellenwert und das konfigurierte Perzentil überschritten
  • Für denselben Schwellenwert wurde in den letzten drei Tagen noch 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 Standardwarnungen

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 umfassen standardmäßig diese erforderliche Berechtigung:

Warnungen und ihre Einstellungen gelten projektweit. Dies 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.

Aktivieren/deaktivieren Sie Benachrichtigungen für Ihr eigenes Konto

Für Ihr eigenes Konto können Sie Leistungsüberwachungswarnungen aktivieren/deaktivieren, ohne dass dies Auswirkungen auf andere Projektmitglieder hat. Beachten Sie, dass Sie weiterhin die erforderlichen Berechtigungen benötigen, um Benachrichtigungen zu erhalten.

Gehen Sie wie folgt vor, um Warnmeldungen zur Leistungsüberwachung zu aktivieren oder zu deaktivieren:

  1. Gehen Sie in der Firebase-Konsole oben rechts zu Firebase-Warnungen .
  2. Dann geh zu Einstellungen und legen Sie Ihre Kontoeinstellungen für Leistungsüberwachungswarnungen fest.

Richten Sie erweiterte Benachrichtigungen für Drittanbieterdienste ein

Mithilfe von Cloud Functions für 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 mithilfe von Cloud Functions für Firebase einzurichten:

  1. Richten Sie Cloud Functions für Firebase ein , was die folgenden Aufgaben umfasst:

    1. Richten Sie eine Entwicklungsumgebung für Node.js oder Python ein.
    2. Installieren Sie die Firebase-CLI und melden Sie sich an.
    3. Initialisieren Sie Cloud Functions für Firebase mit der Firebase-CLI.

  2. Schreiben und implementieren Sie eine Funktion , die ein Warnereignis aus der Leistungsüberwachung erfasst und die Ereignisnutzlast verarbeitet (z. B. die Warninformationen in einer Nachricht auf Discord veröffentlicht).

Weitere Informationen zu allen Leistungswarnungsereignissen, die Sie erfassen können, finden Sie in der Referenzdokumentation für Leistungsüberwachungswarnungen .

Automatische Entfernung 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 eine der folgenden Bedingungen zutrifft:

  • Die Warnung wird für eine Ressourcen-ID erstellt, für die Performance Monitoring in den letzten 90 Tagen Daten empfangen hat.
  • Die Warnung 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, Daten für dieses Muster zu senden. Wenn innerhalb des Zeitraums von 90 Tagen keine Daten gesendet werden, entfernt Performance Monitoring diese Warnung. Weitere Informationen zu benutzerdefinierten URL-Mustern finden Sie unter „Daten aggregieren“ unter „Kunden-URL-Muster“ .

Wenn eine dieser Bedingungen nicht erfüllt ist, entfernt Performance Monitoring 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 umfassen standardmäßig diese erforderliche Berechtigung: Firebase Performance Admin , Firebase Quality Admin , Firebase Admin und Projektbesitzer oder -editor .

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

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

  1. Gehen 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.

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

  3. Wählen Sie die Registerkarte des Trace-Typs aus, für den Sie eine Warnung festlegen möchten, und suchen Sie dann die entsprechende Zeile.

  4. Öffnen Sie ganz rechts in der Zeile das Überlaufmenü ( ) und wählen Sie Alarmeinstellungen aus.

  5. 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 Sie wichtige Kennzahlen in Ihrem Dashboard .

Konfigurieren Sie eine Warnung in der Dashboard-Berichtskarte

  1. Gehen 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.

  2. Suchen Sie auf der Registerkarte „Berichtskarte“ die Metrikkarte, für die Sie eine Warnung konfigurieren möchten.

  3. Öffnen Sie in der gewünschten Metrikkarte das Überlaufmenü ( ) und wählen Sie Alarmeinstellungen aus.

  4. 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 Sie wichtige Kennzahlen 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 im Laufe der Zeit je nach aktuellem Nutzungsverhalten Ihrer App ä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 zunächst 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 Anforderungsmuster bereits als wichtig für Ihre App identifiziert haben.

Richten Sie Benachrichtigungen für automatische URL-Muster ein

Stellen Sie beim Einrichten einer Warnung 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 könnte zu falschen oder fehlenden Warnungen für die Muster führen, die Sie interessieren. Sie können auch die Erstellung eines benutzerdefinierten URL-Musters in Betracht ziehen, um sicherzustellen, dass dieses Muster stabil ist.

Webseite wird geladen

Informationen zu empfohlenen Schwellenwerten für die Messung von Webmetriken finden Sie in der Dokumentation zu Core Web Vitals .

Bildschirmdarstellungen

Um ein optimales App-Erlebnis zu gewährleisten, sollten Benutzersitzungen frei von langsamen und eingefrorenen Frames sein. Performance Monitoring empfiehlt, Warnungen für eingefrorene Frames über 1 % und Warnungen für langsame Frames über 5 % einzurichten. Sie werden feststellen, dass diese Werte während der Konfiguration der 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 den Google Play-Anleitungen .