Benutzerdefiniertes Monitoring für bestimmten Anwendungscode hinzufügen


Performance Monitoring erfasst Traces, um Sie bei der Überwachung der Leistung Ihrer Anwendung zu unterstützen. A Trace ist ein Bericht der Leistungsdaten, die zwischen zwei Zeitpunkten in für Ihre App.

Sie können eigene Traces erstellen, um die Leistungsdaten zu überwachen, Code in Ihrer App zu platzieren. Mit einem benutzerdefinierten Code-Trace können Sie messen, wie wie lange es dauert, bis Ihre App eine bestimmte Aufgabe oder eine Reihe von Aufgaben erledigt hat, wie das Laden einer Reihe von Bildern oder das Abfragen Ihrer Datenbank.

Der Standardmesswert für einen benutzerdefinierten Code-Trace ist seine „Dauer“ (die Zeit zwischen Start- und Endpunkte des Trace). Sie können jedoch benutzerdefinierte Messwerte.

In Ihrem Code definieren Sie den Anfang und das Ende eines benutzerdefinierten Code-Trace mithilfe von die vom Performance Monitoring SDK bereitgestellten APIs

Benutzerdefinierte Code-Traces können nach dem Erstellen jederzeit gestartet werden und sind threadsicher.

Da der Standardmesswert für diese Traces „Dauer“ ist, sind sie manchmal als „Dauer-Traces“ bezeichnet.

Sie können die Daten dieser Traces auf dem Unter-Tab Benutzerdefinierte Traces der Traces ansehen. Die entsprechende Tabelle finden Sie unten auf dem Dashboard Leistung. über die Console weiter unten auf dieser Seite).

Standardattribute, benutzerdefinierte Attribute und benutzerdefinierte Messwerte

Benutzerdefinierte Code-Traces werden in Performance Monitoring automatisch protokolliert Standardattribute (allgemeine Metadaten wie App-Version, Land, Gerät usw.) damit Sie die Daten für den Trace in der Firebase Console filtern können. Ich kann auch benutzerdefinierte Attribute hinzufügen und überwachen z. B. ein Level in einem Spiel oder Nutzereigenschaften.

Sie können einen benutzerdefinierten Code-Trace so konfigurieren, dass benutzerdefinierte Messwerte für leistungsbezogene Ereignisse aufgezeichnet werden, die im Gültigkeitsbereich des Tracings auftreten. Sie können beispielsweise einen benutzerdefinierten Messwert für die Anzahl der Cache-Treffer und -Fehler oder die Häufigkeit, mit der die Benutzeroberfläche über einen längeren Zeitraum nicht reagieren.

Benutzerdefinierte Attribute und Messwerte werden in der Firebase Console angezeigt neben den Standardattributen und dem Standardmesswert für den Trace.

Benutzerdefinierte Code-Traces hinzufügen

Trace API von Performance Monitoring verwenden , um benutzerdefinierte Code-Traces hinzuzufügen, um bestimmten Anwendungscode zu überwachen.

Wichtige Hinweise:

  • Eine App kann mehrere benutzerdefinierte Code-Traces haben.
  • Es kann mehr als ein benutzerdefinierter Code-Trace gleichzeitig ausgeführt werden.
  • Namen für benutzerdefinierte Code-Traces müssen die folgenden Anforderungen erfüllen: Sie dürfen keine führenden oder abschließenden Leerzeichen, keinen führenden Unterstrich (_) und eine maximale Länge von 100 Zeichen haben.
  • Benutzerdefinierte Code-Traces unterstützen das Hinzufügen von benutzerdefinierten Messwerten und benutzerdefinierten Attributen.

Verpacken Sie den Code, den Sie verfolgen möchten, um ein benutzerdefiniertes Code-Trace zu starten und zu stoppen. Code ähnlich dem folgenden:

Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();

// Code you want to trace

await customTrace.stop();

Benutzerdefinierten Code-Traces benutzerdefinierte Messwerte hinzufügen

Mit der Trace API für die Leistungsüberwachung können Sie benutzerdefinierten Code-Traces benutzerdefinierte Messwerte hinzufügen.

Wichtige Hinweise:

  • Namen für benutzerdefinierte Messwerte müssen die folgenden Anforderungen erfüllen: kein vorangestelltes oder nachgestelltes Leerzeichen, kein führender Unterstrich (_)-Zeichen, Die maximale Länge beträgt 100 Zeichen.
  • Jeder benutzerdefinierte Code-Trace kann bis zu 32 Messwerte aufzeichnen (einschließlich der Dauer).

