Collecter des données sur les performances

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

Fréquence de collecte des données

La fréquence de collecte des données sur les performances varie en fonction du type de build.

  • Sur les builds userdebug ou eng, Watchdog collecte les données sur les performances une fois par seconde lors du démarrage du système et une fois par minute après le démarrage.
  • Sur les builds utilisateur, Watchdog collecte les données sur les performances une fois toutes les 20 secondes lors du démarrage du système et une fois toutes les deux minutes après le démarrage.

Événements de collecte de données

Le profilage basé sur des exemples est effectué lors de différents événements système (tels que le démarrage du système, la sortie de veille du système et le changement d'utilisateur) et au cours des N dernières minutes.

  • Événements des N dernières minutes avant la génération du rapport de bug : générés pendant une fenêtre glissante de 30 minutes.
  • Événements 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ée : vous pouvez spécifier la période d'interrogation, la durée maximale et filtrer par packages.

Déverser les données sur les performances

Lorsqu'un rapport de bug est capturé, le service natif Watchdog déverse les données sur les performances collectées dans le rapport de bug. Les fournisseurs peuvent interroger le service natif via la commande dumpsys ci-dessous pour déverser les données sur les performances collectées. Pour en savoir plus sur le rapport, consultez la section Comprendre le rapport sur les données de performances.

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

Collecter des données sur les performances à des fins de 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 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_perf démarre une session de collecte de données sur les 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 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'elle est fournie, la collecte de données de performances est limitée à ces packages. Sinon, la collecte de données sur les 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 secondes, une durée de collecte maximale d'une 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 déverser une 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 de données de performances personnalisée pour déverser les données collectées. Cette commande arrête la collecte de données sur les performances personnalisée et déverse 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 sur Dumpsys

Pour obtenir de l'aide sur dumpsys :

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

Déverser au format proto

Vous pouvez également déverser les données dumpsys au format proto :

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

Comprendre le rapport sur les données de performances

Pour en savoir plus, consultez l'exemple de rapport sur les données de 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 dumpsys Watchdog sans aucun argument ou de l'arrêt d'une session de collecte personnalisée, le service natif Watchdog déverse un rapport sur les données de performances semblable à celui 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.

Élément Description
Informations sur la collecte au démarrage Fournit des informations sur la session de collecte de données de performances au démarrage.
Informations sur la collecte lors de la sortie de veille Fournit des informations sur la session de collecte de données sur les performances lors de la sortie de veille lorsque le système sort de la suspension.
Informations sur la collecte lors du changement d'utilisateur Fournit des informations sur la session de collecte de données de performances lors du changement d'utilisateur.
Informations sur la collecte périodique Fournit des informations sur la session de collecte de performances périodique qui démarre après le démarrage.
Rapport sur les performances au démarrage Contient les données sur les 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 déversées dans tous les rapports.
Rapport sur les performances lors de la sortie de veille Contient les données sur les performances collectées lors de la sortie de veille. Ces données persistent en mémoire jusqu'à l'arrêt du système. Elles sont donc déversées dans tous les rapports.
Rapport sur les performances lors du changement d'utilisateur Contient les données sur les 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 déversées dans tous les rapports.
Rapport sur les performances d'E/S des N dernières minutes Contient les données sur les 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 de données sur les performances.
Nombre de collectes Nombre total de collectes signalées dans un seul rapport.

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

Élément Description
Temps/pourcentage d'attente d'E/S du processeur 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 en veille Temps CPU total passé en veille.
Temps d'attente d'E/S du processeur Temps total passé par le processeur à attendre des 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/pourcentage de processus bloqués par les E/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 premiers packages ayant consommé le plus de temps CPU depuis la dernière collecte :

  • Chaque ligne de premier niveau contient l'ID utilisateur, le nom du package, le temps CPU, le pourcentage du temps CPU total et les cycles CPU.
  • Les lignes de niveau inférieur contiennent la commande, le temps CPU, le pourcentage du temps CPU de l'UID et les cycles CPU.
N premières lectures d'E/S de stockage

N premiers packages ayant lu 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 mode 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 par rapport au mode arrière-plan effectués dans le système.
N premières écritures d'E/S de stockage N premiers 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 en attente d'E/S

N premiers packages avec le plus de tâches en attente d'E/S.

  • Chaque ligne de premier niveau 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 inférieur contiennent les informations d'attente d'E/S pour les principaux processus appartenant au package.
N premières erreurs de page majeures N premiers packages avec le plus d'erreurs de page majeures depuis la dernière collecte.