Google is committed to advancing racial equity for Black communities. See how.
Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Fügen Sie eine benutzerdefinierte Überwachung für einen bestimmten App-Code hinzu

Die Leistungsüberwachung sammelt Traces, mit denen Sie die Leistung Ihrer App überwachen können. Ein Trace ist ein Bericht über Leistungsdaten, die zwischen zwei Zeitpunkten in Ihrer App erfasst wurden.

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

Die Standardmetrik für eine benutzerdefinierte Code-Ablaufverfolgung ist ihre "Dauer" (die Zeit zwischen dem Start- und Endpunkt der Ablaufverfolgung). Sie können jedoch auch benutzerdefinierte Metriken 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. Für Android-Apps können Sie bestimmte Methoden auch mithilfe der Annotation @AddTrace überwachen. Benutzerdefinierte Code-Traces können auch nach ihrer Erstellung gestartet werden und sind threadsicher.

Zeigen Sie Daten aus benutzerdefinierten Code-Traces auf der Registerkarte Auf dem Gerät der Firebase-Konsole an ( weitere Informationen finden Sie später auf dieser Seite). Da die für diese Traces gesammelte Standardmetrik "Dauer" ist, werden sie manchmal als "Duration-Traces" bezeichnet. Außerdem werden diese Traces in der Firebase-Konsole (auf der Registerkarte Auf Gerät ) unter der Tabelle Dauer gruppiert.

Standardattribute, benutzerdefinierte Attribute und benutzerdefinierte Metriken

Bei benutzerdefinierten Code-Traces protokolliert die Leistungsüberwachung automatisch Standardattribute (allgemeine Metadaten wie App-Version, Land, Gerät usw.), sodass Sie die Daten für den Trace in der Firebase-Konsole filtern können. Sie können auch benutzerdefinierte Attribute hinzufügen und überwachen (z. B. Spielebene oder Benutzereigenschaften).

Sie können eine benutzerdefinierte Code-Ablaufverfolgung weiter konfigurieren, um benutzerdefinierte Metriken für leistungsbezogene Ereignisse aufzuzeichnen, die im Bereich der Ablaufverfolgung auftreten. Sie können beispielsweise eine benutzerdefinierte Metrik für die Anzahl der Cache-Treffer und -Fehler oder die Häufigkeit erstellen, mit der die Benutzeroberfläche für einen spürbaren Zeitraum nicht mehr reagiert.

Benutzerdefinierte Attribute und benutzerdefinierte Metriken werden in der Firebase-Konsole neben den Standardattributen und der Standardmetrik für die Ablaufverfolgung angezeigt.

Fügen Sie benutzerdefinierte Codespuren hinzu

Verwenden Sie die Trace-API für die Leistungsüberwachung, um benutzerdefinierte Code-Traces hinzuzufügen, um bestimmten Anwendungscode zu überwachen.

Beachte das Folgende:

  • Eine App kann mehrere benutzerdefinierte Codespuren 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: Kein führendes oder nachfolgendes Leerzeichen, kein führender Unterstrich ( _ ) und eine maximale Länge von 100 Zeichen.
  • Benutzerdefinierte Code-Traces unterstützen das Hinzufügen von benutzerdefinierten Metriken und benutzerdefinierten Attributen .

Um eine benutzerdefinierte Code-Ablaufverfolgung zu starten und zu stoppen, umschließen Sie den Code, den Sie verfolgen möchten, mit Codezeilen, die den folgenden ähnlich sind (in diesem Beispiel wird der benutzerdefinierte Ablaufverfolgungsname test_trace ):

Java

// Import these Performance Monitoring classes at the top of your `.java` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.Trace;

Trace myTrace = FirebasePerformance.getInstance().newTrace("test_trace");
myTrace.start();

// code that you want to trace

myTrace.stop();

Kotlin + KTX

// Import these Performance Monitoring classes at the top of your `.kt` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.Trace;

val myTrace = FirebasePerformance.getInstance().newTrace("test_trace")
myTrace.start()

// code that you want to trace

myTrace.stop()

(Optional) Überwachen Sie bestimmte Methoden mit @AddTrace

Android-Apps unterstützen auch die Annotation @AddTrace um benutzerdefinierte @AddTrace zu instrumentieren. Mit dieser Funktion beginnt die Ablaufverfolgung am Anfang der angegebenen Methode und endet nach Abschluss der Methode, einschließlich aller von der Methode aufgerufenen Elemente.

Sie können beispielsweise eine benutzerdefinierte Code-Ablaufverfolgung mit dem Namen onCreateTrace , die ausgeführt wird, wenn die Methode onCreate() aufgerufen wird.

Java

// Import these Performance Monitoring classes at the top of your `.java` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.AddTrace;

// Add the `@AddTrace` annotation above the method you want to trace
@Override
@AddTrace(name = "onCreateTrace", enabled = true /* optional */)
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
}

Kotlin + KTX

// Import these Performance Monitoring classes at the top of your `.kt` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.AddTrace;

// Add the `@AddTrace` annotation above the method you want to trace
@AddTrace(name = "onCreateTrace", enabled = true /* optional */)
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
}

Fügen Sie benutzerdefinierten Metriken benutzerdefinierte Metriken hinzu

Verwenden Sie die Leistungsüberwachungs- Trace-API , um benutzerdefinierten Metriken benutzerdefinierte Metriken hinzuzufügen.

