dumpsys

dumpsys to narzędzie działające na urządzeniach z Androidem, które dostarcza informacji o usługach systemowych. Wywołaj polecenie dumpsys z wiersza poleceń za pomocą Android Debug Bridge (ADB), aby uzyskać dane diagnostyczne wszystkich usług systemowych działających na podłączonym urządzeniu.

Ten wynik jest zwykle bardziej szczegółowy, niż chcesz, więc użyj opcji wiersza poleceń na tej stronie, aby uzyskać wynik tylko dla wybranych usług systemowych. Opisujemy tu też, jak za pomocą dumpsys wykonywać typowe zadania, takie jak sprawdzanie diagnostyki wejścia, pamięci RAM, baterii czy sieci.

Składnia

Ogólna składnia używania dumpsys jest taka:

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

Aby uzyskać dane diagnostyczne wszystkich usług systemowych na połączonym urządzeniu, uruchom adb shell dumpsys. Jednak w ten sposób uzyskasz znacznie więcej informacji, niż zwykle potrzebujesz. Aby uzyskać bardziej przejrzyste dane wyjściowe, określ usługę, którą chcesz sprawdzić, uwzględniając ją w poleceniu. Na przykład poniższe polecenie udostępnia dane systemowe dotyczące komponentów wejściowych, takich jak ekrany dotykowe lub wbudowane klawiatury:

adb shell dumpsys input

Pełną listę usług systemowych, których możesz używać z dumpsys, znajdziesz, wpisując to polecenie:

adb shell dumpsys -l

Opcje wiersza poleceń

Poniższa tabela zawiera listę opcji dostępnych podczas korzystania z dumpsys:

Tabela 1. Lista dostępnych opcji polecenia dumpsys

adb shell dumpsys procstats -h
    

Sprawdzanie diagnostyki danych wejściowych

Określenie usługi input, jak pokazano w poniższym poleceniu, powoduje zrzut stanu urządzeń wejściowych systemu, takich jak klawiatury i ekrany dotykowe, oraz przetwarzania zdarzeń wejściowych.

adb shell dumpsys input

Wynik zależy od wersji Androida na podłączonym urządzeniu. W sekcjach poniżej opisujemy typy informacji, które zwykle widzisz.

Stan centrum zdarzeń

Poniżej znajdziesz przykład tego, co możesz zobaczyć podczas sprawdzania stanu usługi Event Hub w diagnostyce danych wejściowych:

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

Stan czytnika danych wejściowych

InputReader odpowiada za dekodowanie zdarzeń wejściowych z jądra. Zrzut stanu zawiera informacje o konfiguracji każdego urządzenia wejściowego i ostatnich zmianach stanu, takich jak naciśnięcia klawiszy czy dotknięcia ekranu dotykowego.

Poniższy przykład pokazuje dane wyjściowe dla ekranu dotykowego. Zanotuj informacje o rozdzielczości urządzenia i użytych parametrach kalibracji.

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

Na końcu zrzutu stanu czytnika danych wejściowych znajdują się informacje o globalnych parametrach konfiguracji, takich jak interwał dotknięcia:

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

Stan dyspozytora danych wejściowych

InputDispatcher odpowiada za wysyłanie zdarzeń wprowadzania danych do aplikacji. Jak widać w przykładzie poniżej, zrzut stanu zawiera informacje o tym, które okno jest dotykane, o stanie kolejki wejściowej, o tym, czy trwa błąd ANR, oraz inne informacje o zdarzeniu wejściowym:

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

Co trzeba sprawdzić

Oto lista kwestii, które należy wziąć pod uwagę podczas sprawdzania danych wyjściowych usługi input:

Stan centrum wydarzeń:

