Leistungsdaten erheben

Der native Watchdog-Dienst erfasst seit der frühen Initialisierung während des Systemstarts Daten zur E/A-Leistung. Der native Dienst speichert die erfassten Leistungsdaten im Fehlerbericht. Anbieter können den nativen Dienst über „dumpsys“ abfragen, um die erfassten Daten zu speichern oder eine benutzerdefinierte Erfassungssitzung für das Debugging zu starten.

Häufigkeit der Datenerhebung

Die Häufigkeit der Erhebung von Leistungsdaten variiert je nach Build-Typ.

  • Bei Userdebug- oder Eng-Builds erhebt Watchdog während des Systemstarts einmal pro Sekunde Leistungsdaten und nach Abschluss des Starts einmal pro Minute.
  • Bei User-Builds erhebt Watchdog während des Systemstarts einmal alle 20 Sekunden Leistungsdaten und nach Abschluss des Starts einmal alle zwei Minuten.

Ereignisse zur Datenerhebung

Die stichprobenbasierte Profilerstellung wird bei verschiedenen Systemereignissen (z. B. Systemstart, Systemaktivierung und Nutzerwechsel) und im Fenster der letzten N Minuten durchgeführt.

  • Ereignisse der letzten N Minuten vor der Erstellung des Fehlerberichts:Werden in einem gleitenden Fenster von 30 Minuten generiert.
  • Ereignisse zur Startzeit:Werden nach dem Start generiert.
  • Ereignisse zum Nutzerwechsel:Werden nach dem Start eines Nutzerwechsels generiert.
  • Benutzerdefinierte Erfassungsereignisse: Hier können Sie den Abfragezeitraum und die maximale Dauer angeben und nach Paketen filtern.

Leistungsdaten speichern

Wenn ein Fehlerbericht erfasst wird, speichert der native Watchdog-Dienst die erfassten Leistungsdaten im Fehlerbericht. Anbieter können den nativen Dienst über den folgenden „dumpsys“-Befehl abfragen, um die erfassten Leistungsdaten zu speichern. Weitere Informationen zum Bericht finden Sie im Abschnitt Leistungsdatenbericht.

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default > /tmp/carwatchdog_dump.txt

Leistungsdaten für das Debugging erheben

Anbieter können den nativen Watchdog-Dienst verwenden, um benutzerdefinierte Leistungsdaten für das Debugging zu erheben. Wenn sie beispielsweise die E/A-Nutzung einer App oder eines Dienstes analysieren möchten, können sie eine benutzerdefinierte Erhebung von Leistungsdaten durchführen, bei der die E/A-Nutzung einer bestimmten Liste von Paketen oder des gesamten Systems profiliert wird.

Benutzerdefinierte Erfassungssitzung starten

Im Folgenden finden Sie den Befehl zum Starten einer benutzerdefinierten Erfassungssitzung für Leistungsdaten:

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --start_perf [--interval <seconds>] [--max_duration <seconds>] [--filter_packages <package_name>,<package_name>,...]
  • --start_perf startet eine benutzerdefinierte Erfassungssitzung für Leistungsdaten.
  • --interval <seconds> gibt das Profilerstellungsintervall an. Standardmäßig beträgt das Intervall 30 Sekunden.
  • --max_duration <seconds> gibt die maximale Dauer der benutzerdefinierten Erfassungssitzung für Leistungsdaten an. Wenn die Sitzung nicht manuell beendet wird, wird sie nach dieser Dauer beendet und die erfassten Daten werden verworfen. Standardmäßig beträgt die maximale Dauer 30 Minuten.
  • --filter_packages <package_name>,<package_name>... gibt eine durch Kommas getrennte Liste von Paketnamen an, die profiliert werden sollen. Wenn diese Option angegeben wird, ist die Erhebung von Leistungsdaten auf diese Pakete beschränkt. Andernfalls werden die Leistungsdaten für alle Pakete im System erhoben.

Mit dem folgenden Befehl wird beispielsweise eine benutzerdefinierte Erhebung von Leistungsdaten mit einem Profilerstellungsintervall von 10 Sekunden und einer maximalen Erhebung dauer von 1 Stunde gestartet. Die Profilerstellung ist auf die com.google.android.car.kitchensink und com.google.android.apps.maps Pakete beschränkt.

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --start_perf --interval 10 --max_duration 3600 --filter_packages com.google.android.car.kitchensink,com.google.android.apps.maps

