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 Ablaufverfolgungen, 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 Ihre eigenen 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 auszuführen, 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. 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 erfasste 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 Leistungsüberwachungs-Trace-API ( Swift | Obj-C ), 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:

Schnell

// Add the Performance Monitoring module to your header
import FirebasePerformance

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

// code that you want to trace

trace.stop()

Ziel c

// Add the Performance Monitoring module to your header
@import FirebasePerformance;

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

// code that you want to trace

[trace stop];

Fügen Sie benutzerdefinierten Metriken benutzerdefinierte Metriken hinzu

Verwenden Sie die Trace-API für die Leistungsüberwachung ( Swift | Obj-C ), 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 oder Wiederholungsversuche.

Schnell

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.incrementMetric(named:"EVENT_NAME", by: 1)
// code that you want to trace (and log custom metrics)

trace.stop()

Ziel c

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace incrementMetric:@"EVENT_NAME" by:1];
// code that you want to trace (and log custom metrics)

[trace stop];

Erstellen Sie benutzerdefinierte Attribute für benutzerdefinierte Code-Traces

Verwenden Sie die Leistungsüberwachungs-Trace-API ( Swift | Obj-C ), um benutzerdefinierten Code-Traces 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

Schnell

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.setValue("A", forAttribute: "experiment")

// Update scenario.
trace.setValue("B", forAttribute: "experiment")

// Reading scenario.
let experimentValue:String? = trace.valueForAttribute("experiment")

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

// Read attributes.
let attributes:[String, String] = trace.attributes;

Ziel c

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace setValue:@"A" forAttribute:@"experiment"];

// Update scenario.
[trace setValue:@"B" forAttribute:@"experiment"];

// Reading scenario.
NSString *experimentValue = [trace valueForAttribute:@"experiment"];

// Delete scenario.
[trace removeAttribute:@"experiment"];

// Read attributes.
NSDictionary <NSString *, NSString *> *attributes = [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 erkennen, 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.