• Wszystkie oczekiwane urządzenia wejściowe są obecne.
• Każde urządzenie wejściowe ma odpowiedni plik układu klawiszy, plik mapy znaków klawiszy i plik konfiguracji urządzenia wejściowego. Jeśli pliki nie istnieją lub zawierają błędy składni, nie zostaną wczytane.
• Każde urządzenie wejściowe jest prawidłowo sklasyfikowane. Bity w polu Classes odpowiadają flagom w polu EventHub.h, np. INPUT_DEVICE_CLASS_TOUCH_MT.
• Wartość BuiltInKeyboardId jest prawidłowa. Jeśli urządzenie nie ma wbudowanej klawiatury, identyfikator musi mieć wartość -2. W przeciwnym razie powinien to być identyfikator wbudowanej klawiatury.
• Jeśli zauważysz, że symbol BuiltInKeyboardId nie jest -2, a powinien być, oznacza to, że brakuje Ci pliku mapy znaków klawiatury specjalnej. Urządzenia z klawiaturą funkcji specjalnych powinny mieć pliki mapowania znaków klawiszy, które zawierają tylko wiersz type SPECIAL_FUNCTION.

Stan czytnika danych wejściowych:

• Wszystkie oczekiwane urządzenia wejściowe są obecne.
• Każde urządzenie wejściowe jest prawidłowo skonfigurowane. Sprawdź w szczególności, czy osie ekranu dotykowego i joysticka są prawidłowe.

Stan dyspozytora danych wejściowych:

• Wszystkie zdarzenia wejściowe są przetwarzane zgodnie z oczekiwaniami.
• Po dotknięciu ekranu dotykowego i jednoczesnym przesunięciu palcem po ekranie w kierunku dumpsys linia TouchStates prawidłowo identyfikuje okno, które dotykasz.

Testowanie wydajności interfejsu

Określenie gfxinfo usługi zapewnia dane wyjściowe z informacjami o wydajności dotyczącymi klatek animacji, które występują w fazie nagrywania. To polecenie używa narzędzia gfxinfo do zbierania danych o wydajności interfejsu w przypadku określonej nazwy pakietu:

adb shell dumpsys gfxinfo package-name

Możesz też uwzględnić opcję framestats, aby podać jeszcze bardziej szczegółowe informacje o czasie trwania ostatnich klatek. Dzięki temu możesz dokładniej śledzić i debugować problemy:

adb shell dumpsys gfxinfo package-name framestats

Więcej informacji o używaniu gfxinfo i framestats do integrowania pomiarów wydajności interfejsu z testami znajdziesz w artykule Pisanie testu Macrobenchmark.

Sprawdzanie diagnostyki sieci

Określenie usługi netstats zapewnia statystyki użytkowania sieci zebrane od czasu poprzedniego uruchomienia urządzenia. Aby uzyskać dodatkowe informacje, np. szczegółowe informacje o niepowtarzalnym identyfikatorze użytkownika (UID), uwzględnij opcję detail w ten sposób:

adb shell dumpsys netstats detail

Wynik zależy od wersji Androida na podłączonym urządzeniu. W sekcjach poniżej opisujemy typy informacji, które zwykle widzisz.

Aktywne interfejsy i aktywne interfejsy UID

Przykładowe dane wyjściowe poniżej zawierają listę aktywnych interfejsów i aktywnych interfejsów UID podłączonego urządzenia. W większości przypadków informacje o aktywnych interfejsach i aktywnych interfejsach UID są takie same.

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

Statystyki „Dev” i „Xt”

Oto przykładowe dane wyjściowe w sekcji Statystyki dewelopera:

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

Statystyki UID

Poniżej znajdziesz przykładowe szczegółowe statystyki dla każdego identyfikatora 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

Aby znaleźć identyfikator UID aplikacji, uruchom to polecenie: adb shell dumpsys package your-package-name. Następnie poszukaj wiersza oznaczonego symbolemuserId.

Aby na przykład sprawdzić wykorzystanie sieci przez aplikację „com.example.myapp”, uruchom to polecenie:

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

Dane wyjściowe powinny być podobne do tych:

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