Benutzerdefinierte Erfassungssitzung beenden und speichern

Nachdem die E/A-Nutzung einer relevanten App oder eines relevanten Dienstes aufgezeichnet wurde, sollten Anbieter die benutzerdefinierte Erfassungssitzung für Leistungsdaten beenden, um die erfassten Daten zu speichern. Mit diesem Befehl wird die benutzerdefinierte Erfassung von Leistungsdaten beendet und die erfassten Daten werden in /tmp/carwatchdog_dump.txt gespeichert:

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --stop-perf > /tmp/carwatchdog_custom_dump.txt

Hilfe zu „dumpsys“

So rufen Sie die Hilfe zu „dumpsys“ auf:

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --help

Im Proto-Format speichern

Optional können „dumpsys“-Daten im Proto-Format gespeichert werden:

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --proto

Leistungsdatenbericht

Weitere Informationen finden Sie im folgenden Beispielbericht zu Leistungsdaten:

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default

---------------------------------
WatchdogPerfService report:
---------------------------------
Boot-time collection information:
=================================
Event polling interval: 1 second

Wake-up collection information:
===============================
Event polling interval: 1 second

User-switch collection information:
===================================
Event polling interval: 1 second

Periodic collection information:
================================
Event polling interval: 60 seconds
---------------------------------------------------------------------------
Boot-time performance report:
=================================
No collection recorded
---------------------------------------------------------------------------
Wake-up performance report:
===========================
No collection recorded
---------------------------------------------------------------------------
User-switch events performance report:
======================================
No collection recorded
---------------------------------------------------------------------------
Last N minutes performance report:
======================================
Collection duration: 10800 seconds
Number of collections: 181

Collection 0: <Mon Oct  2 18:36:06 2023 GMT>
=============================================
Total CPU time (ms): 473210
Total CPU cycles: 39553152000
Total idle CPU time (ms)/percent: 435860 / 92.11%
CPU I/O wait time (ms)/percent: 0 / 0.00%
Number of context switches: 13723415093
Number of I/O blocked processes/percent: 0 / 0.00%

Top N CPU Times:
----------------
Android User ID, Package Name, CPU Time (ms), Percentage of total CPU time, CPU Cycles
    Command, CPU Time (ms), Percentage of UID's CPU Time, CPU Cycles
10, com.google.android.carassistant, 13357, 2.82%, 16409088000
    assistant:interactor, 13360, 100.02%, 16409088000
0, system, 9097, 1.92%, 9640512000
    sensors@1.0-ser, 3790, 41.66%, 3773184000
    system_server, 2760, 30.34%, 3135936000
    com.android.car, 1150, 12.64%, 1099584000
    binder:621_4, 1000, 10.99%, 1281024000
    surfaceflinger, 230, 2.53%, 245376000
0, audioserver, 4383, 0.93%, 4597248000
    Main, 2690, 61.37%, 2980416000
    binder:916_2, 950, 21.67%, 925056000
    audioserver, 720, 16.43%, 691776000
0, root, 4357, 0.92%, 3727872000
    irq/311-iam2068, 2630, 60.36%, 2471616000
    irq/26-90b6400., 370, 8.49%, 561024000
    kworker/u16:4-bwmon_wq, 290, 6.66%, 48960000
    kworker/u16:1-memlat_wq, 270, 6.20%, 0
    ipcdaemon, 220, 5.05%, 218304000
10, com.google.android.apps.geo.automotive.adas, 1509, 0.32%, 1756416000
    adas:publishing, 1490, 98.74%, 1735680000
    as:clientparams, 10, 0.66%, 20736000
0, com.android.vending, 796, 0.17%, 765504000
    android.vending, 790, 99.25%, 765504000
0, shared:com.google.uid.shared, 581, 0.12%, 481152000
    google.android.gms, 340, 58.52%, 237312000
    .gms.persistent, 190, 32.70%, 184512000
    process.gservices, 50, 8.61%, 59328000
0, gps, 507, 0.11%, 659136000
    binder:920_2, 500, 98.62%, 659136000
