Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Benutzerdefinierte Überwachung für bestimmten App-Code hinzufügen

Performance sammelt Spuren überwachen, damit Sie die Leistung Ihrer App überwachen. Ein Trace ist ein Bericht mit Leistungsdaten, die zwischen zwei Zeitpunkten in Ihrer App erfasst wurden.

Sie können Ihre eigenen Ablaufverfolgungen erstellen, um Leistungsdaten zu überwachen, die mit bestimmtem Code in Ihrer App verknüpft sind. Mit einem benutzerdefinierten Code Trace können Sie messen , wie lange es Ihre Anwendung dauert eine bestimmte Aufgabe oder eine Reihe von Aufgaben zu erledigen, zum Beispiel eine Reihe von Bildern Laden oder Ihre Datenbank abfragt.

Die Standard - Metrik für eine benutzerdefinierte Code Trace ist die „Dauer“ (die Zeit zwischen den Anfangs- und Endpunkten der Kurve), aber Sie können benutzerdefinierte Messwerte als auch hinzufügen.

In Ihrem Code definieren Sie den Anfang und das Ende einer benutzerdefinierten Codeablaufverfolgung mithilfe der APIs, die vom Performance Monitoring SDK bereitgestellt werden.Bei Android - Apps können Sie auch spezifische Methoden überwachen , um die Verwendung von @AddTrace Anmerkung .Spuren Individuelle Code kann jederzeit , nachdem sie erstellt habe gestartet werden, und sie sind threadsicher.

Da die für diese Traces erfasste Standardmetrik "Dauer" ist, werden sie manchmal als "Dauer-Traces" bezeichnet.

Sie können Daten aus diesen Spuren in den Custom Spuren Subreiter der Spuren Tabelle anzuzeigen, die am unteren Rande der Performance Dashboard ist (weitere Informationen über die Konsole später auf dieser Seite).

Standardattribute, benutzerdefinierte Attribute und benutzerdefinierte Metriken

Für Spuren benutzerdefinierten Code, Leistungsüberwachung protokolliert automatisch Standardattribute (gemeinsame Metadaten wie App - Version, Land, Gerät, etc.) , so dass Sie die Daten für die Spur in der Firebase Konsole filtern. Sie können auch hinzufügen und Monitor benutzerdefinierte Attribute (wie Spiel - Ebene oder Benutzereigenschaften).

Sie können weiterhin einen benutzerdefinierten Code Trace Aufzeichnung konfigurieren benutzerdefinierte Messwerte für leistungsbezogene Ereignisse , die innerhalb der Spur des Oszilloskops auftreten. Sie können beispielsweise eine benutzerdefinierte Metrik für die Anzahl der Cache-Treffer und -Fehltreffer oder die Häufigkeit, mit der die Benutzeroberfläche für einen merklichen Zeitraum nicht mehr reagiert, erstellen.

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

Benutzerdefinierte Code-Traces hinzufügen

Verwenden Sie die Performance - Überwachung Trace - API benutzerdefinierten Code Spuren hinzufügen spezifischen Anwendungscode zu überwachen.

Beachten Sie das Folgende:

  • Eine App kann mehrere benutzerdefinierte Code-Traces haben.
  • Es können mehrere benutzerdefinierte Codeablaufverfolgungen gleichzeitig ausgeführt werden.
  • Namen für Spuren benutzerdefinierte Code muss die folgenden Anforderungen erfüllen: keine führende oder nachfolgende Leerzeichen, keine führende Unterstrich ( _ ) Zeichen und maximale Länge beträgt 100 Zeichen.
  • Benutzerdefinierte Code Spuren unterstützen das Hinzufügen benutzerdefinierten Metriken und benutzerdefinierte Attribute .

So starten und eine benutzerdefinierte Code Trace zu stoppen, wickeln Sie den Code, den Sie mit Codezeilen verfolgen möchten ähnlich der folgenden ( in diesem Beispiel verwendet eine benutzerdefinierte Trace - Namen 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 = Firebase.performance.newTrace("test_trace")
myTrace.start()

// code that you want to trace

myTrace.stop()

(Optional) Monitor - spezifische Methoden @AddTrace mit

Android Apps auch die Unterstützung @AddTrace Anmerkung zum Instrument benutzerdefinierten Code Spuren. Mit dieser Funktion beginnt die Ablaufverfolgung am Anfang der angegebenen Methode und endet, wenn die Methode abgeschlossen ist, einschließlich aller von der Methode aufgerufenen.

Zum Beispiel können Sie eine benutzerdefinierte Code Trace genannt erstellen onCreateTrace , die ausgeführt wird, wenn die onCreate() Methode 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)
}

Benutzerdefinierte Metriken zu benutzerdefinierten Code-Traces hinzufügen