Korzystając z powyższego przykładowego zrzutu, poszukaj wierszy zawierających znak uid=10007. Istnieją 2 takie linie – pierwsza wskazuje połączenie komórkowe, a druga – połączenie Wi-Fi. Pod każdym wierszem możesz zobaczyć te informacje dotyczące każdego dwugodzinnego przedziału czasu, które bucketDuration określa w milisekundach:

• set=DEFAULT oznacza wykorzystanie sieci na pierwszym planie, a set=BACKGROUND – wykorzystanie w tle. set=ALL oznacza oba te przypadki.
• tag=0x0 wskazuje tag gniazda powiązany z ruchem.
• rxBytes i rxPackets oznaczają odebrane bajty i odebrane pakiety w odpowiednim przedziale czasu.
• txBytes i txPackets reprezentują wysłane (przesłane) bajty i wysłane pakiety w odpowiednim przedziale czasu.

Sprawdzanie diagnostyki baterii

Określenie usługi batterystats generuje dane statystyczne dotyczące wykorzystania baterii na urządzeniu, uporządkowane według unikalnego identyfikatora użytkownika (UID). Aby dowiedzieć się, jak używać dumpsys do testowania aplikacji pod kątem funkcji Uśpienie i Czuwanie aplikacji, przeczytaj artykuł Testowanie z użyciem funkcji Uśpienie i Czuwanie aplikacji.

Polecenie dla batterystats jest następujące:

adb shell dumpsys batterystats options

Aby wyświetlić listę dodatkowych opcji dostępnych dla batterystats, dodaj opcję -h. Ten przykład wyświetla statystyki wykorzystania baterii przez określony pakiet aplikacji od ostatniego naładowania urządzenia:

adb shell dumpsys batterystats --charged package-name

Dane wyjściowe zwykle obejmują:

• Historia zdarzeń związanych z baterią
• Globalne statystyki urządzenia
• Przybliżone zużycie energii na identyfikator UID i komponent systemu
• Milisekundy na pakiet w przypadku poszczególnych aplikacji mobilnych
• Statystyki zbiorcze identyfikatorów UID systemu
• Statystyki zbiorcze identyfikatora UID aplikacji

Więcej informacji o korzystaniu z batterystats i generowaniu wizualizacji HTML danych wyjściowych, która ułatwia zrozumienie i diagnozowanie problemów związanych z baterią, znajdziesz w artykule Profilowanie wykorzystania baterii za pomocą narzędzi Batterystats i Battery Historian.

Sprawdzanie danych wyjściowych w formacie odpowiednim dla maszyn

Dane wyjściowe batterystats w czytelnym dla komputera formacie CSV możesz wygenerować za pomocą tego polecenia:

adb shell dumpsys batterystats --checkin

Oto przykład danych wyjściowych:

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

Obserwacje dotyczące wykorzystania baterii mogą być związane z identyfikatorem UID lub z poziomem systemu. Dane są wybierane do uwzględnienia na podstawie ich przydatności w analizowaniu wydajności baterii. Każdy wiersz reprezentuje obserwację i zawiera te elementy:

• zastępcza liczba całkowita,
• Identyfikator użytkownika powiązany z obserwacją
• Tryb agregacji:
  • i w przypadku informacji niezwiązanych ze stanem naładowania.
  • l w przypadku --charged (wykorzystanie od ostatniego naładowania).
  • u w przypadku --unplugged (użycie od ostatniego odłączenia). Wycofane w Androidzie 5.1.1.
• Identyfikator sekcji, który określa sposób interpretacji kolejnych wartości w wierszu.

W tabeli poniżej znajdziesz opis różnych identyfikatorów sekcji, które możesz zobaczyć:

Tabela 2. Lista identyfikatorów sekcji

Uwaga: przed wprowadzeniem Androida 6.0 zużycie energii przez radio Bluetooth, radio komórkowe i Wi-Fi było śledzone w kategorii m (Różne). W Androidzie 6.0 i nowszym zużycie energii przez te komponenty jest śledzone w sekcji pwi (Element zużycia energii) z osobnymi etykietami (wifi, blue, cell) dla każdego komponentu.