10, com.android.vending, 489, 0.10%, 372288000
    android.vending, 480, 98.16%, 372288000
0, shared:android.uid.systemui, 438, 0.09%, 449856000
    android.systemui, 440, 100.46%, 449856000

Top N Storage I/O Reads:
-------------
Android User ID, Package Name, Foreground Bytes, Foreground Bytes %, Foreground Fsync, Foreground Fsync %, Background Bytes, Background Bytes %, Background Fsync, Background Fsync %
0, root, 56123392, 81.95%, 1, 100.00%, 0, 0.00%, 0, 0.00%
0, system, 12333056, 18.01%, 0, 0.00%, 0, 0.00%, 0, 0.00%

Top N Storage I/O Writes:
-------------------------
Android User ID, Package Name, Foreground Bytes, Foreground Bytes %, Foreground Fsync, Foreground Fsync %, Background Bytes, Background Bytes %, Background Fsync, Background Fsync %
0, com.android.vending, 0, 0.00%, 0, 0.00%, 520192, 46.35%, 20, 47.62%
10, com.android.vending, 0, 0.00%, 0, 0.00%, 520192, 46.35%, 20, 47.62%
10, shared:com.google.uid.shared, 0, 0.00%, 0, 0.00%, 45056, 4.01%, 0, 0.00%
0, shared:com.google.uid.shared, 0, 0.00%, 0, 0.00%, 36864, 3.28%, 2, 4.76%
0, logd, 24576, 40.00%, 0, 0.00%, 0, 0.00%, 0, 0.00%
0, root, 20480, 33.33%, 0, 0.00%, 0, 0.00%, 0, 0.00%
0, system, 16384, 26.67%, 0, 0.00%, 0, 0.00%, 0, 0.00%

Top N I/O waiting UIDs:
-----------------------
Android User ID, Package Name, Number of owned tasks waiting for I/O, Percentage of owned tasks waiting for I/O
    Command, Number of I/O waiting tasks, Percentage of UID's tasks waiting for I/O
0, root, 2, 0.39%
    dp_hdcp2p2, 1, 50.00%
    hdcp_2x, 1, 50.00%

Top N major page faults:
------------------------
Android User ID, Package Name, Number of major page faults, Percentage of total major page faults
    Command, Number of major page faults, Percentage of UID's major page faults
0, com.android.vending, 104, 48.83%
    android.vending, 104, 100.00%
10, com.android.vending, 104, 48.83%
    android.vending, 104, 100.00%
0, shared:com.google.uid.shared, 4, 1.88%
    .gms.persistent, 4, 100.00%
10, shared:com.google.uid.shared, 1, 0.47%
    .gms.persistent, 1, 100.00%
Number of major page faults since last collection: 213
Percentage of change in major page faults since last collection: 0.00%

Wenn Sie einen Fehlerbericht erfassen, einen „dumpsys“-Befehl für Watchdog ohne Argumente ausführen oder eine benutzerdefinierte Erfassungssitzung beenden, speichert der native Watchdog-Dienst einen Leistungsdatenbericht, der dem oben genannten Bericht ähnelt.

Der Bericht enthält Daten, die während des Systemstarts und in den letzten N Minuten vor der Berichtserstellung erhoben wurden.

Element Beschreibung
Informationen zur Erhebung während des Starts Enthält Informationen zur Erfassungssitzung für Leistungsdaten während des Starts.
Informationen zur Erhebung während der Aktivierung Enthält Informationen zur Erfassungssitzung für Leistungsdaten während der Aktivierung, wenn das System aktiviert wird.
Informationen zur Erhebung während des Nutzerwechsels Enthält Informationen zur Erfassungssitzung für Leistungsdaten während des Nutzerwechsels, wenn ein Nutzerwechsel erfolgt.
Informationen zur regelmäßigen Erhebung Enthält Informationen zur regelmäßigen Erfassungssitzung für Leistungsdaten, die nach Abschluss des Starts beginnt.
Leistungsbericht zur Startzeit Enthält Leistungsdaten, die während des Systemstarts erhoben wurden. Diese Daten bleiben bis zum Herunterfahren des Systems im Arbeitsspeicher und werden daher in allen Berichten gespeichert.
Leistungsbericht zur Aktivierung Enthält Leistungsdaten, die während der Aktivierung erhoben wurden. Diese Daten bleiben bis zum Herunterfahren des Systems im Arbeitsspeicher und werden daher in allen Berichten gespeichert.
Leistungsbericht zum Nutzerwechsel Enthält Leistungsdaten, die während des Nutzerwechsels erhoben wurden. Diese Daten bleiben bis zum Herunterfahren des Systems im Arbeitsspeicher und werden daher in allen Berichten gespeichert.
Leistungsbericht zur E/A-Leistung der letzten N Minuten Enthält Leistungsdaten, die während der regelmäßigen Erfassungssitzung in den letzten N Minuten vor der Berichtserstellung erhoben wurden.
Dauer der Erhebung Gesamtdauer der Erhebung von Leistungsdaten.
Anzahl der Erhebungen Gesamtzahl der Erhebungen, die in einem einzelnen Bericht angegeben sind.

