dumpsys

dumpsys ist ein Tool, das auf Android-Geräten ausgeführt wird und Informationen zu Systemdiensten bereitstellt. Rufe dumpsys über die Befehlszeile mit der Android Debug Bridge (ADB) auf, um eine Diagnoseausgabe für alle Systemdienste zu erhalten, die auf einem verbundenen Gerät ausgeführt werden.

Diese Ausgabe ist in der Regel ausführlicher als gewünscht. Verwenden Sie daher die Befehlszeilenoptionen auf dieser Seite, um nur die gewünschten Systemdienste anzuzeigen. Auf dieser Seite wird auch beschrieben, wie Sie mit dumpsys häufige Aufgaben ausführen, z. B. die Eingabe, den RAM, den Akku oder die Netzwerkdiagnose prüfen.

Syntax

Die allgemeine Syntax für die Verwendung von dumpsys lautet:

 adb shell dumpsys [-t timeout] [--help | -l | --skip services | service [arguments] | -c | -h]

Wenn Sie eine Diagnoseausgabe für alle Systemdienste Ihres verbundenen Geräts erhalten möchten, führen Sie adb shell dumpsys aus. Dies führt jedoch zu weitaus mehr Informationen, als Sie normalerweise benötigen. Wenn Sie eine überschaubarere Ausgabe erhalten möchten, geben Sie den Dienst an, den Sie prüfen möchten, indem Sie ihn in den Befehl aufnehmen. Der folgende Befehl liefert beispielsweise Systemdaten für Eingabekomponenten wie Touchscreens oder integrierte Tastaturen:

adb shell dumpsys input

Eine vollständige Liste der Systemdienste, die Sie mit dumpsys verwenden können, erhalten Sie mit dem folgenden Befehl:

adb shell dumpsys -l

Befehlszeilenoptionen

In der folgenden Tabelle sind die verfügbaren Optionen bei Verwendung von dumpsys aufgeführt:

Tabelle 1 Liste der verfügbaren Optionen für dumpsys

Option Beschreibung
-t timeout Geben Sie das Zeitlimit in Sekunden an. Wenn keine Angabe erfolgt, beträgt der Standardwert 10 Sekunden.
--help Hilfetext für das dumpsys-Tool ausdrucken
-l Eine vollständige Liste der Systemdienste, die Sie mit dumpsys verwenden können.
--skip services Geben Sie die services an, die nicht in die Ausgabe aufgenommen werden sollen.
service [arguments] Geben Sie die service an, die Sie ausgeben möchten. Bei einigen Diensten können Sie optionale arguments übergeben. Wenn Sie mehr über diese optionalen Argumente erfahren möchten, übergeben Sie die Option -h mit dem Dienst:
adb shell dumpsys procstats -h
    
-c Wenn Sie bestimmte Dienste angeben, hängen Sie diese Option an, um Daten in einem maschinenlesbaren Format auszugeben.
-h Fügen Sie diese Option für bestimmte Dienste hinzu, um Hilfetext und zusätzliche Optionen für diesen Dienst zu sehen.

Eingabediagnose prüfen

Wenn Sie den Dienst input wie im folgenden Befehl angegeben angeben, wird der Status der Eingabegeräte des Systems wie Tastaturen und Touchscreens sowie die Verarbeitung von Eingabeereignissen ausgegeben.

adb shell dumpsys input

Die Ausgabe variiert je nach Android-Version, die auf dem verbundenen Gerät ausgeführt wird. In den folgenden Abschnitten werden die Informationen beschrieben, die Sie normalerweise sehen.

Event Hub-Status

Im Folgenden sehen Sie ein Beispiel für die Informationen, die Sie beim Prüfen des Event Hub-Status der Eingabediagnose sehen können:

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
...

Lesemodusstatus eingeben

Der InputReader ist für die Dekodierung von Eingabeereignissen aus dem Kernel verantwortlich. Der Status-Dump enthält Informationen dazu, wie jedes Eingabegerät konfiguriert ist, und zu den letzten Zustandsänderungen, z. B. Tastendrücke oder Berührungen des Touchscreens.

