Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

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

Die Leistungsüberwachung erfasst Ablaufverfolgungen , um Sie bei der Überwachung der Leistung Ihrer App zu unterstützen. 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 Ihre App benötigt, um eine bestimmte Aufgabe oder eine Reihe von Aufgaben abzuschließen, beispielsweise das Laden einer Reihe von Bildern oder das Abfragen Ihrer Datenbank.

Die Standardmetrik für einen benutzerdefinierten Code-Trace ist seine "Dauer" (die Zeit zwischen dem Start- und Endpunkt des Trace), aber Sie können auch benutzerdefinierte Metriken 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. Benutzerdefinierte Codeablaufverfolgungen können nach ihrer Erstellung jederzeit gestartet werden und 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 Ablaufverfolgungen im Unterregister Benutzerdefinierte Ablaufverfolgungen der Ablaufverfolgungstabelle anzeigen, die sich unten im Leistungs- Dashboard befindet (weitere Informationen zur Verwendung der Konsole später auf dieser Seite).

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.), damit Sie die Daten für den Trace in der Firebase-Konsole filtern können. Sie können auch benutzerdefinierte Attribute (wie Spielebene oder Benutzereigenschaften) hinzufügen und überwachen.

Sie können einen benutzerdefinierten Code-Trace weiter konfigurieren, um benutzerdefinierte Metriken für leistungsbezogene Ereignisse aufzuzeichnen, die innerhalb des Bereichs der Ablaufverfolgung 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 Monitoring Trace API ( Swift | Obj-C ), um benutzerdefinierte Codetraces hinzuzufügen, um bestimmten Anwendungscode zu überwachen.

Beachte das Folgende:

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

Um eine benutzerdefinierte Codeablaufverfolgung zu starten und zu stoppen, umschließen Sie den zu verfolgenden Code mit Codezeilen ähnlich der folgenden:

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];

Benutzerdefinierte Metriken zu benutzerdefinierten Code-Traces hinzufügen

Verwenden Sie die Leistungsüberwachungs-Trace-API ( Swift | Obj-C ), um benutzerdefinierten Code-Traces benutzerdefinierte Metriken hinzuzufügen.

Beachte das Folgende:

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

Um eine benutzerdefinierte Metrik hinzuzufügen, fügen Sie jedes Mal, wenn das Ereignis eintritt, eine Codezeile ähnlich der folgenden hinzu. Diese benutzerdefinierte Metrik zählt beispielsweise leistungsbezogene Ereignisse, die in Ihrer App auftreten, wie Cache-Treffer oder -Wiederholungen.

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 Performance Monitoring Trace API ( Swift | Obj-C ), um benutzerdefinierten Codetraces benutzerdefinierte Attribute 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.

Beachte das Folgende:

  • Namen für benutzerdefinierte Attribute müssen die folgenden Anforderungen erfüllen: kein führendes oder nachgestelltes Leerzeichen, kein führender Unterstrich ( _ ) und die maximale Länge beträgt 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];

Leistungsdaten verfolgen, anzeigen und filtern

Verfolgen Sie bestimmte Metriken in Ihrem Dashboard

Um zu erfahren, wie sich Ihre wichtigsten Kennzahlen entwickeln, fügen Sie sie zu Ihrem Kennzahlen-Board oben im Leistungs- Dashboard hinzu. 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 Ihrem Metriken-Board einen Messwert hinzuzufügen, rufen Sie das Leistungs- Dashboard in der Firebase-Konsole auf und klicken Sie 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 auf einer auf , um weitere Optionen einen 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 die Verwendung des Dashboards .

Anzeigen von Spuren und deren Daten

Um Ihre Traces anzuzeigen, rufen Sie das Performance- Dashboard in der Firebase-Konsole auf, scrollen Sie nach unten zur Trace-Tabelle und klicken Sie dann auf den entsprechenden Unter-Tab. 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 Schaltfläche zum Filtern (oben links auf dem Bildschirm) verwenden, um die Daten nach Attributen zu filtern, zum Beispiel:

ein Bild von Firebase Performance Monitoring-Daten, die nach Attributen gefiltert werden
  • Filtern Sie nach App-Version , um Daten zu einer früheren Version oder Ihrer neuesten Version anzuzeigen
  • Filtern Sie nach Gerät , um zu erfahren, wie ältere Geräte mit Ihrer App umgehen
  • Filtern Sie nach Land , um sicherzustellen, dass sich Ihr Datenbankstandort nicht auf eine bestimmte Region auswirkt

Erfahren Sie mehr über das Anzeigen von Daten für Ihre Traces .

Nächste Schritte

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