dumpsys

dumpsys to narzędzie, które działa na urządzeniach z Androidem i dostarcza informacji o usługach systemowych. Wywołaj dumpsys z poziomu wiersza poleceń przy użyciu Android Debug Bridge (ADB), aby uzyskać dane wyjściowe diagnostyczne dotyczące wszystkich usług systemowych działających na połączonym urządzeniu.

Dane wyjściowe są zwykle bardziej szczegółowe, niż chcesz, więc użyj opcji wiersza poleceń na tej stronie, aby uzyskać dane wyjściowe tylko dla określonych usług systemowych. Na tej stronie opisujemy też, jak używać dumpsys do wykonywania typowych zadań, takich jak sprawdzanie danych wejściowych, pamięci RAM, baterii i diagnostyka sieci.

Składnia

Ogólna składnia funkcji dumpsys wygląda tak:

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

Aby uzyskać dane diagnostyczne dotyczące wszystkich usług systemowych na połączonym urządzeniu, uruchom adb shell dumpsys. Dostarcza to jednak znacznie więcej informacji, niż potrzebujesz. Aby ułatwić zarządzanie danymi wyjściowymi, wskaż usługę, którą chcesz zbadać, uwzględniając ją w poleceniu. Na przykład podane niżej polecenie podaje dane systemowe dotyczące komponentów wejściowych, takich jak ekrany dotykowe czy klawiatury wbudowane:

adb shell dumpsys input

Aby wyświetlić pełną listę usług systemowych, których możesz używać z dumpsys, użyj tego polecenia:

adb shell dumpsys -l

Opcje wiersza poleceń

W tabeli poniżej znajdziesz listę opcji, które są dostępne, gdy używasz funkcji dumpsys:

Tabela 1. Lista dostępnych opcji dumpsys

adb shell dumpsys procstats -h
    

Sprawdź diagnostykę danych wejściowych

Określenie usługi input, jak pokazano w poleceniu poniżej, zapisuje stan urządzeń wejściowych systemu, takich jak klawiatury i ekrany dotykowe, oraz przetwarzanie zdarzeń wejściowych.

adb shell dumpsys input

Dane wyjściowe różnią się w zależności od wersji Androida na połączonym urządzeniu. W sekcjach poniżej opisujemy, jakiego rodzaju informacje zwykle widzisz.

Stan centrum zdarzeń

Poniżej znajdziesz przykładowe informacje, które możesz zobaczyć podczas sprawdzania stanu centrum zdarzeń diagnostyki 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 wejściowego

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

Poniższy przykład przedstawia dane wyjściowe ekranu dotykowego. Zapisz 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 danych o stanie czytnika wejściowego znajdują się informacje o globalnych parametrach konfiguracji, takich jak odstęp między kliknięciami.

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

Wejściowy stan dyspozytora

InputDispatcher odpowiada za wysyłanie zdarzeń wejściowych do aplikacji. Jak widać na przykładzie poniżej, zrzut stanu zawiera informacje o klikniętym oknie, o stanie kolejki wejściowej, o tym, czy błąd ANR jest w toku, i o innych danych o zdarzeniach wejściowych:

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

Do sprawdzenia

Poniżej znajdziesz listę rzeczy, które należy wziąć pod uwagę podczas sprawdzania danych wyjściowych usługi input:

Stan centrum wydarzeń:

• Dostępne są wszystkie urządzenia wejściowe, których oczekujesz.
• Każde urządzenie wejściowe ma odpowiedni plik układu klawiszy, plik mapy znaków kluczowych i plik konfiguracji urządzenia wejściowego. Jeśli plików brakuje lub zawierają błędy składni, nie zostaną one wczytane.
• Każde urządzenie wejściowe jest poprawnie sklasyfikowane. Bity w polu Classes odpowiadają flagom w obiekcie EventHub.h, np. INPUT_DEVICE_CLASS_TOUCH_MT.
• BuiltInKeyboardId jest poprawny. Jeśli urządzenie nie ma wbudowanej klawiatury, identyfikatorem musi być -2. W przeciwnym razie powinien to być identyfikator wbudowanej klawiatury.
• Jeśli zauważysz, że BuiltInKeyboardId nie ma wartości -2, a powinien być, oznacza to, że brakuje pliku mapy znaków klawiszy dla klawiatury funkcji specjalnej. Urządzenia z klawiaturą specjalną powinny mieć pliki mapy znaków klawiszy zawierające tylko wiersz type SPECIAL_FUNCTION.

Stan odczytującego dane wejściowe:

• Dostępne są wszystkie oczekiwane urządzenia wejściowe.
• Każde urządzenie wejściowe jest prawidłowo skonfigurowane. Zwróć szczególną uwagę na poprawność ekranu dotykowego i osi joysticka.

Stan dyspozytora danych wejściowych:

• Wszystkie zdarzenia wejściowe są przetwarzane zgodnie z oczekiwaniami.
• Po dotknięciu ekranu dotykowego i jednoczesnym uruchomieniu aplikacji dumpsys linia TouchStates prawidłowo identyfikuje dotykane okno.

Testowanie wydajności interfejsu użytkownika

Określenie usługi gfxinfo udostępnia dane wyjściowe z informacjami o wydajności klatek animacji, które pojawiają się w fazie nagrywania. To polecenie używa polecenia gfxinfo do zbierania danych o wydajności interfejsu użytkownika dla określonej nazwy pakietu:

adb shell dumpsys gfxinfo package-name

Możesz też dodać opcję framestats, aby podawać jeszcze bardziej szczegółowe informacje o czasie wyświetlania klatek z ostatnich klatek. Dzięki temu możesz dokładniej znajdować i debugować problemy:

adb shell dumpsys gfxinfo package-name framestats

Więcej informacji o używaniu metod gfxinfo i framestats do integrowania pomiarów wydajności interfejsu z metodami testowania znajdziesz w artykule Jak pisać makroporównawcze.

Sprawdź diagnostykę sieci

Jeśli określisz usługę netstats, statystyki użytkowania sieci będą zbierane od momentu uruchomienia poprzedniego urządzenia. Aby uzyskać dodatkowe informacje, takie jak szczegółowe informacje o unikalnym identyfikatorze użytkownika (UID), użyj opcji detail w ten sposób:

adb shell dumpsys netstats detail

Dane wyjściowe różnią się w zależności od wersji Androida na połączonym urządzeniu. W sekcjach poniżej opisujemy, jakiego rodzaju informacje zwykle widzisz.

Aktywne interfejsy i aktywne interfejsy identyfikatora UID

Poniżej znajdziesz przykładowe dane wyjściowe z listą aktywnych interfejsów i aktywnych interfejsów UID na podłączonym urządzeniu. 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”

Poniżej znajdziesz przykładowe dane wyjściowe w sekcji statystyk deweloperskich:

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 dotyczące identyfikatora 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 swojej aplikacji, uruchom to polecenie: adb shell dumpsys package your-package-name. Następnie odszukaj wiersz userId.

Aby np. sprawdzić użycie sieci przez aplikację „com.example.moja_aplikacja”, uruchom to polecenie:

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

Dane wyjściowe powinny wyglądać mniej więcej tak:

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

Korzystając z poprzedniego przykładowego zrzutu, znajdź wiersze z wartością uid=10007. Istnieją 2 takie linie – pierwszy wskazuje połączenie komórkowe, a druga – połączenie Wi-Fi. Pod każdym wierszem widoczne są te informacje dotyczące każdego dwugodzinnego okna, które bucketDuration określa w milisekundach:

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

Sprawdź diagnostykę baterii

Określenie usługi batterystats powoduje generowanie danych statystycznych o wykorzystaniu baterii przez urządzenie, uporządkowanych według unikalnego identyfikatora użytkownika (UID). Aby dowiedzieć się, jak za pomocą dumpsys przetestować aplikację pod kątem funkcji uśpienia i czuwania, przeczytaj sekcję Testowanie w trybie uśpienia i czuwania aplikacji.

Polecenie batterystats jest następujące:

adb shell dumpsys batterystats options

Aby zobaczyć listę dodatkowych opcji dostępnych w przypadku batterystats, dodaj opcję -h. Ten przykład pokazuje statystyki wykorzystania baterii dla określonego pakietu aplikacji od ostatniego ładowania urządzenia:

adb shell dumpsys batterystats --charged package-name

Dane wyjściowe zazwyczaj zawierają te informacje:

• Historia zdarzeń związanych z baterią
• Globalne statystyki dotyczące urządzenia
• Przybliżone zużycie energii przez identyfikator UID i komponent systemu
• Liczba milisekund na pakiet w przypadku każdej aplikacji mobilnej
• Zbiorcze statystyki dotyczące identyfikatora UID systemu
• Zbiorcze statystyki dla identyfikatora UID aplikacji