Das folgende Beispiel zeigt die Ausgabe für einen Touchscreen. Notieren Sie sich die Informationen zur Auflösung des Geräts und die verwendeten Kalibrierungsparameter.

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

Am Ende des Dumps des Eingabelesegerätstatus finden Sie einige Informationen zu globalen Konfigurationsparametern, z. B. zum Tippintervall:

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

Status des Eingabe-Dispatchers

Der InputDispatcher ist für das Senden von Eingabeereignissen an Anwendungen verantwortlich. Wie in der folgenden Beispielausgabe zu sehen, enthält der Status-Dump Informationen dazu, welches Fenster berührt wird, den Status der Eingabewarteschlange, ob eine ANR-Meldung aktiv ist, und andere Informationen zu Eingabeereignissen:

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

Was Sie prüfen sollten

Im Folgenden finden Sie einige Punkte, die Sie bei der Prüfung der Ausgabe für den input-Dienst beachten sollten:

Status des Event Brokers:

  • Alle erwarteten Eingabegeräte sind vorhanden.
  • Jedes Eingabegerät hat eine entsprechende Datei für das Tastenlayout, eine Datei für die Tastenbelegung und eine Konfigurationsdatei für das Eingabegerät. Wenn die Dateien fehlen oder Syntaxfehler enthalten, werden sie nicht geladen.
  • Jedes Eingabegerät wird korrekt klassifiziert. Die Bits im Feld Classes entsprechen Flags in EventHub.h, z. B. INPUT_DEVICE_CLASS_TOUCH_MT.
  • Die BuiltInKeyboardId ist richtig. Wenn das Gerät keine integrierte Tastatur hat, muss die ID -2 sein. Andernfalls sollte es sich um die ID der integrierten Tastatur handeln.
    • Wenn die Taste BuiltInKeyboardId nicht -2 ist, aber sein sollte, fehlt eine Datei mit einer Tastenbelegung für eine Tastatur mit Sonderfunktionen. Geräte mit einer Tastatur mit Sonderfunktionen sollten Dateien mit Tastenbelegungen haben, die nur die Zeile type SPECIAL_FUNCTION enthalten.

Leserstatus eingeben:

  • Alle erwarteten Eingabegeräte sind vorhanden.
  • Alle Eingabegeräte sind richtig konfiguriert. Prüfen Sie insbesondere, ob die Touchscreen- und Joystickachsen korrekt sind.

Status des Eingabe-Dispatchers:

  • Alle Eingabeereignisse werden wie erwartet verarbeitet.
  • Wenn Sie den Touchscreen berühren und gleichzeitig dumpsys ausführen, wird in der TouchStates-Zeile das Fenster korrekt identifiziert, das Sie berühren.

UI-Leistung testen

Wenn Sie den gfxinfo-Dienst angeben, enthält die Ausgabe Leistungsinformationen zu Frames der Animation, die während der Aufnahmephase auftreten. Im folgenden Befehl werden mit gfxinfo UI-Leistungsdaten für einen angegebenen Paketnamen erfasst:

adb shell dumpsys gfxinfo package-name

Du kannst auch die Option framestats hinzufügen, um noch detailliertere Informationen zum Frame-Timing aus den letzten Frames anzugeben. So kannst du Probleme genauer nachvollziehen und beheben:

adb shell dumpsys gfxinfo package-name framestats

Weitere Informationen zur Verwendung von gfxinfo und framestats zum Einbinden von UI-Leistungsmessungen in Ihre Testverfahren finden Sie unter Macrobenchmark schreiben.

Netzwerkdiagnose prüfen

Wenn Sie den Dienst netstats angeben, werden Netzwerknutzungsstatistiken angezeigt, die seit dem letzten Start des Geräts erfasst wurden. Wenn Sie zusätzliche Informationen ausgeben möchten, z. B. detaillierte Informationen zur eindeutigen Nutzer-ID (Unique User ID, UID), fügen Sie die Option detail hinzu.

adb shell dumpsys netstats detail

