Der native Watchdog-Dienst zeichnet E/A-Leistungsdaten seit dem frühen Initiieren des Systemstarts auf. Der native Dienst gibt die erfassten Leistungsdaten im Fehlerbericht aus. Anbieter können den nativen Dienst über dumpsys abfragen, um entweder die erfassten Daten zu sichern oder eine benutzerdefinierte Sammlungssitzung zur Fehlerbehebung zu starten.
Häufigkeit der Datenerhebung
Die Häufigkeit der Erfassung von Leistungsdaten hängt vom Build-Typ ab.
- Bei UserDebug- oder Eng-Builds erfasst Watchdog einmal alle 1 Sekunde beim Systemstart und alle 1 Minute nach Abschluss des Bootvorgangs einmal alle 1 Minute.
- Bei Nutzer-Builds erfasst Watchdog einmal alle 20 Sekunden beim Systemstart und alle zwei (2) Minuten nach Abschluss des Starts Leistungsdaten.
Ereignisse zur Datenerhebung
Die beispielbasierte Profilerstellung wird während verschiedener Systemereignisse (z. B. Systemstart, Systemaktivierung und Nutzerwechsel) sowie während des letzten N Minuten-Fensters ausgeführt.
- Ereignisse der letzten N Minuten vor der Generierung des Fehlerberichts: Werden während eines rollierenden Zeitfensters von 30 Minuten generiert.
- Bootzeit-Ereignisse:Werden nach dem Start generiert.
- Ereignisse beim Nutzerwechsel:Werden generiert, nachdem ein Nutzerwechsel eingeleitet wurde.
- Benutzerdefinierte Erfassungsereignisse: Kann Abfragezeitraum und maximale Dauer angeben und nach Paketen filtern.
Dump-Leistungsdaten
Wenn ein Fehlerbericht erfasst wird, gibt der native Watchdog-Dienst die erfassten Leistungsdaten im Fehlerbericht aus. Anbieter können den nativen Dienst über den folgenden dumpsys-Befehl abfragen, um die erfassten Leistungsdaten auszulesen. Weitere Informationen finden Sie im Abschnitt Grundlegendes zum Bericht mit Leistungsberichten.
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default > /tmp/carwatchdog_dump.txt
Leistungsdaten für die Fehlerbehebung erfassen
Anbieter können den nativen Watchdog-Dienst nutzen, um benutzerdefinierte Leistungsdaten zu Fehlerbehebungszwecken zu erfassen. Um beispielsweise die E/A-Nutzung einer Anwendung oder eines Dienstes zu verstehen, können Anbieter eine benutzerdefinierte Erfassung von Leistungsdaten durchführen, bei der die E/A-Nutzung entweder einer bestimmten Liste von Paketen oder des gesamten Systems ein Profil erstellt.
Sitzung für benutzerdefinierte Erhebung starten
Unten sehen Sie den Befehl zum Starten einer Sitzung zum Erfassen benutzerdefinierter Leistungsdaten:
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --start_perf [--interval <seconds>] [--max_duration <seconds>] [--filter_packages <package_name>,<package_name>,...]
--start_perfStartet eine Sitzung zum Erfassen benutzerdefinierter Leistungsdaten.--interval <seconds>Gibt das Profilerstellungsintervall an. Standardmäßig beträgt das Intervall 30 Sekunden.--max_duration <seconds>: Gibt die maximale Dauer der Sitzung zum Erfassen benutzerdefinierter Leistungsdaten an. Wenn die Sitzung nicht manuell beendet wird, wird sie beendet und die erfassten Daten werden nach diesem Zeitraum verworfen. Die maximale Dauer beträgt standardmäßig 30 Minuten.--filter_packages <package_name>,<package_name>...Gibt eine durch Kommas getrennte Liste von Paketnamen an, für die ein Profil erstellt werden soll. Sofern angegeben, ist die Erfassung von Leistungsdaten auf diese Pakete beschränkt. Andernfalls wird die Leistungsdaten für alle Pakete im System erfasst.
Mit dem folgenden Befehl wird beispielsweise eine benutzerdefinierte Erfassung von Leistungsdaten mit einem Profilerstellungsintervall von 10 Sekunden und einer maximalen Erfassungsdauer von 1 Stunde gestartet. Die Profilerstellung wird auf die Pakete com.google.android.car.kitchensink und com.google.android.apps.maps 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
Sitzung für die benutzerdefinierte Erfassung beenden und auslagern
Nachdem die E/A-Nutzung einer App oder eines Dienstes von Interesse aufgezeichnet wurde, sollten Anbieter die Sitzung zum Erfassen benutzerdefinierter Leistungsdaten beenden, um die erfassten Daten zu sichern. Mit diesem Befehl wird die Erfassung benutzerdefinierter Leistungsdaten beendet und die erfassten Daten im /tmp/carwatchdog_dump.txt ausgegeben:
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --stop-perf > /tmp/carwatchdog_custom_dump.txt
Dumpsys-Hilfe
So erhalten Sie Hilfe zu dumpsys:
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
Bericht zu Leistungsdaten auswerten
Weitere Informationen findest du im folgenden Beispielbericht mit 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 Watchdog dumpsys-Befehl ohne Argumente ausführen oder eine benutzerdefinierte Erfassungssitzung beenden, gibt der native Watchdog-Dienst einen Leistungsdatenbericht aus, der dem obigen Bericht ähnelt.
Der Bericht enthält Daten, die beim Systemstart und in den letzten N Minuten vor der Berichterstellung erfasst wurden.
| Artikel | Beschreibung |
|---|---|
| Informationen zur Erfassung der Bootzeit | Stellt Informationen zur Sitzung zum Erfassen von Leistungsdaten beim Start bereit. |
| Informationen zur Wakeup-Erfassung | Liefert Informationen zur Sitzung zur Erfassung der Leistungsdaten, wenn der Ruhemodus beendet wird. |
| Informationen zur Erhebung des Nutzerwechsels | Enthält Informationen zur Sitzung zum Erfassen von Leistungsdaten mit Nutzerwechsel, wenn ein Nutzerwechsel erfolgt. |
| Informationen zur regelmäßigen Datenerhebung | Stellt Informationen zur regelmäßigen Leistungserfassungssitzung bereit, die nach Abschluss des Bootvorgangs gestartet wird. |
| Leistungsbericht zur Bootzeit | Enthält Leistungsdaten, die beim Systemstart erfasst werden. Diese Daten bleiben im Arbeitsspeicher, bis das System heruntergefahren wird. Sie werden daher in alle Berichte aufgenommen. |
| Leistungsbericht nach Wakeup | Enthält Leistungsdaten, die während des Wakeups erfasst wurden. Diese Daten verbleiben bis zum Herunterfahren des Systems im Arbeitsspeicher, sodass sie in alle Berichte aufgenommen werden. |
| Leistungsbericht zu Nutzerwechsel | Enthält Leistungsdaten, die beim Nutzerwechsel erfasst wurden. Diese Daten bleiben im Arbeitsspeicher, bis das System heruntergefahren wird. Sie werden daher in alle Berichte aufgenommen. |
| E/A-Leistungsbericht der letzten N Minuten | Enthält Leistungsdaten, die durch die regelmäßige Erfassungssitzung in den letzten N Minuten vor der Berichterstellung erfasst wurden. |
| Dauer der Erfassung | Gesamtdauer der Erfassung von Leistungsdaten. |
| Anzahl der Sammlungen | Gesamtzahl der in einem einzelnen Bericht erfassten Sammlungen. |
Jede im Bericht enthaltene Sammlung kann alle oder einige der folgenden Abschnitte enthalten. Die in jeder Sammlung gemeldeten Statistiken stellen die Delta seit der letzten Erfassung dar, mit Ausnahme der Statistiken, die sofort auftreten (z. B. seit dem Systemstart nicht aggregiert wurden).
| Artikel | Beschreibung |
|---|---|
| CPU-E/A-Wartezeit/Prozentsatz | Absolute CPU-Zeit und Prozentsatz der CPU-Gesamtzeit, die aufgrund von E/A-Vorgängen seit der letzten Sammlung für den Kontextwechsel oder das Warten aufgewendet wurde. |
| CPU-Gesamtzeit | CPU-Gesamtzeit in Millisekunden. |
| CPU-Inaktivitätszeit insgesamt | Gesamte CPU-Zeit im Leerlauf. |
| CPU-E/A-Wartezeit | Gesamtzeit der CPU mit Warten auf E/A-Vorgänge. |
| Anzahl der Kontextwechsel | Anzahl der CPU-Switches von einem Prozess oder Thread zu einem anderen. |
| Anzahl der blockierten E/A-Prozesse pro Prozentsatz | Gesamtzahl der blockierten Prozesse beim Warten auf die E/A und der Prozentsatz der blockierten Prozesse, die seit der letzten Erfassung auf die E/A warten. |
| Top-N-CPU-Zeiten |
Top-N-Pakete, die seit der letzten Sammlung die meiste CPU-Zeit in Anspruch genommen haben:
|
| Top-N-Speicher-E/A-Lesevorgänge |
Top-N-Pakete, die seit der letzten Sammlung die meisten Daten vom Laufwerk gelesen haben. Jede Zeile enthält die Nutzer-ID, den Paketnamen, die Gesamtzahl der Byte, die im Vordergrund- oder Hintergrundmodus gelesen wurden, den Prozentsatz der Byte für alle Lesevorgänge im Vordergrund- und Hintergrundmodus im System, die Gesamtzahl der |
| Top-N-Speicher-E/A-Schreibvorgänge | Top-N-Pakete, die seit der letzten Erfassung die meisten Daten auf das Laufwerk geschrieben haben. Jede Zeile enthält Felder, die denen der Top-N-Lesevorgänge ähneln. |
| Top-N-E/A-Warte-UIDs | Die N Pakete mit den meisten E/A-Warteaufgaben.
|
| Häufigste N wichtige Seitenfehler | Top-N-Pakete mit den meisten größeren Seitenfehlern seit der letzten Sammlung. |