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:
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 inEventHub.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 Zeiletype 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 derTouchStates
-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
undrxPackets
stehen für empfangene Byte und empfangene Pakete im entsprechenden Zeitintervall. -
txBytes
undtxPackets
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:
Bereichs-ID | Beschreibung | Übrige Felder |
---|---|---|
|
Version |
|
|
UID |
|
|
APK |
|
|
Prozess |
|
|
Sensor |
|
|
Vibrator |
|
|
Vordergrund |
|
|
Zeitzone des Bundesstaats |
|
|
Wake lock |
|
|
Synchronisieren |
|
|
Job |
|
|
Kernel Wake Lock |
|
|
Grund für das Aufwachen |
|
|
Netz |
|
|
Nutzeraktivität |
|
|
Akku |
|
|
Akkuentladung |
|
|
Akkustand |
|
|
WLAN |
|
|
Global Wi-Fi |
|
|
Global Bluetooth |
|
|
Verschiedenes |
|
|
Global Network |
|
|
Bildschirmhelligkeit |
|
|
Signalsuchzeit |
|
|
Signalstärke – Zeit |
|
|
Anzahl der Signalstärken |
|
|
Zeit für die Datenverbindung |
|
|
Anzahl der Datenverbindungen |
|
|
Zeit des WLAN-Status |
|
|
WLAN-Status – Anzahl |
|
|
Zeit des WLAN-Supplicant-Status |
|
|
Anzahl der WLAN-Supplicant-Status |
|
|
Zeit der WLAN-Signalstärke |
|
|
Anzahl der WLAN-Signalstärken |
|
|
Bluetooth-Statuszeit |
|
|
Bluetooth-Status – Anzahl |
|
|
Zusammenfassung des Stromverbrauchs |
|
|
Element „Stromverbrauch“ |
|
|
Entladeschritt |
|
|
Ladeschritt |
|
|
Verbleibende Akkulaufzeit |
|
|
Verbleibende Ladezeit |
|
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 ZahlPrivate 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 ZahlenPss Total
undPrivate 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 unterDalvik
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 alsPss Total
undPrivate 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 ZahlPss 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ürUnknown
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
undPrivate 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
undActivities
- Die Anzahl der
Context
- undActivity
-Objekte der App, die sich derzeit in Ihrem Prozess befinden. So können Sie schnellActivity
-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.