Perfetto

perfetto ist ein Tool, mit dem Sie über die Android Debug Bridge (ADB) Leistungsinformationen von Android-Geräten erfassen können. Rufen Sie das perfetto-Tool mit dem Befehl adb shell perfetto ... auf. perfetto verwendet verschiedene Quellen, um Leistungs-Traces von Ihrem Gerät zu erfassen, z. B.:

  • ftrace für Informationen aus dem Kernel
  • atrace für die Annotation im Nutzerbereich in Diensten und Anwendungen
  • heapprofd für Informationen zur nativen Speichernutzung von Diensten und Apps

Auf dieser Seite wird beschrieben, wie Sie perfetto aufrufen und so konfigurieren, dass die gewünschte Ausgabe generiert wird. Weitere Informationen finden Sie in der Dokumentation zu perfetto.

Syntax

In diesem Abschnitt wird beschrieben, wie Sie mit ADB perfetto für verschiedene Modi aufrufen und einen Trace generieren.

Auswahl der Datenquelle

perfetto umfasst die folgenden beiden Modi, die die Datenquellen bestimmen, die zum Aufzeichnen des Trace verwendet werden:

  • heller Modus: Es kann nur eine Teilmenge von Datenquellen ausgewählt werden, insbesondere atrace und ftrace. Dieser Modus bietet jedoch eine Oberfläche, die systrace ähnelt.
  • Normaler Modus: Die Konfiguration wird in einem Protokollzwischenspeicher abgerufen. Sie können mehr Funktionen von perfetto nutzen, indem Sie andere Datenquellen als atrace und ftrace verwenden.

Allgemeine Optionen

In der folgenden Tabelle sind die verfügbaren Optionen bei Verwendung von perfetto in beiden Modi aufgeführt:

Tabelle 1. Liste der verfügbaren allgemeinen perfetto-Tooloptionen.

Option Beschreibung
--background |
-d
perfetto beendet die Befehlszeile sofort und zeichnet den Trace im Hintergrund weiter auf.
--background-wait | -D Wie --background, wartet aber (bis zu 30 Sekunden), bis alle Datenquellen gestartet wurden, bevor der Vorgang beendet wird. Der Exit-Code ist null, wenn eine erfolgreiche Bestätigung empfangen wird, andernfalls ungleich null (Fehler oder Zeitüberschreitung).
--alert-id ID der Benachrichtigung, die diesen Trace ausgelöst hat.
--config-id ID der auslösenden Konfiguration.
--config-uid UID der App, die die Konfiguration registriert hat.
--subscription-id ID des Abos, das diesen Trace ausgelöst hat.
--out OUT_FILE |
-o OUT_FILE

Gibt den gewünschten Pfad zur Ausgabe-Trace-Datei oder - für stdout an. perfetto schreibt die Ausgabe in die Datei, die in den vorherigen Flags beschrieben wurde. Das Ausgabeformat entspricht dem in AOSP trace.proto definierten Format.

Hinweis: Sie müssen den vollständigen Pfadnamen der Ausgabedatei angeben. Normalerweise sollten die Dateien in den Ordner /data/misc/perfetto-traces geschrieben werden.

--upload Nach Abschluss wird der Trace an das Paket übergeben, das in der IncidentReportConfig-Nachricht in der Proto-Trace-Konfiguration angegeben ist.
--no-guardrails Deaktiviert den Schutz vor übermäßiger Ressourcennutzung, wenn das Flag --upload während des Tests aktiviert wird.
--reset-guardrails Setzt den persistenten Status der Schutzmaßnahmen zurück und beendet den Test.
--rsave-for-bugreport Wenn ein Trace mit bugreport_score > 0 ausgeführt wird, wird der Trace in einer Datei gespeichert. Gibt den Pfad aus, wenn der Vorgang abgeschlossen ist.
--query Fragt den Dienststatus ab und gibt ihn als menschenlesbaren Text aus.
--query-raw Ähnlich wie --query, gibt aber die roh-proto-codierten Byte von tracing_service_state.proto. aus
--help | -h Gibt den Hilfetext für das perfetto-Tool aus.

Heller Modus

