dumpsys
est un outil qui s'exécute sur les appareils Android et fournit des informations sur les services système. Appelez dumpsys
depuis la ligne de commande à l'aide d'Android Debug Bridge (ADB) afin d'obtenir une sortie de diagnostic pour tous les services système exécutés sur un appareil connecté.
Cette sortie est généralement plus détaillée que ce que vous souhaiteriez. Nous vous conseillons donc d'utiliser les options de ligne de commande de cette page pour obtenir une sortie uniquement pour les services système qui vous intéressent. Cette page explique également comment utiliser dumpsys
pour effectuer des tâches courantes, telles que l'inspection des diagnostics d'entrée, de RAM, de batterie ou de réseau.
Syntaxe
La syntaxe générale pour utiliser dumpsys
est la suivante :
adb shell dumpsys [-t timeout] [--help | -l | --skip services | service [arguments] | -c | -h]
Pour obtenir une sortie de diagnostic pour tous les services système de votre appareil connecté, exécutez adb shell dumpsys
.
Cependant, cela génère beaucoup plus d'informations que ce que vous souhaitez généralement. Pour obtenir une sortie plus facile à gérer, spécifiez le service à examiner en l'incluant dans la commande. Par exemple, la commande ci-dessous fournit des données système pour les composants d'entrée tels que les écrans tactiles ou les claviers intégrés :
adb shell dumpsys input
Pour obtenir la liste complète des services système que vous pouvez utiliser avec dumpsys
, exécutez la commande suivante :
adb shell dumpsys -l
Options de ligne de commande
Le tableau suivant présente les options disponibles lorsque vous utilisez dumpsys
.
Tableau 1. Liste des options disponibles pour dumpsys
Option | Description |
---|---|
-t timeout
|
Indique le délai avant expiration, en secondes. Si aucune valeur n'est spécifiée, la valeur par défaut est de 10 secondes. |
--help
|
Affiche le texte d'aide de l'outil dumpsys .
|
-l
|
Affiche la liste complète des services système que vous pouvez utiliser avec dumpsys .
|
--skip services
|
Spécifie les services que vous ne souhaitez pas inclure dans le résultat. |
service [arguments]
|
Spécifie le service à inclure dans le résultat. Certains services peuvent vous permettre de transmettre des arguments facultatifs. Pour en savoir plus
ces arguments facultatifs, transmettez l'option -h avec
service:
adb shell dumpsys procstats -h |
-c
|
Lorsque vous spécifiez certains services, ajoutez cette option pour générer des données dans un format lisible par l'ordinateur. |
-h
|
Pour certains services, ajoutez cette option afin d'afficher le texte d'aide et les options supplémentaires pour ce service. |
Inspecter les diagnostics d'entrée
Spécifier le service input
, comme illustré dans la commande ci-dessous, vide l'état des périphériques d'entrée du système, tels que les claviers et les écrans tactiles, et le traitement des événements d'entrée.
adb shell dumpsys input
La sortie varie en fonction de la version d'Android exécutée sur l'appareil connecté. Les sections suivantes décrivent le type d'informations que vous voyez généralement.
État du hub d'événements
Voici un exemple de ce que vous pouvez voir lorsque vous inspectez l'état du hub d'événements (Event Hub State) des diagnostics d'entrée :
INPUT MANAGER (dumpsys input) Event Hub State: BuiltInKeyboardId: -2 Devices: -1: Virtual Classes: 0x40000023 Path:Descriptor: a718a782d34bc767f4689c232d64d527998ea7fd Location: ControllerNumber: 0 UniqueId: Identifier: bus=0x0000, vendor=0x0000, product=0x0000, version=0x0000 KeyLayoutFile: /system/usr/keylayout/Generic.kl KeyCharacterMapFile: /system/usr/keychars/Virtual.kcm ConfigurationFile: HaveKeyboardLayoutOverlay: false 1: msm8974-taiko-mtp-snd-card Headset Jack Classes: 0x00000080 Path: /dev/input/event5 Descriptor: c8e3782483b4837ead6602e20483c46ff801112c Location: ALSA ControllerNumber: 0 UniqueId: Identifier: bus=0x0000, vendor=0x0000, product=0x0000, version=0x0000 KeyLayoutFile: KeyCharacterMapFile: ConfigurationFile: HaveKeyboardLayoutOverlay: false 2: msm8974-taiko-mtp-snd-card Button Jack Classes: 0x00000001 Path: /dev/input/event4 Descriptor: 96fe62b244c555351ec576b282232e787fb42bab Location: ALSA ControllerNumber: 0 UniqueId: Identifier: bus=0x0000, vendor=0x0000, product=0x0000, version=0x0000 KeyLayoutFile: /system/usr/keylayout/msm8974-taiko-mtp-snd-card_Button_Jack.kl KeyCharacterMapFile: /system/usr/keychars/msm8974-taiko-mtp-snd-card_Button_Jack.kcm ConfigurationFile: HaveKeyboardLayoutOverlay: false 3: hs_detect Classes: 0x00000081 Path: /dev/input/event3 Descriptor: 485d69228e24f5e46da1598745890b214130dbc4 Location: ControllerNumber: 0 UniqueId: Identifier: bus=0x0000, vendor=0x0001, product=0x0001, version=0x0001 KeyLayoutFile: /system/usr/keylayout/hs_detect.kl KeyCharacterMapFile: /system/usr/keychars/hs_detect.kcm ConfigurationFile: HaveKeyboardLayoutOverlay: false ...
État du lecteur d'entrée
Le InputReader
est chargé de décoder les événements d'entrée du noyau. Son vidage d'état affiche des informations sur la configuration de chaque périphérique d'entrée et sur les changements d'état récents qui se sont produits, par exemple les pressions sur les touches ou les appuis sur l'écran tactile.
L'exemple suivant montre la sortie pour un écran tactile. Notez les informations sur la résolution de l'appareil et les paramètres d'étalonnage qui ont été utilisés.
Input Reader State ... Device 6: Melfas MMSxxx Touchscreen IsExternal: false Sources: 0x00001002 KeyboardType: 0 Motion Ranges: X: source=0x00001002, min=0.000, max=719.001, flat=0.000, fuzz=0.999 Y: source=0x00001002, min=0.000, max=1279.001, flat=0.000, fuzz=0.999 PRESSURE: source=0x00001002, min=0.000, max=1.000, flat=0.000, fuzz=0.000 SIZE: source=0x00001002, min=0.000, max=1.000, flat=0.000, fuzz=0.000 TOUCH_MAJOR: source=0x00001002, min=0.000, max=1468.605, flat=0.000, fuzz=0.000 TOUCH_MINOR: source=0x00001002, min=0.000, max=1468.605, flat=0.000, fuzz=0.000 TOOL_MAJOR: source=0x00001002, min=0.000, max=1468.605, flat=0.000, fuzz=0.000 TOOL_MINOR: source=0x00001002, min=0.000, max=1468.605, flat=0.000, fuzz=0.000 Touch Input Mapper: Parameters: GestureMode: spots DeviceType: touchScreen AssociatedDisplay: id=0, isExternal=false OrientationAware: true Raw Touch Axes: X: min=0, max=720, flat=0, fuzz=0, resolution=0 Y: min=0, max=1280, flat=0, fuzz=0, resolution=0 Pressure: min=0, max=255, flat=0, fuzz=0, resolution=0 TouchMajor: min=0, max=30, flat=0, fuzz=0, resolution=0 TouchMinor: unknown range ToolMajor: unknown range ToolMinor: unknown range Orientation: unknown range Distance: unknown range TiltX: unknown range TiltY: unknown range TrackingId: min=0, max=65535, flat=0, fuzz=0, resolution=0 Slot: min=0, max=9, flat=0, fuzz=0, resolution=0 Calibration: touch.size.calibration: diameter touch.size.scale: 10.000 touch.size.bias: 0.000 touch.size.isSummed: false touch.pressure.calibration: amplitude touch.pressure.scale: 0.005 touch.orientation.calibration: none touch.distance.calibration: none SurfaceWidth: 720px SurfaceHeight: 1280px SurfaceOrientation: 0 Translation and Scaling Factors: XScale: 0.999 YScale: 0.999 XPrecision: 1.001 YPrecision: 1.001 GeometricScale: 0.999 PressureScale: 0.005 SizeScale: 0.033 OrientationCenter: 0.000 OrientationScale: 0.000 DistanceScale: 0.000 HaveTilt: false TiltXCenter: 0.000 TiltXScale: 0.000 TiltYCenter: 0.000 TiltYScale: 0.000 Last Button State: 0x00000000 Last Raw Touch: pointerCount=0 Last Cooked Touch: pointerCount=0
À la fin du vidage de l'état du lecteur d'entrée, vous trouverez des informations sur les paramètres de configuration généraux, tels que l'intervalle d'appui :
Configuration: ExcludedDeviceNames: [] VirtualKeyQuietTime: 0.0ms PointerVelocityControlParameters: scale=1.000, lowThreshold=500.000, highThreshold=3000.000, acceleration=3.000 WheelVelocityControlParameters: scale=1.000, lowThreshold=15.000, highThreshold=50.000, acceleration=4.000 PointerGesture: Enabled: true QuietInterval: 100.0ms DragMinSwitchSpeed: 50.0px/s TapInterval: 150.0ms TapDragInterval: 300.0ms TapSlop: 20.0px MultitouchSettleInterval: 100.0ms MultitouchMinDistance: 15.0px SwipeTransitionAngleCosine: 0.3 SwipeMaxWidthRatio: 0.2 MovementSpeedRatio: 0.8 ZoomSpeedRatio: 0.3
État du coordinateur d'entrée
InputDispatcher
est responsable de l'envoi des événements d'entrée aux applications.
Comme le montre l'exemple de résultat ci-dessous, le fichier de vidage d'état affiche des informations sur la fenêtre concernée par l'appui, l'état de la file d'attente d'entrée, si une erreur ANR a été rencontrée et d'autres informations sur les événements d'entrée :
Input Dispatcher State: DispatchEnabled: 1 DispatchFrozen: 0 FocusedApplication: <null> FocusedWindow: name='Window{3fb06dc3 u0 StatusBar}' TouchStates: <no displays touched> Windows: 0: name='Window{357bbbfe u0 SearchPanel}', displayId=0, paused=false, hasFocus=false, hasWallpaper=false, visible=false, canReceiveKeys=false, flags=0x01820100, type=0x000007e8, layer=211000, frame=[0,0][1080,1920], scale=1.000000, touchableRegion=[0,0][1080,1920], inputFeatures=0x00000000, ownerPid=22674, ownerUid=10020, dispatchingTimeout=5000.000ms 1: name='Window{3b14c0ca u0 NavigationBar}', displayId=0, paused=false, hasFocus=false, hasWallpaper=false, visible=false, canReceiveKeys=false, flags=0x01840068, type=0x000007e3, layer=201000, frame=[0,1776][1080,1920], scale=1.000000, touchableRegion=[0,1776][1080,1920], inputFeatures=0x00000000, ownerPid=22674, ownerUid=10020, dispatchingTimeout=5000.000ms 2: name='Window{2c7e849c u0 com.vito.lux}', displayId=0, paused=false, hasFocus=false, hasWallpaper=false, visible=true, canReceiveKeys=false, flags=0x0089031a, type=0x000007d6, layer=191000, frame=[-495,-147][1575,1923], scale=1.000000, touchableRegion=[-495,-147][1575,1923], inputFeatures=0x00000000, ownerPid=4697, ownerUid=10084, dispatchingTimeout=5000.000ms ... MonitoringChannels: 0: 'WindowManager (server)' RecentQueue: length=10 MotionEvent(deviceId=4, source=0x00001002, action=2, flags=0x00000000, metaState=0x00000000, buttonState=0x00000000, edgeFlags=0x00000000, xPrecision=1.0, yPrecision=1.0, displayId=0, pointers=[0: (335.0, 1465.0)]), policyFlags=0x62000000, age=217264.0ms MotionEvent(deviceId=4, source=0x00001002, action=1, flags=0x00000000, metaState=0x00000000, buttonState=0x00000000, edgeFlags=0x00000000, xPrecision=1.0, yPrecision=1.0, displayId=0, pointers=[0: (335.0, 1465.0)]), policyFlags=0x62000000, age=217255.7ms MotionEvent(deviceId=4, source=0x00001002, action=0, flags=0x00000000, metaState=0x00000000, buttonState=0x00000000, edgeFlags=0x00000000, xPrecision=1.0, yPrecision=1.0, displayId=0, pointers=[0: (330.0, 1283.0)]), policyFlags=0x62000000, age=216805.0ms ... PendingEvent: <none> InboundQueue: <empty> ReplacedKeys: <empty> Connections: 0: channelName='WindowManager (server)', windowName='monitor', status=NORMAL, monitor=true, inputPublisherBlocked=false OutboundQueue: <empty> WaitQueue: <empty> 1: channelName='278c1d65 KeyguardScrim (server)', windowName='Window{278c1d65 u0 KeyguardScrim}', status=NORMAL, monitor=false, inputPublisherBlocked=false OutboundQueue: <empty> WaitQueue: <empty> 2: channelName='357bbbfe SearchPanel (server)', windowName='Window{357bbbfe u0 SearchPanel}', status=NORMAL, monitor=false, inputPublisherBlocked=false OutboundQueue: <empty> WaitQueue: <empty> ... AppSwitch: not pending 7: channelName='2280455f com.google.android.gm/com.google.android.gm.ConversationListActivityGmail (server)', windowName='Window{2280455f u0 com.google.android.gm/com.google.android.gm.ConversationListActivityGmail}', status=NORMAL, monitor=false, inputPublisherBlocked=false OutboundQueue: <empty> WaitQueue: <empty> 8: channelName='1a7be08a com.android.systemui/com.android.systemui.recents.RecentsActivity (server)', windowName='Window{1a7be08a u0 com.android.systemui/com.android.systemui.recents.RecentsActivity EXITING}', status=NORMAL, monitor=false, inputPublisherBlocked=false OutboundQueue: <empty> WaitQueue: <empty> 9: channelName='3b14c0ca NavigationBar (server)', windowName='Window{3b14c0ca u0 NavigationBar}', status=NORMAL, monitor=false, inputPublisherBlocked=false OutboundQueue: <empty> WaitQueue: <empty> ... Configuration: KeyRepeatDelay: 50.0ms KeyRepeatTimeout: 500.0ms
Points à vérifier
Vous trouverez ci-dessous une liste d'éléments à prendre en compte lors de l'inspection du résultat du service input
:
État du hub d'événements :
- Tous les périphériques d'entrée attendus sont présents.
- Chaque périphérique d'entrée dispose d'un fichier de mise en page de clé, d'un fichier de mappage de caractères de clé et d'un fichier de configuration de périphérique d'entrée appropriés. Si les fichiers sont absents ou contiennent des erreurs de syntaxe, ils ne sont pas chargés.
- Chaque périphérique d'entrée est classé correctement. Les bits du champ
Classes
correspondent à des indicateurs dansEventHub.h
, par exempleINPUT_DEVICE_CLASS_TOUCH_MT
. -
BuiltInKeyboardId
est correct. Si l'appareil ne possède pas de clavier intégré, l'ID doit être-2
. Sinon, il doit correspondre à l'ID du clavier intégré. - Si vous constatez que
BuiltInKeyboardId
n'est pas-2
alors qu'il devrait l'être, c'est qu'il vous manque un fichier de mappage de caractères de clé pour un clavier à fonction spéciale. Les périphériques de clavier à fonction spéciale doivent contenir des fichiers de mappage de caractères de clé contenant uniquement la lignetype SPECIAL_FUNCTION
.
État du lecteur d'entrée :
- Tous les périphériques d'entrée attendus sont présents.
- Chaque périphérique d'entrée est configuré correctement. Vérifiez en particulier que les axes de l'écran tactile et du joystick sont corrects.
État du coordinateur d'entrée :
- Tous les événements d'entrée sont traités comme prévu.
- Après avoir touché l'écran tactile et exécuté
dumpsys
en même temps, la ligneTouchStates
identifie correctement la fenêtre concernée.
Tester les performances de l'UI
Spécifier le service gfxinfo
génère une sortie avec des informations sur les performances liées aux images d'animation qui se produisent pendant la phase d'enregistrement.
La commande suivante utilise gfxinfo
pour collecter des données sur les performances de l'UI pour le nom de package spécifié :
adb shell dumpsys gfxinfo package-name
Vous pouvez également inclure l'option framestats
pour fournir des informations encore plus détaillées sur le temps de rendu à partir d'images récentes. Cela vous permet d'identifier et de résoudre les problèmes plus précisément :
adb shell dumpsys gfxinfo package-name framestats
Pour savoir comment utiliser gfxinfo
et framestats
afin d'intégrer les mesures des performances de l'UI à vos pratiques de test, consultez Écrire une Macrobenchmark.
Inspecter les diagnostics réseau
Spécifier le service netstats
génère les statistiques d'utilisation du réseau collectées depuis le démarrage de l'appareil précédent. Pour obtenir des informations supplémentaires, telles que des informations détaillées sur l'ID utilisateur unique (UID), incluez l'option detail
, comme suit :
adb shell dumpsys netstats detail
La sortie varie en fonction de la version d'Android exécutée sur l'appareil connecté. Les sections suivantes décrivent le type d'informations que vous voyez généralement.
Interfaces actives et interfaces UID actives
L'exemple de sortie suivant présente les interfaces actives et les interfaces UID actives de l'appareil connecté. Dans la plupart des cas, les informations concernant les interfaces actives et les interfaces UID actives sont identiques.
Active interfaces: iface=wlan0 ident=[{type=WIFI, subType=COMBINED, networkId="Guest"}] Active UID interfaces: iface=wlan0 ident=[{type=WIFI, subType=COMBINED, networkId="Guest"}]
Statistiques "Dev" et "Xt"
Voici un exemple de sortie pour la section des statistiques de développement :
Dev stats: Pending bytes: 1798112 History since boot: ident=[{type=WIFI, subType=COMBINED, networkId="Guest", metered=false}] uid=-1 set=ALL tag=0x0 NetworkStatsHistory: bucketDuration=3600 st=1497891600 rb=1220280 rp=1573 tb=309870 tp=1271 op=0 st=1497895200 rb=29733 rp=145 tb=85354 tp=185 op=0 st=1497898800 rb=46784 rp=162 tb=42531 tp=192 op=0 st=1497902400 rb=27570 rp=111 tb=35990 tp=121 op=0 Xt stats: Pending bytes: 1771782 History since boot: ident=[{type=WIFI, subType=COMBINED, networkId="Guest", metered=false}] uid=-1 set=ALL tag=0x0 NetworkStatsHistory: bucketDuration=3600 st=1497891600 rb=1219598 rp=1557 tb=291628 tp=1255 op=0 st=1497895200 rb=29623 rp=142 tb=82699 tp=182 op=0 st=1497898800 rb=46684 rp=160 tb=39756 tp=191 op=0 st=1497902400 rb=27528 rp=110 tb=34266 tp=120 op=0
Statistiques UID
Vous trouverez ci-dessous un exemple des statistiques détaillées de chaque UID.
UID stats: Pending bytes: 744 Complete history: ident=[[type=MOBILE_SUPL, subType=COMBINED, subscriberId=311111...], [type=MOBILE, subType=COMBINED, subscriberId=311111...]] uid=10007 set=DEFAULT tag=0x0 NetworkStatsHistory: bucketDuration=7200000 bucketStart=1406167200000 activeTime=7200000 rxBytes=4666 rxPackets=7 txBytes=1597 txPackets=10 operations=0 ident=[[type=WIFI, subType=COMBINED, networkId="MySSID"]] uid=10007 set=DEFAULT tag=0x0 NetworkStatsHistory: bucketDuration=7200000 bucketStart=1406138400000 activeTime=7200000 rxBytes=17086802 rxPackets=15387 txBytes=1214969 txPackets=8036 operations=28 bucketStart=1406145600000 activeTime=7200000 rxBytes=2396424 rxPackets=2946 txBytes=464372 txPackets=2609 operations=70 bucketStart=1406152800000 activeTime=7200000 rxBytes=200907 rxPackets=606 txBytes=187418 txPackets=739 operations=0 bucketStart=1406160000000 activeTime=7200000 rxBytes=826017 rxPackets=1126 txBytes=267342 txPackets=1175 operations=35
Pour trouver l'UID de votre application, exécutez la commande adb shell dumpsys
package your-package-name
. Recherchez ensuite la ligne intitulée userId
.
Par exemple, pour connaître l'utilisation du réseau pour l'application "com.example.myapp", exécutez la commande suivante :
adb shell dumpsys package com.example.myapp | grep userId
Le résultat devrait être semblable à celui-ci :
userId=10007 gids=[3003, 1028, 1015]
En utilisant l'exemple de vidage ci-dessus, recherchez les lignes contenant uid=10007
. Deux lignes de ce type existent : la première indique une connexion mobile et la seconde une connexion Wi-Fi. Sous chaque ligne, les informations suivantes s'affichent pour chaque période de deux heures (que bucketDuration
spécifie en millisecondes) :
-
set=DEFAULT
indique l'utilisation du réseau au premier plan, tandis queset=BACKGROUND
indique l'utilisation en arrière-plan.set=ALL
implique les deux. -
tag=0x0
indique le tag de socket associé au trafic. -
rxBytes
etrxPackets
représentent les octets reçus et les paquets reçus dans l'intervalle de temps correspondant. -
txBytes
ettxPackets
représentent les octets envoyés (transmis) et les paquets envoyés dans l'intervalle de temps correspondant.
Inspecter les diagnostics de la batterie
Spécifier le service batterystats
génère des données statistiques sur l'utilisation de la batterie sur un appareil, classées par ID utilisateur unique (UID). Pour savoir comment utiliser dumpsys
pour tester les fonctionnalités Sommeil et Mise en veille des applications, consultez Tester les fonctionnalités Sommeil et Mise en veille des applications.
La commande pour batterystats
est la suivante :
adb shell dumpsys batterystats options
Pour afficher la liste des options supplémentaires disponibles pour batterystats
, incluez l'option -h
. L'exemple ci-dessous génère des statistiques sur l'utilisation de la batterie pour un package d'application spécifié depuis la dernière charge de l'appareil :
adb shell dumpsys batterystats --charged package-name
Le résultat inclut généralement les éléments suivants :
- Historique des événements liés à la batterie
- Statistiques globales de l'appareil
- Consommation énergétique approximative par UID et composant système
- Nombre de millisecondes mobiles par application par paquet
- Statistiques agrégées de l'UID du système
- Statistiques agrégées de l'UID de l'application
Pour en savoir plus sur l'utilisation de batterystats
et la génération d'une visualisation HTML de la sortie (ce qui facilite la compréhension et le diagnostic des problèmes de batterie), consultez Profiler l'utilisation de la batterie avec Batterystats et Battery Historian.
Inspecter la sortie lisible par l'ordinateur
Vous pouvez générer une sortie batterystats
au format CSV lisible par l'ordinateur à l'aide de la commande suivante :
adb shell dumpsys batterystats --checkin
Voici un exemple de résultat :
9,0,i,vers,11,116,K,L 9,0,i,uid,1000,android 9,0,i,uid,1000,com.android.providers.settings 9,0,i,uid,1000,com.android.inputdevices 9,0,i,uid,1000,com.android.server.telecom ... 9,0,i,dsd,1820451,97,s-,p- 9,0,i,dsd,3517481,98,s-,p- 9,0,l,bt,0,8548446,1000983,8566645,1019182,1418672206045,8541652,994188 9,0,l,gn,0,0,666932,495312,0,0,2104,1444 9,0,l,m,6794,0,8548446,8548446,0,0,0,666932,495312,0,697728,0,0,0,5797,0,0 ...
Les observations sur l'utilisation de la batterie peuvent être faites par UID ou au niveau du système. Les données sont incluses en fonction de leur utilité pour analyser les performances de la batterie. Chaque ligne représente une observation, avec les éléments suivants :
- Un entier d'espace réservé
- L'ID utilisateur associé à l'observation
- Le mode d'agrégation :
i
pour les informations non liées à l'état chargé/non chargé.l
pour--charged
(utilisation depuis la dernière charge).u
pour--unplugged
(utilisation depuis le dernier débranchement). Obsolète dans Android 5.1.1.
- Identifiant de section, qui détermine comment interpréter les valeurs suivantes de la ligne.
Le tableau suivant décrit les différents identifiants de section que vous pouvez rencontrer :
Tableau 2. Liste des identifiants de section
Identifiant de section | Description | Champs restants |
---|---|---|
|
Version |
|
|
UID |
|
|
APK |
|
|
Processus |
|
|
Capteur |
|
|
Vibreur |
|
|
Premier plan |
|
|
Heure de l'état |
|
|
Wakelock |
|
|
Synchronisation |
|
|
Tâche |
|
|
Wakelock du noyau |
|
|
Motif du wakeup |
|
|
Réseau |
|
|
Activité de l'utilisateur |
|
|
Batterie |
|
|
Décharge de la batterie |
|
|
Niveau de batterie |
|
|
Wi-Fi |
|
|
Wi-Fi global |
|
|
Bluetooth global |
|
|
Divers |
|
|
Réseau global |
|
|
Luminosité de l'écran |
|
|
Durée d'analyse du signal |
|
|
Durée d'intensité du signal |
|
|
Nombre d'intensités du signal |
|
|
Durée de connexion de données |
|
|
Nombre de connexions de données |
|
|
Heure d'état du Wi-Fi |
|
|
Nombre d'états du Wi-Fi |
|
|
Heure d'état du fournisseur Wi-Fi |
|
|
Nombre d'états du fournisseur Wi-Fi |
|
|
Durée d'intensité du signal Wi-Fi |
|
|
Nombre d'intensités du signal Wi-Fi |
|
|
Heure d'état du Bluetooth |
|
|
Nombre d'états du Bluetooth |
|
|
Résumé de la consommation électrique |
|
|
Élément de consommation électrique |
|
|
Étape de décharge |
|
|
Étape de charge |
|
|
Temps de décharge restant |
|
|
Temps de charge restant |
|
Remarque : Avant Android 6.0, la consommation électrique pour la radio Bluetooth, la radio mobile et le Wi-Fi était suivie dans la catégorie m
(Divers). Sur Android 6.0 et versions ultérieures, la consommation électrique de ces composants est suivie dans la section pwi
(Élément de consommation électrique), avec des libellés individuels (wifi
, blue
, cell
) pour chaque composant.
Afficher les allocations de mémoire
Vous pouvez inspecter l'utilisation de la mémoire de votre application de deux manières : sur une période donnée à l'aide de procstats
ou à un moment précis à l'aide de meminfo
.
Les sections suivantes expliquent comment utiliser ces deux méthodes.
procstats
procstats
permet de voir comment votre application se comporte au fil du temps, y compris la durée d'exécution en arrière-plan et la quantité de mémoire utilisée pendant cette période. Cela vous permet de détecter rapidement les problèmes d'efficacité et les comportements inappropriés de votre application, comme les fuites de mémoire, qui peuvent affecter ses performances, en particulier sur les appareils à faible mémoire. Son vidage d'état affiche des statistiques sur le temps d'exécution, la taille de l'ensemble proportionnel (PSS), la taille de l'ensemble unique (USS) et la taille de l'ensemble résident (RSS) de chaque application.
Pour obtenir des statistiques sur l'utilisation de la mémoire de l'application au cours des trois dernières heures, dans un format lisible, exécutez la commande suivante :
adb shell dumpsys procstats --hours 3
Comme indiqué dans l'exemple suivant, le résultat affiche le pourcentage de temps d'exécution de l'application, ainsi que le PSS, l'USS et le RSS sous la forme minPSS-avgPSS-maxPSS/minUSS-avgUSS-maxUSS/minRSS-avgRSS-maxRSS
sur le nombre d'échantillons.
AGGREGATED OVER LAST 3 HOURS: * com.android.systemui / u0a37 / v28: TOTAL: 100% (15MB-16MB-17MB/7.7MB-8.7MB-9.4MB/7.7MB-9.6MB-84MB over 178) Persistent: 100% (15MB-16MB-17MB/7.7MB-8.7MB-9.4MB/7.7MB-9.6MB-84MB over 178) * com.android.se / 1068 / v28: TOTAL: 100% (2.8MB-2.9MB-2.9MB/300KB-301KB-304KB/304KB-22MB-33MB over 3) Persistent: 100% (2.8MB-2.9MB-2.9MB/300KB-301KB-304KB/304KB-22MB-33MB over 3) * com.google.android.gms.persistent / u0a7 / v19056073: TOTAL: 100% (37MB-38MB-40MB/27MB-28MB-29MB/124MB-125MB-126MB over 2) Imp Fg: 100% (37MB-38MB-40MB/27MB-28MB-29MB/124MB-125MB-126MB over 2) ... * com.android.gallery3d / u0a62 / v40030: TOTAL: 0.01% Receiver: 0.01% (Cached): 54% (6.4MB-6.5MB-6.9MB/4.4MB-4.4MB-4.4MB/4.4MB-26MB-68MB over 6) * com.google.android.tvlauncher / u0a30 / v1010900130: TOTAL: 0.01% Receiver: 0.01% (Cached): 91% (5.8MB-13MB-14MB/3.5MB-10MB-12MB/12MB-33MB-78MB over 6) * com.android.vending:instant_app_installer / u0a16 / v81633968: TOTAL: 0.01% Receiver: 0.01% (Cached): 100% (14MB-15MB-16MB/3.8MB-4.2MB-5.1MB/3.8MB-30MB-95MB over 7) ... Run time Stats: SOff/Norm: +32m52s226ms SOn /Norm: +2h10m8s364ms Mod : +17s930ms TOTAL: +2h43m18s520ms Memory usage: Kernel : 265MB (38 samples) Native : 73MB (38 samples) Persist: 262MB (90 samples) Top : 190MB (325 samples) ImpFg : 204MB (569 samples) ImpBg : 754KB (345 samples) Service: 93MB (1912 samples) Receivr: 227KB (1169 samples) Home : 66MB (12 samples) LastAct: 30MB (255 samples) CchAct : 220MB (450 samples) CchCAct: 193MB (71 samples) CchEmty: 182MB (652 samples) Cached : 58MB (38 samples) Free : 60MB (38 samples) TOTAL : 1.9GB ServRst: 50KB (278 samples) Start time: 2015-04-08 13:44:18 Total elapsed time: +2h43m18s521ms (partial) libart.so
meminfo
Vous pouvez enregistrer un instantané de la répartition de la mémoire de votre application entre différents types d'allocation de RAM à l'aide de la commande suivante :
adb shell dumpsys meminfo package_name|pid [-d]
L'indicateur -d
affiche davantage d'informations sur l'utilisation de la mémoire Dalvik et ART.
La sortie présente toutes les allocations actuelles de votre application, mesurées en kilo-octets.
Lorsque vous inspectez ces informations, vous devez connaître les types d'allocation suivants :
- RAM privée (propre et modifiée)
- Cette mémoire n'est utilisée que par votre processus. Il s'agit de la majeure partie de la RAM que le système peut récupérer lorsque le processus de votre application est détruit. En général, la partie la plus importante est la mémoire RAM modifiée privée, qui est la plus chère. En effet, elle n'est utilisée que par votre processus et son contenu n'existe que dans la RAM, il ne peut donc pas être paginé vers le stockage (car Android n'utilise pas l'échange). Toutes les allocations de segments de mémoire et natives que vous effectuez sont de la RAM modifiée privée. Les allocations Dalvik et natives que vous partagez avec le processus Zygote sont de la RAM modifiée partagée.
- Taille de l'ensemble proportionnel (PSS)
- Il s'agit d'une mesure de l'utilisation de la RAM de votre application qui prend en compte les pages de partage entre les processus. Toutes les pages RAM propres à votre processus contribuent directement à sa valeur PSS, tandis que les pages partagées avec d'autres processus contribuent à la valeur PSS uniquement en fonction du volume de partage. Par exemple, une page partagée entre deux processus contribue pour la moitié de sa taille au PPS de chaque processus.
Une caractéristique intéressante de la mesure PSS est que vous pouvez additionner le PSS de tous les processus afin de déterminer la mémoire réelle utilisée par l'ensemble des processus. Cela signifie que le PSS est une bonne mesure de la pondération réelle de la RAM d'un processus et permet de comparer l'utilisation de la RAM par d'autres processus et la RAM totale disponible.
Par exemple, voici la sortie du processus de Map sur un appareil Nexus 5 :
adb shell dumpsys meminfo com.google.android.apps.maps -d
Remarque : Les informations que vous voyez peuvent être légèrement différentes de celles présentées ici, car certains détails de la sortie diffèrent selon les versions de la plate-forme.
** MEMINFO in pid 18227 [com.google.android.apps.maps] ** Pss Private Private Swapped Heap Heap Heap Total Dirty Clean Dirty Size Alloc Free ------ ------ ------ ------ ------ ------ ------ Native Heap 10468 10408 0 0 20480 14462 6017 Dalvik Heap 34340 33816 0 0 62436 53883 8553 Dalvik Other 972 972 0 0 Stack 1144 1144 0 0 Gfx dev 35300 35300 0 0 Other dev 5 0 4 0 .so mmap 1943 504 188 0 .apk mmap 598 0 136 0 .ttf mmap 134 0 68 0 .dex mmap 3908 0 3904 0 .oat mmap 1344 0 56 0 .art mmap 2037 1784 28 0 Other mmap 30 4 0 0 EGL mtrack 73072 73072 0 0 GL mtrack 51044 51044 0 0 Unknown 185 184 0 0 TOTAL 216524 208232 4384 0 82916 68345 14570 Dalvik Details .Heap 6568 6568 0 0 .LOS 24771 24404 0 0 .GC 500 500 0 0 .JITCache 428 428 0 0 .Zygote 1093 936 0 0 .NonMoving 1908 1908 0 0 .IndirectRef 44 44 0 0 Objects Views: 90 ViewRootImpl: 1 AppContexts: 4 Activities: 1 Assets: 2 AssetManagers: 2 Local Binders: 21 Proxy Binders: 28 Parcel memory: 18 Parcel count: 74 Death Recipients: 2 OpenSSL Sockets: 2
Voici un ancien dumpsys
sur Dalvik de l'application Gmail :
** MEMINFO in pid 9953 [com.google.android.gm] ** Pss Pss Shared Private Shared Private Heap Heap Heap Total Clean Dirty Dirty Clean Clean Size Alloc Free ------ ------ ------ ------ ------ ------ ------ ------ ------ Native Heap 0 0 0 0 0 0 7800 7637(6) 126 Dalvik Heap 5110(3) 0 4136 4988(3) 0 0 9168 8958(6) 210 Dalvik Other 2850 0 2684 2772 0 0 Stack 36 0 8 36 0 0 Cursor 136 0 0 136 0 0 Ashmem 12 0 28 0 0 0 Other dev 380 0 24 376 0 4 .so mmap 5443(5) 1996 2584 2664(5) 5788 1996(5) .apk mmap 235 32 0 0 1252 32 .ttf mmap 36 12 0 0 88 12 .dex mmap 3019(5) 2148 0 0 8936 2148(5) Other mmap 107 0 8 8 324 68 Unknown 6994(4) 0 252 6992(4) 0 0 TOTAL 24358(1) 4188 9724 17972(2)16388 4260(2)16968 16595 336 Objects Views: 426 ViewRootImpl: 3(8) AppContexts: 6(7) Activities: 2(7) Assets: 2 AssetManagers: 2 Local Binders: 64 Proxy Binders: 34 Death Recipients: 0 OpenSSL Sockets: 1 SQL MEMORY_USED: 1739 PAGECACHE_OVERFLOW: 1164 MALLOC_SIZE: 62
En règle générale, ne vous préoccupez que des colonnes Pss Total
et Private Dirty
.
Dans certains cas, les colonnes Private Clean
et Heap Alloc
contiennent également des données intéressantes.
Voici des informations supplémentaires sur les différentes allocations de mémoire :
Dalvik Heap
- La RAM utilisée par les allocations Dalvik dans votre application.
Pss Total
inclut toutes les allocations Zygote, pondérées par leur partage entre les processus, comme expliqué dans la définition du PSS. Le nombrePrivate Dirty
correspond à la RAM réelle dédiée uniquement au tas de mémoire de votre application. Elle se compose de vos propres allocations et de toutes les pages d'allocation Zygote qui ont été modifiées depuis la duplication du processus de votre application à partir de Zygote.Remarque : Sur les nouvelles versions de plates-formes comportant la section
Dalvik Other
, les nombresPss Total
etPrivate Dirty
pour le tas de mémoire Dalvik n'incluent pas la surcharge Dalvik, comme la compilation juste-à-temps (JIT) et la comptabilité GC, tandis que les anciennes versions présentent toutes ces informations sousDalvik
.Heap Alloc
correspond à la quantité de mémoire dont les outils d'allocation de segments de mémoire Dalvik et natifs effectuent le suivi pour votre application. Cette valeur est supérieure àPss Total
etPrivate Dirty
, car votre processus a été dupliqué à partir de Zygote et inclut les allocations qu'il partage avec tous les autres. .so mmap
et.dex mmap
- La RAM utilisée pour le code
.so
(natif) mappé et le code.dex
(Dalvik ou ART). Le nombrePss Total
inclut le code de plate-forme partagé entre les applications.Private Clean
correspond au code de votre application. En général, la taille mappée réelle est plus importante. Ici, la RAM n'est que celle qui doit être présente pour le code exécuté par l'application. Cependant,.so mmap
présente une RAM privée modifiée élevée, en raison des corrections apportées au code natif lors de son chargement dans son adresse finale. .oat mmap
- Il s'agit de la quantité de RAM utilisée par l'image du code. Elle est basée sur les classes préchargées couramment utilisées par plusieurs applications. Cette image est partagée entre toutes les applications et n'est pas affectée par des applications particulières.
.art mmap
- Il s'agit de la quantité de RAM utilisée par l'image du tas de mémoire. Elle est basée sur les classes préchargées couramment utilisées par plusieurs applications. Cette image est partagée entre toutes les applications et n'est pas affectée par des applications particulières. Même si l'image ART contient des instances
Object
, elle n'est pas comptabilisée dans votre taille de tas de mémoire. .Heap
(uniquement avec l'indicateur-d
)- Il s'agit de la quantité de mémoire de tas de votre application. Cela exclut les objets dans l'image et les grands espaces d'objets, mais inclut l'espace zygote et l'espace immobile.
.LOS
(uniquement avec l'indicateur-d
)- Il s'agit de la quantité de RAM utilisée par le grand espace d'objets ART. Cela inclut les grands objets Zygote. Les grands objets correspondent à toutes les allocations de tableau primitif d'une taille supérieure à 12 Ko.
.GC
(uniquement avec l'indicateur-d
)- Il s'agit des coûts généraux associés à la récupération de mémoire. Il n'existe aucun moyen de les réduire.
.JITCache
(uniquement avec l'indicateur-d
)- Il s'agit de la quantité de mémoire utilisée par les caches de données et de code JIT. Elle est généralement égale à zéro, car toutes les applications sont compilées au moment de l'installation.
.Zygote
(uniquement avec l'indicateur-d
)- Il s'agit de la quantité de mémoire utilisée par l'espace Zygote. Celui-ci est créé au démarrage de l'appareil et n'est jamais alloué.
.NonMoving
(uniquement avec l'indicateur-d
)- Il s'agit de la quantité de RAM utilisée par l'espace immobile ART. Celui-ci contient des objets spéciaux qui ne peuvent pas être déplacés, comme des champs et des méthodes. Vous pouvez réduire cette section en utilisant moins de champs et de méthodes dans votre application.
.IndirectRef
(uniquement avec l'indicateur-d
)- Il s'agit de la quantité de RAM utilisée par les tables de référence indirectes ART. Généralement, cette quantité est faible, mais si elle est trop élevée, il peut être possible de la réduire en diminuant le nombre de références JNI locales et globales utilisées.
Unknown
- Les pages RAM qui n'ont pas pu être classées par le système dans l'un des autres éléments plus spécifiques. Actuellement, il s'agit principalement des allocations natives, qui ne peuvent pas être identifiées par l'outil lors de la collecte de ces données en raison de la distribution aléatoire de l'espace d'adressage. À l'instar du tas de mémoire Dalvik,
Pss Total
pourUnknown
prend en compte le partage avec Zygote, etPrivate Dirty
est une RAM inconnue dédiée uniquement à votre application. TOTAL
- La taille totale de la RAM PSS (Taille de l'ensemble proportionnel) utilisée par votre processus. Il s'agit de la somme de tous les champs PSS au-dessus. Elle indique la pondération globale de la mémoire de votre processus, qui peut être directement comparée aux autres processus et à la RAM totale disponible.
Private Dirty
etPrivate Clean
correspondent aux allocations totales de votre processus, qui ne sont pas partagées avec d'autres processus. Lorsque votre processus est détruit, toute la RAM de ces allocations est libérée pour le système.Private Clean
peut également être paginé et libéré avant la destruction de votre processus, maisPrivate Dirty
n'est libéré qu'à la destruction du processus.La RAM modifiée correspond aux pages qui ont été modifiées et doivent donc rester réservées à la RAM, car il n'y a pas d'échange. La RAM propre correspond aux pages qui ont été mappées à partir d'un fichier persistant (comme le code en cours d'exécution) et qui peuvent donc être écartées si elles ne sont pas utilisées pendant un certain temps.
ViewRootImpl
- Le nombre de vues racines actives dans votre processus. Chaque vue racine est associée à une fenêtre, ce qui permet d'identifier les fuites de mémoire qui impliquent des boîtes de dialogue ou d'autres fenêtres.
AppContexts
etActivities
- Le nombre d'objets d'application
Context
etActivity
qui sont actuellement inclus dans votre processus. Cela peut vous aider à identifier rapidement les objetsActivity
qui ont fuité et qui ne peuvent pas être récupérés en raison de références statiques sur eux, ce qui est courant. Ces objets sont souvent associés à de nombreuses autres allocations, ce qui en fait un bon moyen de suivre les fuites de mémoire volumineuses.