Le service natif Watchdog enregistre les données de performances des E/S depuis l'initialisation précoce au démarrage du système. Le service natif vide les données de performances collectées dans le rapport de bug. Les fournisseurs peuvent interroger le service natif via dumpsys pour vider les données collectées ou démarrer une session de collecte personnalisée pour le débogage.
Fréquence de la collecte des données
La fréquence de collecte des données sur les performances varie selon le type de compilation.
- Pour les builds userdebug ou eng, Watchdog collecte les données de performances toutes les une (1) seconde au démarrage du système et toutes les une (1) minute après le démarrage.
- Pour les builds d'utilisateur, Watchdog collecte des données de performances toutes les 20 secondes au démarrage du système et toutes les deux (2) minutes après le démarrage.
Événements de collecte de données
Le profilage basé sur des échantillons est effectué lors de divers événements système (tels que le démarrage du système, l'activation du système et le changement d'utilisateur) et au cours des N dernières minutes.
- Événements de N dernières minutes avant la génération du rapport de bug:générés au cours d'une fenêtre glissante de 30 minutes.
- Événements de temps de démarrage:générés après le démarrage.
- Événements de changement d'utilisateur:générés après le lancement d'un changement d'utilisateur.
- Événements de collecte personnalisés:vous pouvez spécifier une période d'interrogation et la durée maximale, et filtrer les événements par package.
Vider les données de performances
Lorsqu'un rapport de bug est créé, le service natif Watchdog copie les données de performances collectées dans le rapport de bug. Les fournisseurs peuvent interroger le service natif via la commande dumpsys ci-dessous pour vider les données de performances collectées. Pour en savoir plus sur ce rapport, consultez la section Comprendre le rapport sur les données sur les performances.
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default > /tmp/carwatchdog_dump.txt
Collecter les données de performances pour le débogage
Les fournisseurs peuvent utiliser le service natif Watchdog pour personnaliser la collecte des données de performances à des fins de débogage. Par exemple, pour comprendre l'utilisation des E/S d'une application ou d'un service, les fournisseurs peuvent effectuer une collecte personnalisée de données sur les performances qui profile l'utilisation des E/S d'une liste spécifique de packages ou de l'ensemble du système.
Démarrer une session de collecte personnalisée
Vous trouverez ci-dessous la commande permettant de démarrer une session personnalisée de collecte de données sur les performances:
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --start_perf [--interval <seconds>] [--max_duration <seconds>] [--filter_packages <package_name>,<package_name>,...]
--start_perf: lance une session personnalisée de collecte de données sur les performances.--interval <seconds>spécifie l'intervalle de profilage. Par défaut, l'intervalle est de 30 secondes.--max_duration <seconds>Spécifie la durée maximale de la session de collecte personnalisée des données sur les performances. Si la session n'est pas arrêtée manuellement, elle est arrêtée et les données collectées sont supprimées après cette durée. Par défaut, la durée maximale est de 30 minutes.--filter_packages <package_name>,<package_name>...Spécifie une liste de noms de packages à profiler, séparés par une virgule. Lorsqu'il est fourni, la collecte des données sur les performances est limitée à ces packages. Sinon, la collecte des données de performances est effectuée pour tous les packages du système.
Par exemple, la commande ci-dessous lance une collecte de données de performances personnalisées avec un intervalle de profilage de 10 secondes pour une durée maximale de collecte de 1 heure, et limite le profilage aux packages com.google.android.car.kitchensink et com.google.android.apps.maps.
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
Arrêter et vider la session de collecte personnalisée
Après avoir enregistré l'utilisation des E/S d'une application ou d'un service qui vous intéresse, les fournisseurs doivent arrêter la session personnalisée de collecte des données de performances pour vider les données collectées. Cette commande arrête la collecte personnalisée des données de performances et vide les données collectées dans /tmp/carwatchdog_dump.txt:
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --stop-perf > /tmp/carwatchdog_custom_dump.txt
Aide de Dumpsys
Pour obtenir de l'aide de dumpsys:
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --help
Vider au format proto
Les données de dumpsys peuvent éventuellement être vidées au format proto:
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --proto
Comprendre le rapport sur les données sur les performances
Pour en savoir plus, consultez l'exemple de rapport de données sur les performances suivant:
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%
Lors de la capture d'un rapport de bug, de l'exécution d'une commande Watchdog dumpsys sans aucun argument ou de l'arrêt d'une session de collecte personnalisée, le service natif Watchdog transmet un rapport de données sur les performances semblable au rapport ci-dessus.
Le rapport contient les données collectées lors du démarrage du système et les N dernières minutes avant la génération du rapport.
| Article | Description |
|---|---|
| Informations sur la collecte au démarrage | Fournit des informations sur la session de collecte de données sur les performances au démarrage. |
| Informations sur la collecte des données de réveil | Fournit des informations sur la session de collecte de données sur les performances des wakeups lorsque le système sort de l'état de suspension. |
| Informations sur la collecte des changements d'utilisateur | Fournit des informations sur la session de collecte de données sur les performances en cas de changement d'utilisateur. |
| Informations sur les collectes périodiques | Fournit des informations sur la session périodique de collecte des performances qui démarre une fois le démarrage terminé. |
| Rapport sur les performances au démarrage | Contient les données de performances collectées lors du démarrage du système. Ces données sont conservées en mémoire jusqu'à l'arrêt du système. Elles sont donc vidées dans tous les rapports. |
| Rapport sur les performances de wakeup | Contient les données de performances collectées lors de la sortie de veille. Ces données sont conservées en mémoire jusqu'à l'arrêt du système. Elles sont donc vidées dans tous les rapports. |
| Rapport sur les performances des changements d'utilisateur | Contient les données de performances collectées lors du changement d'utilisateur. Ces données sont conservées en mémoire jusqu'à l'arrêt du système. Elles sont donc vidées dans tous les rapports. |
| Rapport sur les performances des E/S dans les N dernières minutes | Contient les données de performances collectées (par la session de collecte périodique) au cours des N dernières minutes avant la génération du rapport. |
| Durée de la collecte | Durée totale de la collecte des données sur les performances. |
| Nombre de collections | Nombre total de collections enregistrées dans un seul rapport. |
Chaque collection figurant dans le rapport peut contenir tout ou partie des sections ci-dessous. Les statistiques indiquées dans chaque collection correspondent au delta depuis la dernière collecte, à l'exception des statistiques instantanées (par exemple, qui ne sont pas agrégées depuis le démarrage du système).
| Article | Description |
|---|---|
| Temps d'attente E/S du processeur/pourcentage | Temps CPU absolu et pourcentage du temps CPU total consacré au changement de contexte ou à l'attente en raison d'opérations d'E/S depuis la dernière collecte. |
| Temps CPU total | Temps CPU total en millisecondes. |
| Temps CPU total d'inactivité | Temps CPU total passé en mode inactif. |
| Temps d'attente des E/S du processeur | Temps total d'attente du processeur pour les opérations d'E/S. |
| Nombre de changements de contexte | Nombre de changements de processeur d'un processus ou d'un thread à un autre. |
| Nombre de processus d'E/S bloqués/% | Nombre total de processus bloqués en attente d'E/S et pourcentage de processus bloqués en attente d'E/S depuis la dernière collecte. |
| N premiers temps CPU |
N principaux packages ayant consommé le plus de temps CPU depuis la dernière collecte:
|
| N premières lectures d'E/S de stockage |
Top N des packages qui lisent le plus de données sur le disque depuis la dernière collecte. Chaque ligne contient l'ID utilisateur, le nom du package, le nombre total d'octets lus en mode premier plan par rapport au mode arrière-plan, le pourcentage d'octets sur tous les modes de premier plan par rapport aux lectures en arrière-plan sur le système, le nombre total d'appels |
| N principales écritures d'E/S de stockage | Top N des packages ayant écrit le plus de données sur le disque depuis la dernière collecte. Chaque ligne contient des champs semblables à ceux des N premières lectures. |
| N premiers UID d'E/S en attente | Top N des packages avec le plus de tâches d'E/S en attente.
|
| N premiers défauts de page majeurs | Top N packages avec le plus grand nombre de défauts de page majeurs depuis la dernière collecte. |