Le service natif de Watchdog enregistre les données de performances d'E/S depuis l'initialisation précoce le 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 à des fins de débogage.
Fréquence de la collecte des données
La fréquence de collecte des données sur les performances varie selon le build de mots clés.
- Dans les builds userdebug ou eng, Watchdog collecte les données de performances une fois toutes les secondes au démarrage du système et une fois toutes les minutes après le démarrage.
- Dans les builds 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 (démarrage du système, l'activation du système et le changement de l'utilisateur) et au cours de la dernière fenêtre des N minutes.
- Événements de N dernières minutes avant la génération du rapport de bug:générés pendant un 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 déclenchement d'un changement d'utilisateur.
- Événements de collecte personnalisés:vous pouvez spécifier la période de sondage, la durée maximale et filtrer par packages.
Vider les données de performances
Lors de la création d'un rapport de bug, le service natif Watchdog vide les données collectées dans le rapport de bug. Les fournisseurs peuvent interroger le service natif via ci-dessous dumpsys pour vider les données de performance collectées. Pour en savoir plus sur ce rapport, consultez la section Comprendre le rapport sur les données de performances.
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default > /tmp/carwatchdog_dump.txtCollecter des données de performances pour le débogage
Les fournisseurs peuvent utiliser le service natif Watchdog pour personnaliser la collecte des 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 de données de performances personnalisée 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 de collecte de données sur les performances personnalisée :
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --start_perf [--interval <seconds>] [--max_duration <seconds>] [--filter_packages <package_name>,<package_name>,...]--start_perfDémarre une session de collecte de données de performances personnalisée.--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 de données de performances personnalisée. Si la session n'est pas arrêtée manuellement, elle est arrêtée et les données collectées sont supprimées au bout de 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. Si cet argument est fourni, la collecte des données sur les performances est limitée à ces packages. Dans le cas contraire, la collecte de données sur les performances est effectuée pour tous les packages du système.
Par exemple, la commande ci-dessous lance une collecte personnalisée de données sur les performances
avec un intervalle de profilage de 10 secondes, la collecte au maximum
durée de 1 hour (1 heure) et limite le profilage
com.google.android.car.kitchensink et
com.google.android.apps.maps packages.
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.mapsArrê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 d'intérêt, les fournisseurs doivent arrêter la session de collecte des données de performances personnalisées pour vider les données collectées. Cette commande arrête
la collecte de données de performances personnalisées
et transfère les données collectées
/tmp/carwatchdog_dump.txt:
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --stop-perf > /tmp/carwatchdog_custom_dump.txtAide sur dumpsys
Pour obtenir de l'aide de dumpsys:
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --helpÉcraser au format proto
Les données dumpsys peuvent éventuellement être vidées au format proto:
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --protoComprendre le rapport sur les données de performances
Pour en savoir plus, consultez l'exemple de rapport de données sur les performances ci-dessous:
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%
Lorsque vous capturez un bugreport, exécutez une commande dumpsys Watchdog sans arguments ou arrêtez une session de collecte personnalisée, le service natif Watchdog génère un rapport de données de 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 de rapports.
| Article | Description |
|---|---|
| Informations de collecte au démarrage | Fournit des informations sur la session de collecte des données de performances au démarrage. |
| Informations sur la collecte de réveil | Fournit des informations sur la session de collecte de données sur les performances d'activation lorsque le système sort de l'état "suspendu". |
| Informations sur la collecte des changements d'utilisateur | Fournit des informations sur la session de collecte de données sur les performances du commutateur utilisateur est un commutateur utilisateur. |
| Informations sur la collecte périodique | Fournit des informations sur la session périodique de collecte des performances qui démarre après 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 persistent en mémoire jusqu'à l'arrêt du système. Elles sont donc transférées dans tous les rapports. |
| Rapport sur les performances de réveil | Contient les données de performances collectées lors du réveil. Ces données sont conservées en mémoire jusqu'à l'arrêt du système, de sorte que les données sont 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 persistent en mémoire jusqu'à l'arrêt du système. Elles sont donc transférées dans tous les rapports. |
| Rapport sur les performances d'E/S des N dernières minutes | Contient les données de performances collectées (par la session de collecte périodique) au cours de la dernière N 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 indiquée dans le rapport peut contenir l'ensemble ou une partie des sections ci-dessous. Les statistiques indiquées dans chaque collecte correspondent au delta depuis la dernière collecte, à l'exception des statistiques instantanées (par exemple, non agrégées depuis le démarrage du système).
| Article | Description |
|---|---|
| Temps d'attente d'E/S du processeur/pourcentage | Temps CPU absolu et pourcentage du temps CPU total consacré au changement de contexte 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é à l'inactivité. |
| Temps d'attente d'E/S du processeur | Temps total passé par le processeur à attendre 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 bloqués par E/S/pourcentage | Nombre total de processus bloqués en attente d'E/S et pourcentage de processus bloqués en attente des E/S depuis la dernière collection. |
| Top N des temps CPU |
N premiers packages ayant consommé le plus de temps de processeur 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 pour toutes les lectures en mode premier plan par rapport au mode arrière-plan dans 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 de "Top N lectures". |
| UID d'attente d'E/S N plus élevés | Top N des packages avec le plus de tâches d'E/S en attente.
|
| N plus grands défauts de page majeurs | N premiers packages présentant le plus de défauts de page majeurs depuis la dernière collecte. |