Collecter des données de performances

Le service natif de Watchdog enregistre les données de performances d'E/S depuis le début de l'initialisation lors du démarrage du système. Le service natif sauvegarde les données de performances collectées dans le rapport de bug. Les fournisseurs peuvent interroger le service natif via dumpsys pour soit vider les données collectées, soit démarrer une session de collecte personnalisée pour le débogage.

Fréquence de collecte des données

La fréquence de la collecte des données de performances varie selon le type de build.

  • Sur les versions userdebug ou eng, Watchdog collecte les données de performances une fois toutes les (1) secondes pendant le démarrage du système et une fois toutes les (1) minutes après le démarrage.
  • Sur les versions utilisateur, Watchdog collecte les données de performances une fois toutes les 20 secondes lors du démarrage du système et une fois toutes les deux (2) minutes après la fin du démarrage.

Données de performances de vidage

Lorsqu'un rapport de bogue est capturé, le service natif Watchdog sauvegarde les données de performances collectées dans le rapport de bogue. Les fournisseurs peuvent interroger le service natif via la commande dumpsys ci-dessous pour vider les données de performances collectées. Consultez la section Comprendre le rapport de données de performances pour plus de détails sur le rapport.

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

Collecter des données de performances pour le débogage

Les fournisseurs peuvent utiliser le service natif Watchdog pour collecter des données de performances personnalisées à 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 de 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_perf . Dé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ées. Si la session n'est pas arrêtée manuellement, la session 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 des virgules. Lorsqu'elle est fournie, la collecte de données de 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 démarre une collecte de données de performances personnalisée avec un intervalle de profilage de 10 seconds , une durée maximale de collecte de 1 hour et limite le profilage aux com.google.android.car.kitchensink et com.google.android.apps.maps Paquets 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 de collecte de données de performances personnalisées pour vider les données collectées.

La commande suivante arrête la collecte de données de performances personnalisées 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 Dumpsys

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

Comprendre le rapport sur les données de performances

Vous trouverez ci-dessous un exemple de rapport de données de performances :

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

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

Periodic collection information:
=========================
Event interval: 60 seconds
--------------------------------
Boot-time I/O performance report:
============================
Collection duration: 1637609138 seconds
Number of collections: 12

Collection 0: <Fri Jan  7 19:53:53 2022 GMT>
===================================
CPU I/O wait time/percent: 18 / 0.63%
Number of I/O blocked processes/percent: 0 / 0.00%

Top N 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 Writes:
-------------
Android User ID, Package Name, Foreground Bytes, Foreground Bytes %, Foreground Fsync, Foreground Fsync %, Background Bytes, Background Bytes %, Background Fsync, Background Fsync %
0, root, 53248, 100.00%, 1, 100.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.59%
        kworker/7:2+events, 1, 50.00%
        kworker/4:2+events, 1, 50.00%
0, system, 2, 7.14%
        ais_server, 2, 100.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, system, 48, 53.33%
        ais_server, 13, 27.08%
        audiod, 10, 20.83%
0, root, 41, 45.56%
        init, 39, 95.12%
        ueventd, 1, 2.44%
0, media, 1, 1.11%
        init.qti.media., 1, 100.00%
Number of major page faults since last collection: 90
Percentage of change in major page faults since last collection: 0.00%

Collection 1: <Fri Jan  7 19:53:54 2022 GMT>
===================================
 … Collection data …

Collection 2: <Fri Jan  7 19:53:55 2022 GMT>
===================================
 … Collection data …
 … Repeated collection data until boot-complete …

-----------------------------------------
Last N minutes I/O performance report:
================================
Collection duration: 10797 seconds
Number of collections: 181

Collection 0: <Tue Jan 11 19:43:05 2022 GMT>
====================================
CPU I/O wait time/percent: 18 / 0.04%
Number of I/O blocked processes/percent: 0 / 0.00%

Top N Writes:
-------------
Android User ID, Package Name, Foreground Bytes, Foreground Bytes %, Foreground Fsync, Foreground Fsync %, Background Bytes, Background Bytes %, Background Fsync, Background Fsync %
0, system, 33697792, 92.41%, 0, 0.00%, 0, 0.00%, 0, 0.00%
0, gps, 2420736, 6.64%, 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, 1, 0.19%
        crtc_commit:244, 1, 100.00%

Lors de la capture d'un rapport de bogue, 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 génère un rapport de données de performances similaire 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.

  • Boot-time collection information . Fournit des informations sur la session de collecte de données de performances au démarrage.
  • Periodic collection information . Fournit des informations sur la session périodique de collecte des performances qui démarre après la fin du démarrage.
  • Boot-time I/O performance report . Contient les données de performances collectées lors du démarrage du système. Ces données sont persistantes en mémoire jusqu'à l'arrêt du système, elles sont donc sauvegardées dans tous les rapports.
  • Last N minutes I/O performance report . 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.
  • Collection duration . Durée totale de la collecte des données de performance.
  • Number of collections . Nombre total de collections signalées dans un seul rapport.

Chaque collection signalée dans le rapport peut contenir tout ou partie des sections ci-dessous. Les statistiques rapportées dans chaque collection correspondent au delta depuis la dernière collection, à l'exception des statistiques instantanées (par exemple, non agrégées depuis le démarrage du système).

  • CPU I/O wait time/percent . Temps CPU absolu et pourcentage du temps CPU total consacré au changement de contexte ou à l'attente en raison des opérations d'E/S depuis la dernière collecte.
  • Number of I/O blocked processes/percent . 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.
  • Top N Reads . Les N principaux packages qui lisent la plupart des données du 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 toutes les lectures en mode premier plan par rapport au mode arrière-plan dans le système, le nombre total d'appels fsync effectués en mode premier plan par rapport au mode arrière-plan, et le pourcentage d'appels fsync sur tous les appels fsync en mode premier plan et en mode arrière-plan effectués dans le système.
  • Top N Writes . Les N principaux packages ayant écrit le plus de données sur le disque depuis la dernière collecte.
    • Chaque ligne contient des champs similaires à ceux de Top N Reads .
  • Top NI/O waiting UIDs . Top N packages avec le plus de tâches d’attente d’E/S.
    • Chaque ligne de niveau supérieur contient l'ID utilisateur, les noms des packages, le nombre et le pourcentage de tâches appartenant au package en attente d'E/S.
    • Les lignes de niveau interne contiennent les informations d'attente d'E/S pour les principaux processus appartenant au package.
  • Top N major page faults . Top N packages avec les défauts de page les plus importants depuis la dernière collection.
    • Chaque ligne de niveau supérieur contient l'ID utilisateur, les noms des packages, le nombre et le pourcentage de défauts de page majeurs attribués au package.
    • Les lignes de niveau interne contiennent les principales informations sur les défauts de page pour les principaux processus appartenant au package.
  • Number of major page faults since last collection .
  • Percentage of change in major page faults since last collection .