Wenn Sie einen benutzerdefinierten Messwert hinzufügen möchten, fügen Sie jedes Mal, wenn das Ereignis eintritt, eine Codezeile hinzu, die der folgenden ähnelt. Dieser benutzerdefinierte Messwert zählt beispielsweise leistungsbezogene Ereignisse, die in Ihrer App auftreten, wie Cache-Treffer oder Wiederholungsversuche.

Trace customTrace = FirebasePerformance.instance.newTrace("custom-trace");
await customTrace.start();

// Code you want to trace

customTrace.incrementMetric("metric-name", 1);

// More code

await customTrace.stop();

Benutzerdefinierte Attribute für benutzerdefinierte Code-Traces erstellen

Wenn Sie benutzerdefinierte Attribute verwenden möchten, fügen Sie Ihrer App Code hinzu, der das Attribut definiert und mit einer bestimmten benutzerdefinierten Code-Spuren verknüpft. Sie können das benutzerdefinierte Attribut jederzeit zwischen dem Start und dem Ende der Aufzeichnung festlegen.

Wichtige Hinweise:

  • Namen für benutzerdefinierte Attribute müssen die folgenden Anforderungen erfüllen: Sie dürfen keine anführenden oder nachgestellten Leerzeichen, keinen anführenden Unterstrich (_) und eine maximale Länge von 32 Zeichen haben.

  • Für jede benutzerdefinierte Code-Spuren können bis zu fünf benutzerdefinierte Attribute erfasst werden.

  • Sie sollten keine benutzerdefinierten Attribute verwenden, die Informationen enthalten, die eine Person für Google identifizieren.

Trace trace = FirebasePerformance.instance.newTrace("test_trace");

// Update scenario.
trace.putAttribute("experiment", "A");

// Reading scenario.
String? experimentValue = trace.getAttribute("experiment");

// Delete scenario.
trace.removeAttribute("experiment");

// Read attributes.
Map<String, String> traceAttributes = trace.getAttributes();

Leistungsdaten erfassen, aufrufen und filtern

Bestimmte Messwerte im Dashboard beobachten

Wenn Sie wissen möchten, wie sich Ihre wichtigsten Messwerte entwickeln, fügen Sie sie unter oben im Dashboard Leistungsüberwachung. Sie können Regressionen schnell erkennen, Änderungen im Wochenvergleich sehen oder überprüfen, ob die letzten Änderungen an Ihrem Code zur Verbesserung der Leistung.

Wenn Sie dem Messwert-Board einen Messwert hinzufügen möchten, rufen Sie das Dashboard Leistung auf. in der Firebase Console und klicken Sie dann auf den Tab Dashboard. Klicken Sie auf einen leeren Messwert und wählen Sie dann einen vorhandenen Messwert aus, den Sie Ihrem Board hinzufügen möchten. Klicken Sie auf einer ausgefüllten Messwertkarte auf das vertikale Dreipunkt-Menü ⋮, um weitere Optionen aufzurufen, z. B. zum Ersetzen oder Entfernen eines Messwerts.

Auf dem Messwert-Dashboard werden erfasste Messwertdaten im Zeitverlauf sowohl in grafischer Form als auch als numerische prozentuale Änderung angezeigt.

Weitere Informationen zur Verwendung des Dashboards

Traces und ihre Daten ansehen

Wenn Sie sich Ihre Traces ansehen möchten, rufen Sie in der Firebase Console das Dashboard „Leistung“ auf, scrollen Sie nach unten zur Tabelle mit den Traces und klicken Sie dann auf den entsprechenden Untertab. In der Tabelle werden einige der wichtigsten Messwerte für jeden Trace angezeigt. können die Liste sogar nach der prozentualen Änderung für einen bestimmten Messwert sortieren.

Wenn Sie in der Trace-Tabelle auf einen Trace-Namen klicken, können Sie verschiedene Bildschirme, um den Trace zu untersuchen und relevante Messwerte aufzuschlüsseln. Auf den meisten Seiten können Sie mit der Schaltfläche Filter oben links auf dem Bildschirm Filtern der Daten nach Attribut. Beispiel:

  • Filtern Sie nach App-Version, um Daten zu einem früheren Release oder Ihrem neuesten Release aufzurufen.
  • Filtern Sie nach Gerät, um zu sehen, wie ältere Geräte mit Ihrer App umgehen.
  • Filtern Sie nach Land, um sicherzustellen, dass sich der Speicherort Ihrer Datenbank nicht auf eine bestimmte Region auswirkt.

Weitere Informationen zum Aufrufen von Trace-Daten

Nächste Schritte