Die allgemeine Syntax für die Verwendung von perfetto im hellen Modus lautet wie folgt:

 adb shell perfetto [ --time TIMESPEC ] [ --buffer SIZE ] [ --size SIZE ]
             [ ATRACE_CAT | FTRACE_GROUP/FTRACE_NAME | FTRACE_GROUP/* ]...
             --out FILE

In der folgenden Tabelle sind die verfügbaren Optionen aufgeführt, wenn Sie perfetto im hellen Modus verwenden:

Tabelle 2. Liste der verfügbaren perfetto-Tooloptionen im hellen Modus.

Option Beschreibung
--time TIME[s|m|h] |
-t TIME[s|m|h]
Gibt die Trace-Dauer in Sekunden, Minuten oder Stunden an. Beispiel: --time 1m gibt eine Trace-Dauer von 1 Minute an. Die Standarddauer beträgt 10 Sekunden.
--buffer SIZE[mb|gb] |
-b SIZE[mb|gb]
Gibt die Größe des Ringpuffers in Megabyte (MB) oder Gigabyte (GB) an. Der Standardparameter ist --buffer 32mb.
--size SIZE[mb|gb] |
-s SIZE[mb|gb]
Gibt die maximale Dateigröße in Megabyte (MB) oder Gigabyte (GB) an. Standardmäßig verwendet perfetto nur den Ringpuffer im Arbeitsspeicher.
--app | -a Android-App-Name (atrace)

Auf diese Optionen folgt eine Liste von Ereignisspezifizierern:

Tabelle 3 Liste der Ereignisspezifizierer für den hellen Modus.

Ereignis Beschreibung
ATRACE_CAT Gibt die atrace-Kategorien an, für die ein Trace aufgezeichnet werden soll. Mit dem folgenden Befehl wird beispielsweise der Window Manager mit atrace verfolgt:
    adb shell perfetto --out FILE wm
    

Informationen zum Aufzeichnen anderer Kategorien finden Sie in dieser Liste der atrace-Kategorien.

FTRACE_GROUP/FTRACE_NAME Gibt die ftrace-Ereignisse an, für die Sie einen Trace aufzeichnen möchten. Mit dem folgenden Befehl werden beispielsweise sched/sched_switch-Ereignisse verfolgt:
      adb shell perfetto --out FILE sched/sched_switch
      

Normaler Modus

Die allgemeine Syntax für die Verwendung von perfetto im normalen Modus lautet:

 adb shell perfetto [ --txt ] --config CONFIG_FILE --out FILE

In der folgenden Tabelle sind die verfügbaren Optionen aufgeführt, wenn Sie perfetto im normalen Modus verwenden:

Tabelle 4. Liste der verfügbaren perfetto-Tooloptionen im normalen Modus.

Option Beschreibung
--config CONFIG_FILE | -c CONFIG_FILE Gibt den Pfad zu einer Konfigurationsdatei an. Im normalen Modus können einige Konfigurationen in einem Konfigurationsprotokollzwischenspeicher codiert sein. Diese Datei muss dem im AOSP trace_config.proto definierten Protokollzwischenspeicher-Schema entsprechen.

Wähle die Datenquellen aus und konfiguriere sie mit dem DataSourceConfig-Mitglied von TraceConfig, wie im AOSP data_source_config.proto definiert.

--txt Weist perfetto an, die Konfigurationsdatei als pbtxt zu parsen. Dieses Flag ist nur für lokale Tests vorgesehen und sollte nicht für die Produktion aktiviert werden.

Unterstützte Datenquellen

In diesem Abschnitt werden die verschiedenen Quellen beschrieben, die perfetto zum Generieren des Traces verwendet.

ftrace

Mit der Datenquelle ftrace kann perfetto Ereignisse aus dem Kernel abrufen.

Aktivieren Sie diese Quelle, indem Sie ftrace_config in der DataSourceConfig festlegen.

Folgende Ereignisse können aktiviert werden:

  • Planungsaktivität:

    • sched/sched_switch
    • sched/sched_wakeup
    • sched/sched_wakeup_new
    • sched/sched_process_exec
    • sched/sched_process_exit
    • sched/sched_process_fork
    • sched/sched_process_free
    • sched/sched_process_hang
    • sched/sched_process_wait
  • Dateisystemereignisse:

  • atrace Ereignisse

Je nach Gerät, Betriebssystemversion oder Kernel sind möglicherweise weitere Ereignisse verfügbar. Weitere Informationen finden Sie in den Konfigurations-Protokollzwischenspeichern.

Prozessstatistiken

Mit der Datenquelle „Prozessstatistiken“ können Sie abgefragte Zähler zum System und zu einzelnen Prozessen abrufen.

Aktivieren Sie diese Quelle, indem Sie process_stats_config und sys_stats_config in der DataSourceConfig festlegen.

Die von perfetto generierten Daten umfassen:

  • Systemweit

    • /proc/meminfo
    • /proc/vmstat
    • /proc/stat
  • Pro Prozess

    • /proc/\<pid\>/status
    • /proc/\<pid\>/oom_score_adj

Je nach Gerät, Betriebssystemversion und Kernel sind möglicherweise weitere Ereignisse verfügbar. Weitere Informationen finden Sie in den Konfigurations-Protos für sys_stats und process_stats.

heapprofd

Mit heapprofd können Sie die Ursachen der nativen Speichernutzung ermitteln.

Aktivieren Sie diese Quelle, indem Sie heapprofd_config in der DataSourceConfig festlegen. Diese Einstellung erzeugt ProfilePackets, einschließlich der Java-Frames des Aufrufstacks.

Weitere Informationen zur Verwendung von heapprofd finden Sie unter perfetto.dev.

Andere Quellen

Je nach Gerät, Betriebssystemversion und Kernel sind möglicherweise weitere Datenquellen verfügbar. Weitere Informationen finden Sie in den Protokolldateien für die Datenquellenkonfiguration.

Weitere Informationen zu perfetto findest du unter perfetto.dev.