Wyświetlanie alokacji pamięci

Wykorzystanie pamięci przez aplikację możesz sprawdzić na 2 sposoby: w określonym czasie za pomocą procstats lub w konkretnym momencie za pomocą meminfo. W sekcjach poniżej znajdziesz instrukcje korzystania z obu tych metod.

procstats

procstats umożliwia sprawdzenie, jak aplikacja działa na przestrzeni czasu, w tym jak długo działa w tle i ile pamięci zużywa w tym czasie. Pomaga szybko wykrywać w aplikacji nieprawidłowości i nieefektywności, takie jak wycieki pamięci, które mogą wpływać na jej działanie, zwłaszcza na urządzeniach z małą ilością pamięci. Zrzut stanu zawiera statystyki dotyczące czasu działania każdej aplikacji, proporcjonalnego rozmiaru zbioru (PSS), unikalnego rozmiaru zbioru (USS) i rozmiaru zbioru rezydentnego (RSS).

Aby uzyskać statystyki wykorzystania pamięci aplikacji w ciągu ostatnich 3 godzin w formacie czytelnym dla człowieka, uruchom to polecenie:

adb shell dumpsys procstats --hours 3

Jak w przykładzie poniżej, dane wyjściowe pokazują, jaki procent czasu aplikacja była uruchomiona, oraz wartości PSS, USS i RSS jako minPSS-avgPSS-maxPSS/minUSS-avgUSS-maxUSS/minRSS-avgRSS-maxRSS w stosunku do liczby próbek.

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

Możesz zarejestrować migawkę tego, jak pamięć aplikacji jest dzielona między różne typy przydzielania pamięci RAM, za pomocą tego polecenia:

adb shell dumpsys meminfo [-d] package_name|pid

Flaga -d wyświetla więcej informacji związanych z wykorzystaniem pamięci przez Dalvik i ART. Flaga -h wyświetla wszystkie obsługiwane flagi.

Dane wyjściowe zawierają listę wszystkich bieżących przydziałów aplikacji, mierzonych w kilobajtach.

Sprawdzając te informacje, warto znać te rodzaje alokacji:

Prywatna pamięć RAM (czysta i zajęta)

Jest to pamięć używana tylko przez Twój proces. Jest to większość pamięci RAM, którą system może odzyskać po zakończeniu procesu aplikacji. Zwykle najważniejszą częścią jest prywatna zmodyfikowana pamięć RAM, która jest najdroższa, ponieważ jest używana tylko przez Twój proces, a jej zawartość znajduje się głównie w aktywnej pamięci RAM. Android unika tradycyjnych plików wymiany na dysku, ale używa zRAM (kompresji stron w pamięci) do wymiany zmodyfikowanych stron, a czasami zRAM Writeback do przechowywania nieużywanych stron w pamięci flash. Kompresja strony wymaga jednak cykli procesora, a zapisywanie w pamięci flash jest ściśle ograniczane, aby zapobiec zużyciu sprzętu, więc prywatna pamięć RAM ze zmodyfikowanymi danymi nie może zostać usunięta bez kosztów. Wszystkie alokacje sterty Dalvik i natywnej są prywatną zmodyfikowaną pamięcią RAM. Alokacje Dalvik i natywne, które udostępniasz procesowi Zygote, są udostępnianą pamięcią RAM zmodyfikowaną.

Proporcjonalny rozmiar zbioru (PSS)

Jest to pomiar wykorzystania pamięci RAM przez aplikację, który uwzględnia udostępnianie stron w różnych procesach. Wszystkie strony pamięci RAM, które są unikalne dla Twojego procesu, bezpośrednio wpływają na jego wartość PSS, natomiast strony współdzielone z innymi procesami wpływają na wartość PSS tylko proporcjonalnie do stopnia współdzielenia. Na przykład strona współdzielona przez 2 procesy wnosi do PSS każdego z nich połowę swojego rozmiaru.