Więcej informacji o korzystaniu z batterystats i generowaniu wizualizacji HTML wyników, która ułatwia zrozumienie i zdiagnozowanie problemów związanych z baterią, znajdziesz w artykule Profil wykorzystania baterii za pomocą narzędzi Batterystats i Historycznego baterii.

Sprawdź dane wyjściowe dostosowane do komputerów

Dane wyjściowe batterystats możesz wygenerować w czytelnym dla komputera formacie CSV, korzystając z tego polecenia:

adb shell dumpsys batterystats --checkin

Oto przykładowe dane wyjściowe:

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ą dotyczyć identyfikatora UID lub poziomu systemu. Wybrano dane do uwzględnienia na podstawie ich przydatności w analizie wydajności baterii. Każdy wiersz reprezentuje obserwację z tymi elementami:

• Zastępcza liczba całkowita
• Identyfikator użytkownika powiązany z obserwacją
• Tryb agregacji:
  • i.
  • l za --charged (wykorzystanie od ostatniego obciążenia).
  • u przez --unplugged (użycie od ostatniego odłączenia). Funkcja wycofana w Androidzie 5.1.1.
• Identyfikator sekcji, który określa sposób interpretowania kolejnych wartości w wierszu.

W tabeli poniżej opisujemy różne identyfikatory sekcji, które możesz zobaczyć:

Tabela 2. Lista identyfikatorów sekcji

Uwaga: przed Androidem 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 nowszych zużycie energii przez te komponenty są śledzone w sekcji pwi (zużycie energii) za pomocą osobnych etykiet (wifi, blue, cell) dla każdego komponentu.

Wyświetl przydziały pamięci

Wykorzystanie pamięci przez aplikację możesz sprawdzać na 2 sposoby: w wybranym okresie za pomocą funkcji procstats lub w konkretnym momencie przy użyciu meminfo. Z poniższych sekcji dowiesz się, jak korzystać z obu tych metod.

prokstaty

procstats pozwala sprawdzić, jak aplikacja zachowuje się w czasie, w tym jak długo działa w tle i ile pamięci w tym czasie wykorzystuje. Pomaga szybko wykrywać słabe i nieprawidłowe działania w aplikacji, takie jak wycieki pamięci, które mogą wpływać na jej wydajność, zwłaszcza w przypadku urządzeń z małą ilością pamięci. Zrzut stanu zawiera statystyki czasu działania każdej aplikacji, proporcjonalnego rozmiaru zestawu (PSS), unikalnego zestawu rozmiarów (USS) i określonego rozmiaru przez mieszkańców (RSS).

Aby uzyskać statystyki wykorzystania pamięci przez aplikacje z ostatnich 3 godzin w formacie zrozumiałym dla człowieka, uruchom to polecenie:

adb shell dumpsys procstats --hours 3

Jak pokazano w poniższym przykładzie, dane wyjściowe pokazują procent czasu działania aplikacji oraz wartości PSS, USS i RSS jako minPSS-avgPSS-maxPSS/minUSS-avgUSS-maxUSS/minRSS-avgRSS-maxRSS w liczbie 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

Za pomocą tego polecenia możesz zarejestrować zrzut przedstawiający, jak pamięć aplikacji jest podzielona między różne typy przydziału pamięci RAM:

adb shell dumpsys meminfo package_name|pid [-d]

Flaga -d wyświetla więcej informacji związanych z wykorzystaniem pamięci Dalvik i ART.

Dane wyjściowe zawierają wszystkie bieżące przydziały aplikacji (mierzone w kilobajtach).

Analizując te informacje, musisz znać te typy przydziałów:

Prywatna (czysta i brudna) pamięć RAM

Ta pamięć jest używana tylko przez Twój proces. Jest to duża ilość pamięci RAM, którą system może odzyskać po zniszczeniu procesu aplikacji. Najważniejszym elementem jest prywatna, brudna pamięć RAM, która jest najdroższa, ponieważ wykorzystuje ją tylko Twój proces i jej zawartość znajduje się tylko w pamięci RAM, więc nie można jej przechowywać na stronach, ponieważ Android nie umożliwia wymiany. Wszystkie przydziały Dalvik i natywnej sterty są prywatnymi brudnymi pamięciami RAM. Dalvik i alokacje natywne udostępniane procesowi Zygote korzystają ze wspólnej pamięci RAM.

Proporcjonalny rozmiar zestawu (PSS)