Die Ausgabe variiert je nach Android-Version, die auf dem verbundenen Gerät ausgeführt wird. In den folgenden Abschnitten werden die Informationen beschrieben, die Sie normalerweise sehen.

Aktive Schnittstellen und aktive UID-Schnittstellen

In der folgenden Beispielausgabe sind die aktiven Schnittstellen und aktiven UID-Schnittstellen des verbundenen Geräts aufgeführt. In den meisten Fällen sind die Informationen für aktive Schnittstellen und aktive UID-Schnittstellen identisch.

Active interfaces:
  iface=wlan0 ident=[{type=WIFI, subType=COMBINED, networkId="Guest"}]
Active UID interfaces:
  iface=wlan0 ident=[{type=WIFI, subType=COMBINED, networkId="Guest"}]

„Dev“- und „Xt“-Statistiken

Im Folgenden finden Sie eine Beispielausgabe für den Abschnitt „Entwicklerstatistiken“:

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

UID-Statistiken

Im Folgenden finden Sie ein Beispiel für detaillierte Statistiken für jede 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

Führen Sie den Befehl adb shell dumpsys package your-package-name aus, um die UID Ihrer App zu ermitteln. Suchen Sie dann nach der Zeile mit dem Label userId.

Wenn Sie beispielsweise die Netzwerknutzung für die App „com.beispiel.meineapp“ ermitteln möchten, führen Sie den folgenden Befehl aus:

adb shell dumpsys package com.example.myapp | grep userId

Die Ausgabe sollte in etwa so aussehen:

    userId=10007 gids=[3003, 1028, 1015]

Suchen Sie im vorherigen Beispiel-Dump nach Zeilen mit uid=10007. Es gibt zwei solche Linien: Die erste steht für eine Mobilfunkverbindung und die zweite für eine WLAN-Verbindung. Unter jeder Zeile sehen Sie die folgenden Informationen für jeden zweistündigen Zeitraum, die bucketDuration in Millisekunden angibt:

  • set=DEFAULT steht für die Netzwerknutzung im Vordergrund, set=BACKGROUND für die Nutzung im Hintergrund. set=ALL impliziert beides.
  • tag=0x0 gibt das Socket-Tag an, das mit dem Traffic verknüpft ist.
  • rxBytes und rxPackets stehen für empfangene Byte und empfangene Pakete im entsprechenden Zeitintervall.
  • txBytes und txPackets stehen für gesendet (übertragen) Byte und gesendet Pakete im entsprechenden Zeitintervall.

Akkudiagnose prüfen

Wenn Sie den batterystats-Dienst angeben, werden statistische Daten zur Akkunutzung auf einem Gerät generiert, die nach eindeutiger Nutzer-ID (UID) organisiert sind. Wie Sie Ihre App mit dumpsys auf Doze und App-Standby testen, erfahren Sie unter Mit Doze und App-Standby testen.

Der Befehl für batterystats lautet so:

adb shell dumpsys batterystats options

Wenn Sie eine Liste der zusätzlichen Optionen für batterystats aufrufen möchten, fügen Sie die Option -h hinzu. Im folgenden Beispiel werden Statistiken zur Akkunutzung für ein bestimmtes App-Paket seit dem letzten Aufladen des Geräts ausgegeben:

adb shell dumpsys batterystats --charged package-name

Die Ausgabe enthält in der Regel Folgendes:

  • Verlauf der batteriebezogenen Ereignisse
  • Globale Statistiken für das Gerät
  • Ungefähre Stromverbrauch pro UID und Systemkomponente
  • Millisekunden pro Paket pro App
  • Aggregierte Statistiken nach System-UID
  • Zusammengefasste Statistiken nach App-UID

Weitere Informationen zur Verwendung von batterystats und zum Generieren einer HTML-Visualisierung der Ausgabe, die die Diagnose von Akkuproblemen erleichtert, finden Sie unter Akkunutzung mit Batterystats und Battery Historian erfassen.

Maschinenfreundliche Ausgabe prüfen

