Firebase is back at Google I/O on May 10! Register now

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

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Die Leistungsüberwachung sammelt Ablaufverfolgungen , um Ihnen bei der Überwachung der Leistung Ihrer App zu helfen. Eine Ablaufverfolgung ist ein Bericht von 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 auszuführen, z. B. 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 den Start- und Stopppunkten des Trace), aber Sie können auch benutzerdefinierte Metriken hinzufügen.

In Ihrem Code definieren Sie den Anfang und das Ende einer Ablaufverfolgung für benutzerdefinierten Code mithilfe der vom Performance Monitoring SDK bereitgestellten APIs.Traces für benutzerdefinierten Code können jederzeit gestartet werden, nachdem sie erstellt wurden, und sie sind Thread-sicher.

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

Sie können Daten aus diesen Ablaufverfolgungen auf der Unterregisterkarte Benutzerdefinierte Ablaufverfolgungen der Ablaufverfolgungstabelle anzeigen, die sich unten im Leistungs- Dashboard befindet (weitere Informationen zur Verwendung der Konsole finden Sie weiter unten auf dieser Seite).

Standardattribute, benutzerdefinierte Attribute und benutzerdefinierte Metriken

Für benutzerdefinierte Codeablaufverfolgungen protokolliert die Leistungsüberwachung automatisch Standardattribute (gemeinsame Metadaten wie App-Version, Land, Gerät usw.), sodass Sie die Daten für die Ablaufverfolgung in der Firebase-Konsole filtern können. Sie können auch benutzerdefinierte Attribute (z. B. Spiellevel oder Benutzereigenschaften) hinzufügen und überwachen.

Sie können eine Ablaufverfolgung für benutzerdefinierten Code weiter konfigurieren, um benutzerdefinierte Metriken für leistungsbezogene Ereignisse aufzuzeichnen, die im Geltungsbereich der Ablaufverfolgung auftreten. Sie können beispielsweise eine benutzerdefinierte Metrik für die Anzahl der Cache-Treffer und -Fehlschläge oder die Häufigkeit erstellen, mit der die Benutzeroberfläche für einen merklichen 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 Performance Monitoring Trace API ( Swift | Obj-C ), um benutzerdefinierte Code-Traces hinzuzufügen, um bestimmten Anwendungscode zu überwachen.

Beachte das Folgende:

  • Eine App kann mehrere benutzerdefinierte Codeablaufverfolgungen aufweisen.
  • Es kann mehr als eine Ablaufverfolgung für benutzerdefinierten Code gleichzeitig ausgeführt werden.
  • Namen für benutzerdefinierte Codeablaufverfolgungen müssen die folgenden Anforderungen erfüllen: keine führenden oder abschließenden Leerzeichen, kein führender Unterstrich ( _ ) und eine maximale Länge von 100 Zeichen.
  • Traces für benutzerdefinierten Code unterstützen das Hinzufügen von benutzerdefinierten Metriken und benutzerdefinierten Attributen .

Um eine Ablaufverfolgung für benutzerdefinierten Code zu starten und zu stoppen, umschließen Sie den zu verfolgenden Code mit Codezeilen ähnlich der folgenden:

Schnell

Hinweis: Dieses Firebase-Produkt ist auf macOS-, Mac Catalyst- und watchOS-Zielen nicht verfügbar.
// 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

Hinweis: Dieses Firebase-Produkt ist auf macOS-, Mac Catalyst- und watchOS-Zielen nicht verfügbar.
// 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 benutzerdefinierte Metriken zu benutzerdefinierten Code-Traces hinzu

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

Beachte das Folgende:

  • Namen für benutzerdefinierte Metriken müssen die folgenden Anforderungen erfüllen: keine führenden oder abschließenden Leerzeichen, kein führender Unterstrich ( _ ) und eine maximale Länge von 100 Zeichen.
  • Jede Ablaufverfolgung für benutzerdefinierten Code kann bis zu 32 Metriken aufzeichnen (einschließlich der standardmäßigen Duration- Metrik).

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

Schnell

Hinweis: Dieses Firebase-Produkt ist auf macOS-, Mac Catalyst- und watchOS-Zielen nicht verfügbar.
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

Hinweis: Dieses Firebase-Produkt ist auf macOS-, Mac Catalyst- und watchOS-Zielen nicht verfügbar.
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 Codeablaufverfolgungen