Jest to wskaźnik wykorzystania pamięci RAM aplikacji, który uwzględnia udostępnianie stron między procesami. Wszystkie strony pamięci RAM, które są unikalne dla Twojego procesu, bezpośrednio wpływają na wartość PSS, podczas gdy strony współużytkowane z innymi procesami są uwzględniane w wartości PSS tylko w ilościach udostępnianych. Na przykład strona współużytkowana przez 2 procesy odpowiada połowie jej rozmiaru w PSS każdego procesu.

Cechą pomiaru usług PSS jest to, że można je zsumować ze wszystkich procesów, aby określić rzeczywistą pamięć używaną przez wszystkie procesy. Oznacza to, że PSS jest dobrym miernikiem rzeczywistej wagi pamięci RAM procesu i porównania z wykorzystaniem pamięci RAM przez inne procesy oraz łączną ilością dostępnej pamięci RAM.

Na przykład tak wygląda dane wyjściowe procesu Mapa na Nexusie 5:

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

Uwaga: wyświetlane informacje mogą nieco odbiegać od podanych 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 starszy dumpsys w Dalvik w aplikacji Gmail:

** MEMINFO in pid 9953 [com.google.android.gm] **
                 Pss     Pss  Shared Private  Shared Private    Heap    Heap    Heap
               Total   Clean   Dirty   Dirty   Clean   Clean    Size   Alloc    Free
              ------  ------  ------  ------  ------  ------  ------  ------  ------
  Native Heap      0       0       0       0       0       0    7800    7637(6)  126
  Dalvik Heap   5110(3)    0    4136    4988(3)    0       0    9168    8958(6)  210
 Dalvik Other   2850       0    2684    2772       0       0
        Stack     36       0       8      36       0       0
       Cursor    136       0       0     136       0       0
       Ashmem     12       0      28       0       0       0
    Other dev    380       0      24     376       0       4
     .so mmap   5443(5) 1996    2584    2664(5) 5788    1996(5)
    .apk mmap    235      32       0       0    1252      32
    .ttf mmap     36      12       0       0      88      12
    .dex mmap   3019(5) 2148       0       0    8936    2148(5)
   Other mmap    107       0       8       8     324      68
      Unknown   6994(4)    0     252    6992(4)    0       0
        TOTAL  24358(1) 4188    9724   17972(2)16388    4260(2)16968   16595     336

 Objects
               Views:    426         ViewRootImpl:        3(8)
         AppContexts:      6(7)        Activities:        2(7)
              Assets:      2        AssetManagers:        2
       Local Binders:     64        Proxy Binders:       34
    Death Recipients:      0
     OpenSSL Sockets:      1

 SQL
         MEMORY_USED:   1739
  PAGECACHE_OVERFLOW:   1164          MALLOC_SIZE:       62

Ogólnie zwracaj uwagę tylko na kolumny Pss Total i Private Dirty. W niektórych przypadkach kolumny Private Clean i Heap Alloc też zawierają interesujące dane.

Poniżej znajdziesz więcej informacji o różnych przydziałach pamięci, które warto obserwować:

Dalvik Heap

Pamięć RAM używana przez przydziały Dalvik w Twojej aplikacji. Pss Total obejmuje wszystkie przydziały Zygote ważone według ich udziału między procesami, zgodnie z definicją PSS. Liczba Private Dirty to rzeczywista ilość pamięci RAM przypisana tylko do sterty aplikacji składającej się z Twoich własnych przydziałów i stron alokacji Zygote, które zostały zmodyfikowane od czasu rozwidlenia procesu aplikacji z Zygote.

Uwaga: w nowszych wersjach platformy z sekcją Dalvik Other wartości Pss Total i Private Dirty dotyczące Dalvik Heap nie obejmują narzutu Dalvik, np. kompilacji „just-in-time (JIT) i księgowości GC, podczas gdy w starszych wersjach dane te są podawane łącznie w Dalvik.

Heap Alloc to ilość pamięci, którą Dalvik i rozkłady sterty natywnej monitorują na potrzeby Twojej aplikacji. Ta wartość jest większa niż Pss Total i Private Dirty, ponieważ Twój proces został rozwidlony z Zygote i obejmuje alokacje, które Twój proces współużytkuje z pozostałymi.

.so mmap i .dex mmap

Pamięć RAM używana przez zmapowany kod .so (natywna) i .dex (Dalvik lub ART). Liczba Pss Total obejmuje kod platformy udostępniany różnym aplikacjom. Private Clean to kod Twojej aplikacji. Rzeczywisty rozmiar mapowania jest większy. Pamięć RAM w tym miejscu to obecnie tylko pamięć RAM na potrzeby kodu wykonanego przez aplikację. .so mmap zawiera jednak duże zaległości prywatne, co wynika z poprawek w kodzie natywnym podczas jego wczytywania pod ostatecznym adresem.

