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.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 ( Swift | Obj-C ) 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 .

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 den Performance - Überwachung Trace - API ( Swift | Obj-C ) benutzerdefinierte Metriken , 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. 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" byInt: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 - Überwachung Trace - API ( Swift | Obj-C ) benutzerdefinierte Attribute hinzufügen , um benutzerdefinierte Code Spuren.

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

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 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.