Beachte das Folgende:

  • Namen für benutzerdefinierte Metriken müssen die folgenden Anforderungen erfüllen: kein führendes oder nachfolgendes Leerzeichen, kein führender Unterstrich ( _ ) und eine maximale Länge von 100 Zeichen.
  • Jeder benutzerdefinierte Code-Trace kann bis zu 32 Metriken aufzeichnen (einschließlich der Standard-Metrik für die Dauer ).

Fügen Sie zum Hinzufügen einer benutzerdefinierten Metrik bei jedem Auftreten des Ereignisses eine Codezeile hinzu, die der folgenden ähnelt. Diese benutzerdefinierte Metrik zählt beispielsweise leistungsbezogene Ereignisse, die in Ihrer App auftreten, z. B. Cache-Treffer und item_cache_hit (unter Verwendung der Beispielereignisnamen item_cache_hit und item_cache_miss und eines Inkrements von 1 ).

Java

Trace myTrace = FirebasePerformance.getInstance().newTrace("test_trace");
myTrace.start();

// code that you want to trace (and log custom metrics)
Item item = cache.fetch("item");
if (item != null) {
    myTrace.incrementMetric("item_cache_hit", 1);
} else {
    myTrace.incrementMetric("item_cache_miss", 1);
}

myTrace.stop();

Kotlin + KTX

val myTrace = FirebasePerformance.getInstance().newTrace("test_trace")
myTrace.start()

// code that you want to trace (and log custom metrics)
val item = cache.fetch("item")
if (item != null) {
    myTrace.incrementMetric("item_cache_hit", 1)
} else {
    myTrace.incrementMetric("item_cache_miss", 1)
}

myTrace.stop()

Erstellen Sie benutzerdefinierte Attribute für benutzerdefinierte Code-Traces

Verwenden Sie die Performance Monitoring Trace-API , um benutzerdefinierten Attributen benutzerdefinierte Attribute hinzuzufügen.

Um benutzerdefinierte Attribute zu verwenden, fügen Sie Ihrer App Code hinzu, der das Attribut definiert und einem bestimmten benutzerdefinierten Code-Trace zuordnet. Sie können das benutzerdefinierte Attribut jederzeit zwischen dem Start der Ablaufverfolgung und dem Stopp der Ablaufverfolgung festlegen.

Beachte das Folgende:

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

  • Jeder benutzerdefinierte Code-Trace kann bis zu 5 benutzerdefinierte Attribute aufzeichnen.

  • Sie sollten keine benutzerdefinierten Attribute verwenden, die Informationen enthalten, die eine Person gegenüber Google persönlich identifizieren.

    Erfahren Sie mehr über diese Richtlinie

Java

Trace trace = FirebasePerformance.getInstance().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();

Kotlin + KTX

val trace = FirebasePerformance.getInstance().newTrace("test_trace")

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

// Reading scenario.
val experimentValue = trace.getAttribute("experiment")

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

// Read attributes.
val traceAttributes = trace.attributes

Verfolgen, Anzeigen und Filtern von Leistungsdaten

Verfolgen Sie bestimmte Metriken in Ihrem Dashboard

Fügen Sie Ihre wichtigsten Metriken zu Ihrem Dashboard hinzu, um zu erfahren, wie sie sich entwickeln. Sie können Regressionen schnell identifizieren, indem Sie Änderungen von Woche zu Woche sehen oder überprüfen, ob die letzten Änderungen in Ihrem Code die Leistung verbessern.

Ein Bild des Metrik-Dashboards für die Firebase-Leistungsüberwachung

Um Ihrem Dashboard eine Metrik hinzuzufügen, rufen Sie das Leistungs- Dashboard in der Firebase-Konsole auf und klicken Sie auf die Registerkarte Dashboard . Klicken Sie auf eine leere Metrikkarte und wählen Sie dann eine vorhandene Metrik aus, die Sie Ihrem Dashboard hinzufügen möchten. Klicken auf einer auf , um weitere Optionen , z. B. das Ersetzen oder Entfernen einer Metrik.

Das Dashboard zeigt die gesammelten Metrikdaten im Zeitverlauf sowohl in grafischer Form als auch als numerische prozentuale Änderung an.

Weitere Informationen zur Verwendung des Dashboards .

Alle Spuren und ihre Daten anzeigen

Um diese Traces anzuzeigen, rufen Sie das Leistungs- Dashboard in der Firebase-Konsole auf und klicken Sie auf die Registerkarte Auf Gerät .

Auf der Registerkarte Auf Gerät können Sie durch verschiedene Bildschirme klicken, um eine Ablaufverfolgung zu untersuchen und einen Drilldown zu interessierenden Metriken durchzuführen. Auf den meisten Seiten können Sie die Schaltfläche Filter (oben links auf dem Bildschirm) verwenden, um die Daten nach Attributen zu filtern. Beispiel:

Ein Bild der Firebase-Leistungsüberwachungsdaten, die nach Attributen gefiltert werden
  • Nach App-Version filtern , um Daten zu einer früheren Version oder Ihrer neuesten Version anzuzeigen
  • Nach Gerät filtern , um zu erfahren, wie ältere Geräte mit Ihrer App umgehen
  • Filtern Sie nach Land , um sicherzustellen, dass Ihr Datenbankspeicherort keine Auswirkungen auf eine bestimmte Region hat

Weitere Informationen zum Anzeigen von Daten für Ihre Traces .

Nächste Schritte

  • Zeigen Sie detaillierte Berichte von Benutzersitzungen an, in denen Sie eine bestimmte Ablaufverfolgung in einem Zeitleistenkontext anderer Ablaufverfolgungen sehen können, die während derselben Sitzung erfasst wurden.