Jede im Bericht angegebene Erhebung kann alle oder einige der folgenden Abschnitte enthalten. Die in jeder Erhebung angegebenen Statistiken sind die Differenz seit der letzten Erhebung, mit Ausnahme der Statistiken, die sofort erhoben werden (z. B. nicht aggregiert seit dem Systemstart).

Element Beschreibung
CPU-E/A-Wartezeit/‑prozent Absolute CPU-Zeit und Prozentsatz der gesamten CPU-Zeit, die seit der letzten Erhebung für den Kontextwechsel oder das Warten aufgrund von E/A-Vorgängen aufgewendet wurde.
Gesamte CPU-Zeit Gesamte CPU-Zeit in Millisekunden.
Gesamte CPU-Leerlaufzeit Gesamte CPU-Zeit im Leerlauf.
CPU-E/A-Wartezeit Gesamtzeit, die die CPU mit dem Warten auf E/A-Vorgänge verbracht hat.
Anzahl der Kontextwechsel Anzahl der CPU-Wechsel von einem Prozess oder Thread zu einem anderen.
Anzahl der durch E/A blockierten Prozesse/Prozent Gesamtzahl der Prozesse, die auf E/A warten, und Prozentsatz der Prozesse, die auf E/A warten seit der letzten Erhebung.
Top N CPU-Zeiten

Die N Pakete, die seit der letzten Erhebung die meiste CPU-Zeit verbraucht haben:

  • Jede Zeile der obersten Ebene enthält die Nutzer-ID, den Paketnamen, die CPU-Zeit, den Prozentsatz der gesamten CPU-Zeit und die CPU-Zyklen.
  • Die Zeilen der unteren Ebene enthalten den Befehl, die CPU-Zeit, den Prozentsatz der CPU-Zeit der Nutzer-ID und die CPU Zyklen.
Top N der Speicher-E/A-Lesevorgänge

Die N Pakete, die seit der letzten Erhebung die meisten Daten von der Festplatte gelesen haben.

Jede Zeile enthält die Nutzer-ID, den Paketnamen, die Gesamtzahl der im Vordergrund Modus und Hintergrundmodus gelesenen Byte, den Prozentsatz der Byte bei allen Lesevorgängen im Vordergrundmodus und Hintergrundmodus im System, die Gesamtzahl der fsync Aufrufe im Vordergrundmodus und Hintergrundmodus und den Prozentsatz der fsync Aufrufe bei allen Aufrufen im Vordergrundmodus und Hintergrundmodus fsync im System.

Top N der Speicher-E/A-Schreibvorgänge Die N Pakete, die seit der letzten Erhebung die meisten Daten auf die Festplatte geschrieben haben. Jede Zeile enthält ähnliche Felder wie bei den Top N der Lesevorgänge.
Top N der UIDs mit E/A-Wartezeit

Die N Pakete mit den meisten Aufgaben, die auf E/A warten.

  • Jede Zeile der obersten Ebene enthält die Nutzer-ID, die Paketnamen, die Anzahl und den Prozentsatz der Aufgaben, die dem Paket gehören und auf E/A warten.
  • Die Zeilen der unteren Ebene enthalten die Informationen zur E/A-Wartezeit für die wichtigsten Prozesse die dem Paket gehören.
Top N der schwerwiegenden Seitenfehler Die N Pakete mit den meisten schwerwiegenden Seitenfehlern seit der letzten Erhebung.