Mit dem folgenden Befehl können Sie eine batterystats-Ausgabe im maschinenlesbaren CSV-Format generieren:

adb shell dumpsys batterystats --checkin

Das folgende Beispiel zeigt die Ausgabe:

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
...

Die Beobachtungen zur Akkunutzung können pro UID oder auf Systemebene erfolgen. Die Daten werden anhand ihrer Nützlichkeit für die Analyse der Akkuleistung ausgewählt. Jede Zeile steht für eine Beobachtung mit den folgenden Elementen:

  • Eine Platzhalterganzzahl
  • Die Nutzer-ID, die mit der Beobachtung verknüpft ist
  • Aggregationsmodus:
    • i für Informationen, die nicht mit dem Status „Aufgeladen“ oder „Nicht aufgeladen“ verknüpft sind.
    • l für --charged (Nutzung seit der letzten Aufladung)
    • u für --unplugged (Nutzung seit dem letzten Ausstecken) In Android 5.1.1 eingestellt.
  • Abschnitts-ID, die bestimmt, wie nachfolgende Werte in der Zeile interpretiert werden.

In der folgenden Tabelle werden die verschiedenen Abschnitts-IDs beschrieben, die Sie sehen können:

Tabelle 2 Liste der Abschnitts-IDs

Bereichs-ID Beschreibung Übrige Felder

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

Prozess

process, user, system, foreground, starts

sr

Sensor

sensor number, time, count

vib

Vibrator

time, count

fg

Vordergrund

time, count

st

Zeitzone des Bundesstaats

foreground, active, running

wl

Wake lock

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

sy

Synchronisieren

sync, time, count

jb

Job

job, time, count

kwl

Kernel Wake Lock

kernel wake lock, time, count

wr

Grund für das Aufwachen

wakeup reason, time, count

nt

Netz

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

Nutzeraktivität

other, button, touch

bt

Akku

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

dc

Akkuentladung

low, high, screen on, screen off

lv

Akkustand

start level, current level

wfl

WLAN

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

Global Wi-Fi

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

Global Bluetooth

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

m

Verschiedenes

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

Global Network

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

Bildschirmhelligkeit

dark, dim, medium, light, bright

sst

Signalsuchzeit

signal scanning time

sgt

Signalstärke – Zeit

none, poor, moderate, good, great

sgc

Anzahl der Signalstärken

none, poor, moderate, good, great

dct

Zeit für die Datenverbindung

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

dcc

Anzahl der Datenverbindungen

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

wst

Zeit des WLAN-Status

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

wsc

WLAN-Status – Anzahl

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

wsst/p>

Zeit des WLAN-Supplicant-Status

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

wssc

Anzahl der WLAN-Supplicant-Status

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

wsgt

Zeit der WLAN-Signalstärke

none, poor, moderate, good, great

wsgc

Anzahl der WLAN-Signalstärken

none, poor, moderate, good, great

bst

Bluetooth-Statuszeit

inactive, low, med, high

bsc

Bluetooth-Status – Anzahl

inactive, low, med, high

pws

Zusammenfassung des Stromverbrauchs

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

pwi

Element „Stromverbrauch“

label, mAh

dsd

Entladeschritt

duration, level, screen, power-save

csd

Ladeschritt

duration, level, screen, power-save

dtr

Verbleibende Akkulaufzeit

battery time remaining

ctr

Verbleibende Ladezeit

charge time remaining

Hinweis: Vor Android 6.0 wurde der Energieverbrauch für Bluetooth-Funkschnittstelle, Mobilfunkfunkschnittstelle und WLAN in der Kategorie m (Sonstiges) erfasst. Unter Android 6.0 und höher wird der Energieverbrauch dieser Komponenten im Bereich pwi (Artikel zum Energieverbrauch) mit individuellen Labels (wifi, blue, cell) für jede Komponente erfasst.

Speicherzuweisungen ansehen

Sie haben zwei Möglichkeiten, die Arbeitsspeichernutzung Ihrer App zu prüfen: über einen bestimmten Zeitraum mit procstats oder zu einem bestimmten Zeitpunkt mit meminfo. In den folgenden Abschnitten wird gezeigt, wie Sie beide Methoden verwenden.