Cechą pomiaru PSS jest to, że możesz zsumować wartości PSS wszystkich procesów, aby określić rzeczywistą ilość pamięci używanej przez wszystkie procesy. Oznacza to, że PSS jest dobrym wskaźnikiem rzeczywistej wagi pamięci RAM procesu i może służyć do porównywania wykorzystania pamięci RAM przez inne procesy oraz całkowitej dostępnej pamięci RAM.

Poniżej znajdziesz na przykład dane wyjściowe procesu Map na urządzeniu Nexus 5:

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

Uwaga: wyświetlane informacje mogą się nieco różnić od tych, które widzisz tutaj, ponieważ niektóre szczegóły danych wyjściowych różnią się w zależności od wersji platformy.

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

Oto starsza wersja dumpsys aplikacji Gmail na Dalvik:

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

Zasadniczo należy zwracać uwagę tylko na kolumny Pss Total i Private Dirty. W niektórych przypadkach ciekawe dane zawierają też kolumny Private Clean i Heap Alloc.

Poniżej znajdziesz więcej informacji o różnych alokacjach pamięci, które należy obserwować:

Dalvik Heap

Pamięć RAM używana przez przydziały Dalvik w aplikacji. Pss TotalObejmuje wszystkie przydziały Zygote ważone pod względem ich współdzielenia w procesach, zgodnie z opisem w definicji PSS. Liczba Private Dirty to rzeczywista pamięć RAM przypisana tylko do sterty aplikacji, która składa się z Twoich przydziałów i wszelkich stron przydziału Zygote zmodyfikowanych od czasu rozwidlenia procesu aplikacji z Zygote.

Uwaga: w nowszych wersjach platformy, które mają sekcję Dalvik Other, liczby Pss Total i Private Dirty dotyczące sterty Dalvik nie obejmują narzutu Dalvik, takiego jak kompilacja just-in-time (JIT) i księgowanie GC, podczas gdy starsze wersje podają wszystkie te dane łącznie w sekcji Dalvik.

Wartość Heap Alloc to ilość pamięci, którą śledzą alokatory sterty Dalvik i natywnej w przypadku Twojej aplikacji. Ta wartość jest większa niż Pss Total i Private Dirty, ponieważ Twój proces został rozwidlony z procesu Zygote i obejmuje przydziały, które Twój proces udostępnia wszystkim innym.

.so mmap i .dex mmap

Pamięć RAM używana do zmapowanego kodu .so (natywnego) i .dex (Dalvik lub ART). Liczba Pss Total obejmuje kod platformy udostępniany w różnych aplikacjach. Private Clean to kod aplikacji. Zwykle rzeczywisty rozmiar mapowany jest większy. Pamięć RAM w tym przypadku to tylko to, co obecnie musi znajdować się w pamięci RAM w przypadku kodu, który został wykonany przez aplikację. Jednak .so mmap ma dużą prywatną pamięć brudną, co wynika z poprawek w kodzie natywnym, gdy został on załadowany pod ostateczny adres.

.oat mmap

 Jest to ilość pamięci RAM używanej przez obraz kodu. Opiera się na wstępnie załadowanych klasach często używanych przez wiele aplikacji. Ten obraz jest udostępniany we wszystkich aplikacjach i nie zależy od konkretnych aplikacji.

.art mmap

Jest to ilość pamięci RAM wykorzystywanej przez obraz sterty. Opiera się na wstępnie załadowanych klasach często używanych przez wiele aplikacji. Ten obraz jest wspólny dla wszystkich aplikacji i nie zależy od konkretnych aplikacji. Mimo że obraz ART zawiera Object instancji, nie wlicza się on do rozmiaru sterty.

.Heap (tylko z flagą -d)

Jest to ilość pamięci sterty dla aplikacji. Nie obejmuje ona obiektów w przestrzeniach obrazu i dużych obiektów, ale obejmuje przestrzeń Zygote i przestrzeń nieprzenoszoną.

.LOS (tylko z flagą -d)