Verwenden Sie die Performance Monitoring Trace API ( Swift | Obj-C ), um benutzerdefinierte Attribute zu benutzerdefinierten Code-Traces hinzuzufügen.

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

Beachte das Folgende:

  • Namen für benutzerdefinierte Attribute müssen die folgenden Anforderungen erfüllen:

    • Keine führenden oder abschließenden Leerzeichen, kein führender Unterstrich ( _ ).
    • Kein Platz
    • Die maximale Länge beträgt 32 Zeichen
    • Erlaubte Zeichen für den Namen sind AZ , az und _ .
  • Jede Ablaufverfolgung für benutzerdefinierten Code kann bis zu 5 benutzerdefinierte Attribute aufzeichnen.

  • Bitte stellen Sie sicher, dass benutzerdefinierte Attribute keine Informationen enthalten, die eine Person für Google persönlich identifizieren.

    Erfahren Sie mehr über diese Richtlinie

Schnell

Hinweis: Dieses Firebase-Produkt ist auf macOS-, Mac Catalyst- und watchOS-Zielen nicht verfügbar.
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

Hinweis: Dieses Firebase-Produkt ist auf macOS-, Mac Catalyst- und watchOS-Zielen nicht verfügbar.
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 Metriken entwickeln, fügen Sie sie zu Ihrem Metrik-Board oben im Leistungs- Dashboard hinzu. 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-Boards im Firebase Performance Monitoring-Dashboard

Führen Sie die folgenden Schritte aus, um Ihrem Metrik-Board eine Metrik hinzuzufügen:

  1. Rufen Sie das Leistungs- Dashboard in der Firebase-Konsole auf.
  2. Klicken Sie auf eine leere Metrikkarte und wählen Sie dann eine vorhandene Metrik aus, die Sie Ihrem Board hinzufügen möchten.
  3. Klicken Sie auf einer ausgefüllten Metrikkarte auf , um weitere Optionen anzuzeigen, z. B. um eine Metrik zu ersetzen oder zu entfernen.

Das Metrik-Board zeigt gesammelte Metrikdaten im Laufe der Zeit, sowohl in grafischer Form als auch als numerische prozentuale Veränderung.

Erfahren Sie mehr über die Verwendung des Dashboards .

Traces und ihre Daten anzeigen

Um Ihre Ablaufverfolgungen anzuzeigen, gehen Sie zum Leistungs- Dashboard in der Firebase-Konsole, scrollen Sie nach unten zur Ablaufverfolgungstabelle und klicken Sie dann auf die entsprechende Unterregisterkarte. Die Tabelle zeigt einige Top-Metriken für jede Ablaufverfolgung, und Sie können die Liste sogar nach der prozentualen Änderung für eine bestimmte Metrik sortieren.

Die Leistungsüberwachung bietet eine Fehlerbehebungsseite in der Firebase-Konsole, die Metrikänderungen hervorhebt, sodass Sie die Auswirkungen von Leistungsproblemen auf Ihre Apps und Benutzer schnell beheben und minimieren können. Sie können die Seite zur Problembehandlung verwenden, wenn Sie Informationen zu potenziellen Leistungsproblemen erhalten, z. B. in den folgenden Szenarien:

  • Sie wählen relevante Metriken auf dem Dashboard aus und stellen ein großes Delta fest.
  • In der Ablaufverfolgungstabelle sortieren Sie, um die größten Deltas ganz oben anzuzeigen, und Sie sehen eine signifikante prozentuale Änderung.
  • Sie erhalten eine E-Mail-Benachrichtigung, die Sie über ein Leistungsproblem informiert.

Sie können auf folgende Weise auf die Fehlerbehebungsseite zugreifen:

  • Klicken Sie im Metrik-Dashboard auf die Schaltfläche Metrikdetails anzeigen .
  • Wählen Sie auf einer beliebigen Metrikkarte => Details anzeigen aus. Auf der Fehlerbehebungsseite werden Informationen zu der ausgewählten Metrik angezeigt.
  • Klicken Sie in der Ablaufverfolgungstabelle auf einen Ablaufverfolgungsnamen oder einen beliebigen Metrikwert in der Zeile, die dieser Ablaufverfolgung zugeordnet ist.
  • Klicken Sie in einer E-Mail-Benachrichtigung auf Jetzt untersuchen .

Wenn Sie in der Trace-Tabelle auf einen Trace-Namen klicken, können Sie einen Drilldown zu relevanten Metriken durchführen. Klicken Sie auf die Schaltfläche Filter , 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 Spuren .

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.