procstats

Mit procstats können Sie sehen, wie sich Ihre App im Laufe der Zeit verhält, z. B. wie lange sie im Hintergrund ausgeführt wird und wie viel Arbeitsspeicher sie dabei belegt. So können Sie schnell Ineffizienzen und Fehlfunktionen in Ihrer App finden, z. B. Arbeitsspeicherlecks, die sich auf die Leistung auswirken können, insbesondere wenn die App auf Geräten mit wenig Arbeitsspeicher ausgeführt wird. Der Status-Dump enthält Statistiken zur Laufzeit, zur proportionalen Speichergröße (Proportional Set Size, PSS), zur eindeutigen Speichergröße (Unique Set Size, USS) und zur Resident Set Size (RSS) jeder Anwendung.

Führen Sie folgenden Befehl aus, um Statistiken zur Speichernutzung von Anwendungen in den letzten drei Stunden in einem visuell lesbaren Format abzurufen:

adb shell dumpsys procstats --hours 3

Wie im folgenden Beispiel zu sehen, wird in der Ausgabe der Prozentsatz der Zeit angezeigt, in der die Anwendung ausgeführt wurde, sowie PSS, USS und RSS als minPSS-avgPSS-maxPSS/minUSS-avgUSS-maxUSS/minRSS-avgRSS-maxRSS bezogen auf die Anzahl der Samples.

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

Mit dem folgenden Befehl können Sie einen Snapshot aufzeichnen, der zeigt, wie der Arbeitsspeicher Ihrer App auf verschiedene Arten der RAM-Zuweisung aufgeteilt ist:

adb shell dumpsys meminfo [-d] package_name|pid

Mit dem Flag -d werden weitere Informationen zur Dalvik- und ART-Speichernutzung ausgegeben. Mit dem Flag -h werden alle unterstützten Flags ausgegeben.

In der Ausgabe werden alle aktuellen Zuweisungen Ihrer App in Kilobyte aufgeführt.

Bei der Prüfung dieser Informationen sollten Sie mit den folgenden Arten der Zuordnung vertraut sein:

Privater (sauberer und schmutziger) RAM
Dieser Arbeitsspeicher wird nur von Ihrem Prozess verwendet. Dies ist der Großteil des RAM, den das System zurückfordern kann, wenn der Prozess Ihrer App beendet wird. Der wichtigste Teil davon ist in der Regel der private schmutzige RAM, der am teuersten ist, da er nur von Ihrem Prozess verwendet wird und sein Inhalt nur im RAM vorhanden ist. Er kann also nicht in den Speicher ausgelagert werden, da Android kein Auslagerungsspeicher verwendet. Alle von Ihnen vorgenommenen Dalvik- und nativen Heap-Zuweisungen sind privates schmutziges RAM. Dalvik- und native Zuordnungen, die Sie mit dem Zygote-Prozess teilen, sind gemeinsam genutztes schmutziges RAM.
Proportionale Setgröße (PSS)
Dies ist eine Messung der RAM-Nutzung Ihrer App, bei der die gemeinsame Nutzung von Seiten zwischen Prozessen berücksichtigt wird. Alle RAM-Seiten, die nur für Ihren Prozess verwendet werden, tragen direkt zum PSS-Wert bei. Seiten, die mit anderen Prozessen gemeinsam genutzt werden, tragen nur in dem Maße zum PSS-Wert bei, wie sie gemeinsam genutzt werden. Eine Seite, die zwischen zwei Prozessen gemeinsam genutzt wird, trägt beispielsweise mit der Hälfte ihrer Größe zum PSS jedes Prozesses bei.

Ein Merkmal der PSS-Messung ist, dass Sie den PSS für alle Prozesse addieren können, um den tatsächlichen Arbeitsspeicher zu ermitteln, der von allen Prozessen verwendet wird. Das bedeutet, dass PSS ein guter Maßstab für das tatsächliche RAM-Gewicht eines Prozesses und für den Vergleich mit der RAM-Nutzung anderer Prozesse und dem insgesamt verfügbaren RAM ist.

