dumpsys

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 dans EventHub.h, par exemple INPUT_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 ligne type 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 ligne TouchStates 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 que set=BACKGROUND indique l'utilisation en arrière-plan. set=ALL implique les deux.
  • tag=0x0 indique le tag de socket associé au trafic.
  • rxBytes et rxPackets représentent les octets reçus et les paquets reçus dans l'intervalle de temps correspondant.
  • txBytes et txPackets 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

vers

Version

checkin version, parcel version, start platform version, end platform version

uid

UID

uid, package name

apk

APK

wakeups, APK, service, start time, starts, launches

pr

Processus

process, user, system, foreground, starts

sr

Capteur

sensor number, time, count

vib

Vibreur

time, count

fg

Premier plan

time, count

st

Heure de l'état

foreground, active, running

wl

Wakelock

wake lock, full time, f, full count, partial time, p, partial count, window time, w, window count

sy

Synchronisation

sync, time, count

jb

Tâche

job, time, count

kwl

Wakelock du noyau

kernel wake lock, time, count

wr

Motif du wakeup

wakeup reason, time, count

nt

Réseau

mobile bytes RX, mobile bytes TX, Wi-Fi bytes RX, Wi-Fi bytes TX, mobile packets RX, mobile packets TX, Wi-Fi packets RX, Wi-Fi packets TX, mobile active time, mobile active count

ua

Activité de l'utilisateur

other, button, touch

bt

Batterie

start count, battery realtime, battery uptime, total realtime, total uptime, start clock time, battery screen off realtime, battery screen off uptime

dc

Décharge de la batterie

low, high, screen on, screen off

lv

Niveau de batterie

start level, current level

wfl

Wi-Fi

full Wi-Fi lock on time, Wi-Fi scan time, Wi-Fi running time, Wi-Fi scan count, Wi-Fi idle time, Wi-Fi receive time, Wi-Fi transmit time

gwfl

Wi-Fi global

Wi-Fi on time, Wi-Fi running time, Wi-Fi idle time, Wi-Fi receive time, Wi-Fi transmit time, Wi-Fi power (mAh)

gble

Bluetooth global

BT idle time, BT receive time, BT transmit time, BT power (mAh)

m

Divers

screen on time, phone on time, full wakelock time total, partial wakelock time total, mobile radio active time, mobile radio active adjusted time, interactive time, power save mode enabled time, connectivity changes, device idle mode enabled time, device idle mode enabled count, device idling time, device idling count, mobile radio active count, mobile radio active unknown time

gn

Réseau global

mobile RX total bytes, mobile TX total bytes, Wi-Fi RX total bytes, Wi-Fi TX total bytes, mobile RX total packets, mobile TX total packets, Wi-Fi RX total packets, Wi-Fi TX total packets

br

Luminosité de l'écran

dark, dim, medium, light, bright

sst

Durée d'analyse du signal

signal scanning time

sgt

Durée d'intensité du signal

none, poor, moderate, good, great

sgc

Nombre d'intensités du signal

none, poor, moderate, good, great

dct

Durée de connexion de données

none, GPRS, EDGE, UMTS, CDMA, EVDO_0, EVDO_A, 1xRTT, HSDPA, HSUPA, HSPA, IDEN, EVDO_B, LTE, EHRPD, HSPAP, other

dcc

Nombre de connexions de données

none, GPRS, EDGE, UMTS, CDMA, EVDO_0, EVDO_A, 1xRTT, HSDPA, HSUPA, HSPA, IDEN, EVDO_B, LTE, EHRPD, HSPAP, other

wst

Heure d'état du Wi-Fi

off, off scanning, on no networks, on disconnected, on connected STA, on connected P2P, on connected STA P2P, soft AP

wsc

Nombre d'états du Wi-Fi

off, off scanning, on no networks on disconnected, on connected STA, on connected P2P, on connected STA P2P soft AP

wsst/p>

Heure d'état du fournisseur Wi-Fi

invalid, disconnected, interface disabled, inactive, scanning, authenticating, associating, associated, four-way handshake, group handshake, completed, dormant, uninitialized

wssc

Nombre d'états du fournisseur Wi-Fi

invalid, disconnected, interface disabled, inactive, scanning, authenticating, associating, associated, four-way handshake, group handshake, completed, dormant, uninitialized

wsgt

Durée d'intensité du signal Wi-Fi

none, poor, moderate, good, great

wsgc

Nombre d'intensités du signal Wi-Fi

none, poor, moderate, good, great

bst

Heure d'état du Bluetooth

inactive, low, med, high

bsc

Nombre d'états du Bluetooth

inactive, low, med, high

pws

Résumé de la consommation électrique

battery capacity, computed power, minimum drained power, maximum drained power

pwi

Élément de consommation électrique

label, mAh

dsd

Étape de décharge

duration, level, screen, power-save

csd

Étape de charge

duration, level, screen, power-save

dtr

Temps de décharge restant

battery time remaining

ctr

Temps de charge restant

charge time remaining

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 nombre Private 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 nombres Pss Total et Private 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 sous Dalvik.

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 et Private 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 nombre Pss 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 pour Unknown prend en compte le partage avec Zygote, et Private 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 et Private 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, mais Private 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 et Activities
Le nombre d'objets d'application Context et Activity qui sont actuellement inclus dans votre processus. Cela peut vous aider à identifier rapidement les objets Activity 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.