Verwenden Sie die Performance - Überwachung Trace - API -Messwerte , um benutzerdefinierten Code Spuren hinzuzufügen.

Beachten Sie das Folgende:

  • Namen für benutzerdefinierte Messwerte müssen die folgenden Anforderungen erfüllen: keine führende oder nachfolgende Leerzeichen, keine führende Unterstrich ( _ ) Zeichen und maximale Länge 100 Zeichen ist.
  • Jeder benutzerdefinierte Code Trace kann bis zu 32 Messwerte (einschließlich der Standardlaufzeit metric) aufzuzeichnen.

Um eine benutzerdefinierte Metrik hinzuzufügen, fügen Sie jedes Mal, wenn das Ereignis eintritt, eine Codezeile ähnlich der folgenden hinzu. Zum Beispiel dieser benutzerdefinierten Metrik zählt leistungsbezogene Ereignisse , die in Ihrer Anwendung, wie Cache - Treffer und Fehlschüsse (mit Beispiel Ereignisnamen auftreten item_cache_hit und item_cache_miss und ein Zuwachs 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 = Firebase.performance.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 - Überwachung Trace - API benutzerdefinierte Attribute , um benutzerdefinierte Code Spuren hinzuzufügen.

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

Beachten Sie das Folgende:

  • Namen für benutzerdefinierte Attribute müssen die folgenden Anforderungen erfüllen: keine führende oder nachfolgende Leerzeichen, keine führende Unterstrich ( _ ) Zeichen und maximale Länge 32 Zeichen ist.

  • 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

Firebase.performance.newTrace("test_trace").trace {
    // Update scenario.
    putAttribute("experiment", "A")

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

    // Delete scenario.
    removeAttribute("experiment")

    // Read attributes.
    val traceAttributes = this.attributes
}

Leistungsdaten verfolgen, anzeigen und filtern

Verfolgen Sie bestimmte Metriken in Ihrem Dashboard

Um zu erfahren , wie Sie Ihre wichtigsten Kennzahlen sind Trending, fügen Sie sie in Ihre Metriken Board an der Spitze der Performance - Dashboard. Sie können Regressionen schnell erkennen, indem Sie Änderungen von Woche zu Woche anzeigen oder überprüfen, ob die jüngsten Änderungen in Ihrem Code die Leistung verbessern.

ein Bild des Metrik-Boards im Firebase Performance Monitoring-Dashboard

Um eine Metrik zu Ihrer Metriken Board hinzuzufügen, gehen Sie auf die Performance - Dashboard in der Konsole Firebase und dann auf die Registerkarte Dashboard. Klicken Sie auf eine leere Messwertkarte und wählen Sie dann einen vorhandenen Messwert aus, den Sie zu Ihrem Board hinzufügen möchten. Klicken Sie auf einer bevölkerten metric Karte für mehr Optionen, wie eine Metrik zu ersetzen oder zu entfernen.

Das Metrics Board zeigt gesammelte Metrikdaten im Zeitverlauf sowohl in grafischer Form als auch als numerische prozentuale Veränderung an.

Erfahren Sie mehr über das Dashboard .

Anzeigen von Spuren und deren Daten

Um Ihre Spuren, gehen Sie zur Ansicht Performance - Dashboard in der Firebase Konsole, scrollen Sie nach unten auf die Spuren Tabelle, und klicken Sie auf den entsprechenden Unterreiter. Die Tabelle zeigt einige der wichtigsten Metriken für jeden Trace an, und Sie können die Liste sogar nach der prozentualen Änderung für eine bestimmte Metrik sortieren.

Wenn Sie in der Trace-Tabelle auf einen Trace-Namen klicken, können Sie durch verschiedene Bildschirme klicken, um den Trace zu durchsuchen und die relevanten Metriken aufzuschlüsseln. Auf den meisten Seiten, können Sie die Filter verwenden - Taste (oben links auf dem Bildschirm) , um die Daten , die durch Attribut, zum Beispiel zu filtern:

ein Bild von Firebase Performance Monitoring-Daten, die nach Attributen gefiltert werden
  • Filter nach App - Version Ansicht Daten über eine Vergangenheit Veröffentlichung oder Ihre neueste Version
  • Filter nach Gerät zu erfahren , wie ältere Geräte handhaben Ihre App
  • Filter nach Land um sicherzustellen , dass Ihre Datenbank Lage ist nicht auf eine bestimmte Region zu beeinflussen

Erfahren Sie mehr über Daten für Ihre Spuren sehen .

Nächste Schritte

  • Sehen Sie detaillierte Berichte von Benutzersitzungen , in denen Sie eine bestimmte Spur in einem Timeline Zusammenhang mit anderen Spuren gesammelt während der gleichen Sitzung sehen.