Hier ist beispielsweise die Ausgabe für den Maps-Prozess auf einem Nexus 5:

adb shell dumpsys meminfo -d com.google.android.apps.maps

Hinweis:Die angezeigten Informationen können leicht von den hier gezeigten abweichen, da sich einige Details der Ausgabe je nach Plattformversion unterscheiden.

** 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

Hier ist eine ältere dumpsys in Dalvik der Gmail App:

** 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

In der Regel sind nur die Spalten Pss Total und Private Dirty relevant. In einigen Fällen enthalten auch die Spalten Private Clean und Heap Alloc interessante Daten.

Im Folgenden finden Sie weitere Informationen zu den verschiedenen Arbeitsspeicherzuweisungen, die Sie beachten sollten:

Dalvik Heap
Der von Dalvik-Zuweisungen in Ihrer App verwendete RAM. Der Pss Total umfasst alle Zygote-Zuweisungen, gewichtet nach ihrer Freigabe für Prozesse, wie in der PSS-Definition beschrieben. Die Zahl Private Dirty ist der tatsächliche RAM, der nur dem Heap Ihrer App zugewiesen ist. Er besteht aus Ihren eigenen Zuweisungen und allen Zygote-Zuweisungsseiten, die seit der Forke des App-Prozesses von Zygote geändert wurden.

Hinweis:Bei neueren Plattformversionen mit dem Abschnitt Dalvik Other enthalten die Zahlen Pss Total und Private Dirty für den Dalvik-Heap keinen Dalvik-Overhead, z. B. die Just-in-Time-Kompilierung (JIT) und die GC-Buchhaltung. In älteren Versionen werden alle Werte unter Dalvik zusammengefasst.

Heap Alloc ist die Menge an Arbeitsspeicher, die die Dalvik- und nativen Heap-Allokatoren für Ihre App im Blick behalten. Dieser Wert ist größer als Pss Total und Private Dirty, da Ihr Prozess von Zygote geforkt wurde und Zuweisungen enthält, die Ihr Prozess mit allen anderen teilt.