Jest to ilość pamięci RAM używanej przez obszar dużych obiektów ART. Obejmuje to duże obiekty Zygote. Duże obiekty to wszystkie alokacje tablicy typów prostych o rozmiarze większym niż 12 KB.

.GC (tylko z flagą -d)

Jest to koszt ogólny odśmiecania pamięci. Nie można zmniejszyć tych kosztów ogólnych.

.JITCache (tylko z flagą -d)

Jest to ilość pamięci używanej przez pamięć podręczną danych i kodu JIT. Zwykle jest to zero, ponieważ wszystkie aplikacje są kompilowane w momencie instalacji.

.Zygote (tylko z flagą -d)

 Jest to ilość pamięci wykorzystywanej przez przestrzeń Zygote. Przestrzeń Zygote jest tworzona podczas uruchamiania urządzenia i nigdy nie jest przydzielana.

.NonMoving (tylko z flagą -d)

Jest to ilość pamięci RAM używanej przez nieprzenoszoną przestrzeń ART. Przestrzeń nieprzenośna zawiera specjalne obiekty, których nie można przenieść, takie jak pola i metody. Możesz zmniejszyć tę sekcję, używając w aplikacji mniejszej liczby pól i metod.

.IndirectRef (tylko z flagą -d)

Jest to ilość pamięci RAM używana przez tabele odwołań pośrednich ART. Zwykle ta wartość jest niewielka, ale jeśli jest zbyt wysoka, możesz ją zmniejszyć, ograniczając liczbę używanych lokalnych i globalnych odwołań JNI.

Unknown

Wszystkie strony RAM, których system nie mógł zaklasyfikować do żadnego z pozostałych, bardziej szczegółowych elementów. Obecnie zawiera ona głównie alokacje natywne, których narzędzie nie może zidentyfikować podczas zbierania tych danych ze względu na losowe rozmieszczenie przestrzeni adresowej (ASLR). Podobnie jak w przypadku sterty Dalvik, Pss TotalUnknown uwzględnia udostępnianie z Zygote, a Private Dirty

to nieznana ilość pamięci RAM przeznaczona tylko dla Twojej aplikacji.

TOTAL

Łączna ilość pamięci RAM wykorzystywana przez proces w ramach proporcjonalnego rozmiaru zbioru (PSS). Jest to suma wszystkich pól PSS powyżej. Wskazuje ogólną wagę pamięci procesu, którą można bezpośrednio porównać z innymi procesami i całkowitą dostępną pamięcią RAM.

Private Dirty i Private Clean to łączne przydziały w Twoim procesie, które nie są udostępniane innym procesom. Gdy proces zostanie zniszczony, cała pamięć RAM z tych przydziałów zostanie zwolniona i wróci do systemu. Private Clean może też zostać wycofana z pamięci i zwolniona przed zakończeniem procesu, ale Private Dirty jest zwalniana dopiero po zakończeniu procesu.

Zanieczyszczona pamięć RAM to strony, które zostały zmodyfikowane i są przechowywane w aktywnej pamięci RAM, skompresowane w pamięci zRAM lub zapisane z powrotem w pamięci masowej. Czysta pamięć RAM to strony, które zostały zamapowane z trwałego pliku, np. wykonywanego kodu, i mogą zostać przeniesione do pamięci wirtualnej, jeśli nie są używane przez pewien czas.

ViewRootImpl

Liczba aktywnych widoków głównych w Twoim procesie. Każdy widok główny jest powiązany z oknem, co może pomóc w identyfikowaniu wycieków pamięci związanych z oknami dialogowymi lub innymi oknami.

AppContexts i Activities

Liczba obiektów aplikacji Context i Activity obecnie znajdujących się w Twoim procesie. Może to pomóc w szybkim identyfikowaniu wycieków Activity obiektów, których nie można usunąć z pamięci z powodu odwołań statycznych, co jest powszechne. Obiekty te często mają wiele innych powiązanych z nimi alokacji, co sprawia, że są dobrym sposobem na śledzenie dużych wycieków pamięci.