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.:
ftracefür Informationen aus dem Kernelatracefür die Annotation im Nutzerbereich in Diensten und Anwendungenheapprofdfü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.
Android-Kenntnisse
Auf GitHub ansehenAndroid Profiler
android skills add android-profilerSyntax
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
atraceundftrace. Dieser Modus bietet jedoch eine Oberfläche, diesystraceähnelt. - Normaler Modus: Die Konfiguration wird in einem Protokollzwischenspeicher abgerufen. Sie können mehr Funktionen von
perfettonutzen, indem Sie andere Datenquellen alsatraceundftraceverwenden.
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 |
|
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 |
|
Gibt den gewünschten Pfad zur Ausgabe-Trace-Datei oder Hinweis: Sie müssen den vollständigen Pfadnamen der Ausgabedatei angeben. Normalerweise sollten die Dateien in den Ordner |
--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] |
|
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] |
|
Gibt die Größe des Ringpuffers in Megabyte (MB) oder Gigabyte (GB) an.
Der Standardparameter ist --buffer 32mb.
|
--size 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 |
| 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 |
--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:
-
sched/sched_switchsched/sched_wakeupsched/sched_wakeup_newsched/sched_process_execsched/sched_process_exitsched/sched_process_forksched/sched_process_freesched/sched_process_hangsched/sched_process_wait
Dateisystemereignisse:
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:
-
/proc/meminfo/proc/vmstat/proc/stat
-
/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.