.oat mmap

Jest to ilość pamięci RAM używana przez obraz kodu. Opiera się on na wstępnie wczytanych klasach, które są często używane przez wiele aplikacji. Obraz jest widoczny we wszystkich aplikacjach i nie ma na niego wpływu.

.art mmap

Jest to ilość pamięci RAM używana przez obraz stosu. Opiera się on na wstępnie wczytanych klasach, które są często używane przez wiele aplikacji. Obraz jest udostępniany we wszystkich aplikacjach i nie ma na niego wpływu. Mimo że obraz ART zawiera instancje Object, nie jest on wliczany do sterty.

.Heap (tylko z flagą -d)

Jest to ilość pamięci sterty aplikacji. Wyklucza to obiekty na obrazie i w dużych przestrzeniach obiektów, ale obejmuje przestrzeń Zygote i przestrzeń nieruchomą.

.LOS (tylko z flagą -d)

Jest to ilość pamięci RAM używana przez duże obiekty ART. Dotyczy to też dużych obiektów Zygote. Duże obiekty to przydziały tablicy podstawowej większe niż 12 KB.

.GC (tylko z flagą -d)

To koszty ogólne za czyszczenie pamięci. Nie ma sposobu na zredukowanie tego nakładu pracy.

.JITCache (tylko z flagą -d)

Jest to ilość pamięci używana przez pamięci podręczne JIT i kod. Zwykle wynosi zero, ponieważ wszystkie aplikacje są kompilowane w momencie instalacji.

.Zygote (tylko z flagą -d)

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

.NonMoving (tylko z flagą -d)

Jest to ilość pamięci RAM używana przez nieruchomą przestrzeń ART. Przestrzeń nieruchoma zawiera specjalne obiekty, których nie można przenieść, takie jak pola i metody. Możesz skrócić 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 odniesień pośrednich ART. Zwykle jest to niewielka kwota, ale jeśli jest zbyt wysoka, możesz ją zmniejszyć, zmniejszając liczbę używanych lokalnych i globalnych odwołań JNI.

Unknown

Wszystkie strony pamięci RAM, których system nie mógł sklasyfikować w 1 z pozostałych elementów. Obecnie obejmuje to głównie alokacje natywne, których narzędzie nie może zidentyfikować podczas zbierania tych danych z powodu randomizacji w układzie przestrzeni adresowej (ASLR). Podobnie jak w przypadku sterty Dalvik, Pss Total dla Unknown uwzględnia udostępnianie w Zygote, a Private Dirty to nieznana pamięć RAM i jest przeznaczona tylko dla Twojej aplikacji.

TOTAL

Łączny proporcjonalny rozmiar pamięci RAM (PSS) wykorzystywany przez proces. To jest suma wszystkich pól PSS znajdujących się nad nią. Wskazuje całkowitą wagę pamięci procesu, którą można porównać bezpośrednio z innymi procesami oraz łączną ilość dostępnej pamięci RAM.

Private Dirty i Private Clean to łączne przydziały w Twoim procesie, które nie są udostępniane innym procesom. Po zniszczeniu procesu cała pamięć RAM z tych przydziałów jest zwalniana z powrotem do systemu. Private Clean można też wydzielić i uwolnić przed zniszczeniem procesu, ale Private Dirty zostanie zwolniony tylko w momencie zniszczenia procesu.

Brudna pamięć RAM to strony, które zostały zmodyfikowane, więc muszą pozostać w pamięci RAM, ponieważ nie ma możliwości wymiany. „Z wolną pamięcią RAM” to strony, które zostały zmapowane z trwałego pliku, na przykład w trakcie wykonywania kodu, i mogą zostać wyczyszczone, jeśli nie są używane przez jakiś czas.

ViewRootImpl

Liczba wyświetleń głównych, które są aktywne w Twoim procesie. Każdy widok główny jest powiązany z oknem, co pomaga wykrywać wycieki pamięci w przypadku okien dialogowych lub innych okien.

AppContexts i Activities

Liczba obiektów Context i Activity aplikacji, które obecnie znajdują się w procesie. Może to pomóc w szybkim wykrywaniu wyciek obiektów Activity, których nie można zebrać do śmieci ze względu na statyczne odwołania (co jest częstą przyczyną). Obiekty te często są powiązane z wieloma innymi przydziałami, co sprawia, że są to dobry sposób na śledzenie dużych wycieków pamięci.