.so mmap und .dex mmap
Der RAM, der für zugeordneten .so-Code (nativ) und .dex-Code (Dalvik oder ART) verwendet wird. Die Zahl Pss Total umfasst Plattformcode, der für alle Apps gemeinsam genutzt wird. Private Clean ist der Code Ihrer App. Im Allgemeinen ist die tatsächliche Größe größer. Der RAM enthält hier nur das, was derzeit im RAM für Code benötigt wird, der von der App ausgeführt wurde. Der .so mmap hat jedoch einen großen privaten Dirty-Cache, was auf Korrekturen am nativen Code zurückzuführen ist, als er in seine endgültige Adresse geladen wurde.
.oat mmap
Dies ist die vom Code-Image verwendete RAM-Kapazität. Sie basiert auf den vorab geladenen Klassen, die häufig von mehreren Apps verwendet werden. Dieses Bild wird für alle Apps verwendet und ist von bestimmten Apps nicht betroffen.
.art mmap
Dies ist die Menge an RAM, die vom Heap-Image verwendet wird. Sie basiert auf den vorab geladenen Klassen, die häufig von mehreren Apps verwendet werden. Dieses Bild wird für alle Apps freigegeben und ist von bestimmten Apps nicht betroffen. Auch wenn das ART-Image Object Instanzen enthält, wird es nicht auf die Heap-Größe angerechnet.
.Heap (nur mit dem Flag -d)
Dies ist die Menge an Heap-Speicher für Ihre App. Objekte im Image- und Large Object-Bereich sind hiervon ausgenommen, aber der Zygote-Bereich und der nicht bewegliche Bereich sind enthalten.
.LOS (nur mit dem Flag -d)
Dies ist die Menge an RAM, die vom ART-Large-Object-Space belegt wird. Dazu gehören auch große Zygote-Objekte. Große Objekte sind alle primitiven Arrayzuweisungen, die größer als 12 KB sind.
.GC (nur mit dem Flag -d)
Das sind die Overhead-Kosten für die Speicherbereinigung. Es gibt keine Möglichkeit, diesen Overhead zu reduzieren.
.JITCache (nur mit dem Flag -d)
Dies ist die Menge an Arbeitsspeicher, die von den JIT-Daten- und Code-Caches verwendet wird. Normalerweise ist dieser Wert null, da alle Apps bei der Installation kompiliert werden.
.Zygote (nur mit dem Flag -d)
Dies ist die Menge an Arbeitsspeicher, die vom Zygote-Bereich belegt wird. Der Zygote-Speicherplatz wird beim Starten des Geräts erstellt und nie zugewiesen.
.NonMoving (nur mit dem Flag -d)
Das ist die Menge an RAM, die vom nicht verschiebbaren ART-Speicherplatz belegt wird. Der nicht bewegliche Bereich enthält spezielle nicht bewegliche Objekte wie Felder und Methoden. Sie können diesen Abschnitt verkürzen, indem Sie in Ihrer App weniger Felder und Methoden verwenden.
.IndirectRef (nur mit dem Flag -d)
Dies ist die Menge an RAM, die von den ART-Indirektreferenztabellen verwendet wird. Normalerweise ist dieser Wert gering. Ist er zu hoch, können Sie ihn möglicherweise durch Verringern der Anzahl der verwendeten lokalen und globalen JNI-Referenzen reduzieren.
Unknown
Alle RAM-Seiten, die vom System nicht in eine der anderen, spezifischeren Kategorien eingeordnet werden konnten. Derzeit sind das hauptsächlich native Zuordnungen, die vom Tool bei der Erhebung dieser Daten aufgrund der Address Space Layout Randomization (ASLR) nicht erkannt werden können. Wie beim Dalvik-Heap wird bei Pss Total für Unknown die gemeinsame Nutzung mit Zygote berücksichtigt. Private Dirty ist unbekannter RAM, der nur Ihrer App zugewiesen ist.
TOTAL
Die vom Prozess verwendete Gesamtgröße des Proportional Set Size (PSS)-RAM. Dies ist die Summe aller PSS-Felder darüber. Sie gibt das Arbeitsspeichergewicht Ihres Prozesses an, das direkt mit anderen Prozessen und dem gesamten verfügbaren RAM verglichen werden kann.

Private Dirty und Private Clean sind die Gesamtzuweisungen innerhalb Ihres Prozesses, die nicht mit anderen Prozessen geteilt werden. Wenn Ihr Prozess beendet wird, wird der gesamte RAM aus diesen Zuweisungen wieder an das System zurückgegeben. Private Clean kann auch vor dem Beenden des Prozesses ausgelagert und freigegeben werden, Private Dirty wird jedoch erst bei der Prozessbeendigung freigegeben.

Dirty RAM sind Seiten, die geändert wurden und daher im RAM verbleiben müssen, da kein Auslagerungsbereich vorhanden ist. Der freie Arbeitsspeicher besteht aus Seiten, die aus einer persistenten Datei zugeordnet wurden, z. B. aus Code, der gerade ausgeführt wird. Sie können ausgelagert werden, wenn sie eine Weile nicht verwendet werden.

ViewRootImpl
Die Anzahl der Stammansichten, die in Ihrem Prozess aktiv sind. Jede Stammansicht ist mit einem Fenster verknüpft. So können Sie Speicherlecks im Zusammenhang mit Dialogfeldern oder anderen Fenstern leichter erkennen.
AppContexts und Activities
Die Anzahl der Context- und Activity-Objekte der App, die sich derzeit in Ihrem Prozess befinden. So können Sie schnell Activity-Objekte erkennen, die aufgrund statischer Verweise nicht durch den Garbage Collector beseitigt werden können. Das ist häufig der Fall. Diese Objekte sind oft mit vielen anderen Zuweisungen verknüpft, was sie zu einer guten Möglichkeit macht, große Speicherlecks zu verfolgen.