Benutzerdefiniertes Monitoring für bestimmten Anwendungscode hinzufügen


Performance Monitoring erfasst Traces, um Ihnen die Überwachung der Leistung Ihrer App zu erleichtern. Ein Trace ist ein Bericht mit Leistungsdaten, die zwischen zwei Zeitpunkten in Ihrer App erfasst wurden.

Sie können eigene Traces erstellen, um Leistungsdaten zu überwachen, die mit bestimmtem Code in Ihrer App verknüpft sind. Mit einem Trace für benutzerdefinierten Code können Sie messen, wie lange Ihre App für eine bestimmte Aufgabe oder eine Reihe von Aufgaben benötigt, z. B. für das Laden einer Reihe von Bildern oder das Abfragen Ihrer Datenbank.

Der Standardmesswert für einen benutzerdefinierten Code-Trace ist die „Dauer“ (die Zeit zwischen dem Start- und dem Endpunkt des Trace). Sie können aber auch benutzerdefinierte Messwerte hinzufügen.

In Ihrem Code definieren Sie den Anfang und das Ende eines benutzerdefinierten Code-Trace mithilfe der APIs, die vom Performance Monitoring SDK bereitgestellt werden.

Benutzerdefinierte Code-Traces können jederzeit nach ihrer Erstellung gestartet werden und sind threadsicher.

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

Sie können Daten aus diesen Traces auf dem Untertab Benutzerdefinierte Traces der Trace-Tabelle unten im Dashboard Leistung aufrufen. Weitere Informationen zur Verwendung der Console finden Sie weiter unten auf dieser Seite.

Standardattribute, benutzerdefinierte Attribute und benutzerdefinierte Messwerte

Bei benutzerdefinierten Code-Traces protokolliert Performance Monitoring automatisch 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. Sie können auch benutzerdefinierte Attribute (z. B. Spiellevel oder Nutzereigenschaften) hinzufügen und beobachten.

Sie können einen benutzerdefinierten Code-Trace weiter konfigurieren, um benutzerdefinierte Messwerte für leistungsbezogene Ereignisse aufzuzeichnen, die im Rahmen des Trace auftreten. Sie können beispielsweise einen benutzerdefinierten Messwert für die Anzahl der Cache-Treffer und -Fehler oder die Anzahl der Fälle erstellen, in denen die Benutzeroberfläche für einen spürbaren Zeitraum nicht mehr reagiert.

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

Benutzerdefinierte Code-Traces hinzufügen

Mit der Performance Monitoring Trace API können Sie benutzerdefinierte Code-Traces hinzufügen, um bestimmten Anwendungscode zu überwachen.

Wichtige Hinweise:

  • Eine App kann mehrere benutzerdefinierte Code-Traces haben.
  • Es können mehrere benutzerdefinierte Code-Traces gleichzeitig ausgeführt werden.
  • Namen für benutzerdefinierte Code-Traces müssen die folgenden Anforderungen erfüllen: keine voran- oder nachgestellten Leerzeichen, kein vorangestellter Unterstrich (_) und maximal 100 Zeichen lang.
  • Benutzerdefinierte Code-Traces unterstützen das Hinzufügen von benutzerdefinierten Messwerten und benutzerdefinierten Attributen.

Wenn Sie einen benutzerdefinierten Code-Trace starten und beenden möchten, umschließen Sie den Code, den Sie verfolgen möchten, mit Code, der in etwa so aussieht:

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

// Code you want to trace

await customTrace.stop();

Benutzerdefinierte Messwerte zu benutzerdefinierten Code-Traces hinzufügen

Mit der Performance Monitoring Trace API können Sie benutzerdefinierte Messwerte zu benutzerdefinierten Code-Traces hinzufügen.

Wichtige Hinweise:

  • Namen für benutzerdefinierte Messwerte müssen die folgenden Anforderungen erfüllen: keine führenden oder nachgestellten Leerzeichen, kein führender Unterstrich (_) und eine maximale Länge von 100 Zeichen.
  • In jedem benutzerdefinierten Code-Trace können bis zu 32 Messwerte aufgezeichnet werden (einschließlich des Standardmesswerts Dauer).

Wenn Sie einen benutzerdefinierten Messwert hinzufügen möchten, fügen Sie jedes Mal, wenn das Ereignis auftritt, eine Codezeile wie die folgende hinzu. Mit diesem benutzerdefinierten Messwert werden beispielsweise leistungsbezogene Ereignisse gezählt, die in Ihrer Anwendung auftreten, z. B. 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 einem bestimmten benutzerdefinierten Code-Trace verknüpft. Sie können das benutzerdefinierte Attribut jederzeit zwischen dem Start und dem Ende des Trace festlegen.

Wichtige Hinweise:

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

  • In jedem benutzerdefinierten Code-Trace können bis zu 5 benutzerdefinierte Attribute aufgezeichnet werden.

  • Sie sollten keine benutzerdefinierten Attribute verwenden, die Informationen enthalten, mit denen eine Person gegenüber Google identifiziert werden kann.

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, ansehen und filtern

Bestimmte Messwerte im Dashboard im Blick behalten

Wenn Sie wissen möchten, wie sich Ihre wichtigsten Messwerte entwickeln, fügen Sie sie oben im Dashboard Leistung dem Messwertbereich hinzu. Sie können Regressionen schnell erkennen, indem Sie sich die Änderungen im Vergleich zur Vorwoche ansehen, oder prüfen, ob die letzten Änderungen an Ihrem Code die Leistung verbessern.

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

Auf dem Messwert-Dashboard werden die erfassten 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. Sie 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 sich durch verschiedene Bildschirme klicken, um den Trace zu untersuchen und die gewünschten Messwerte aufzuschlüsseln. Auf den meisten Seiten können Sie die Daten mit der Schaltfläche Filter (oben links auf dem Bildschirm) nach Attribut filtern, z. B.:

  • Filtern Sie nach App-Version, um Daten zu einem früheren Release oder Ihrem neuesten Release aufzurufen.
  • Nach Gerät filtern, um zu sehen, wie ältere Geräte mit deiner App umgehen
  • Filtern Sie nach Land, um sicherzustellen, dass der Standort Ihrer Datenbank keine Auswirkungen auf eine bestimmte Region hat.

Weitere Informationen zum Aufrufen von Daten für Ihre Traces

Nächste Schritte