dumpsys

dumpsys 是一項執行於 Android 裝置上的工具,可提供系統服務的相關資訊。利用 Android Debug Bridge (ADB) 透過指令列呼叫 dumpsys,取得在連線裝置上執行的所有系統服務的診斷輸出內容。

產生的輸出內容通常比您預期的還要詳細,因此請使用本頁中的指令列選項,只取出您所需的系統服務輸出內容。本頁也會說明如何使用 dumpsys 完成常見的工作,例如檢查輸入、RAM、電池或網路診斷。

語法

使用 dumpsys 的一般語法如下:

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

如要針對連線裝置的所有系統服務取得診斷輸出,只要執行 adb shell dumpsys 即可。然而,產生的結果會比您預期的還多。如要讓輸出的結果易於管理,請在指令中指明想要檢查的服務。舉例來說,以下的指令會提供輸入元件 (例如觸控螢幕或內建鍵盤) 的系統資料:

adb shell dumpsys input

如需可利用 dumpsys 取得的系統服務完整清單,請使用下列指令:

adb shell dumpsys -l

指令列選項

下表列出使用 dumpsys 時的可用選項:

表 1. dumpsys 的可用選項清單

選項 說明
-t timeout 指定逾時期間(以秒為單位)。如未指定,預設值為 10 秒。
--help 輸出 dumpsys 工具的說明文字。
-l 輸出可搭配 dumpsys 使用的完整系統服務清單。
--skip services 指定您不想包含在輸出內容中的 services
service [arguments] 指定您想要輸出的 service。有些服務可讓您傳遞選擇性的 arguments。如要瞭解這些選用引數,請傳送 -h 選項給服務:
adb shell dumpsys procstats -h
    
-c 指定特定服務時,請附加這個選項以輸出適合機器的格式資料。
-h 附加特定服務的選項,即可查看相關說明文字和該服務的其他選項。

檢查輸入診斷資料

如下方指令所示,指定 input 服務會傾印系統輸入裝置的狀態,例如鍵盤和觸控螢幕,以及輸入事件的處理。

adb shell dumpsys input

輸出結果會因連線裝置上執行的 Android 版本而有所不同。以下各節說明了您常會看到的資訊類型。

事件中心狀態

以下為檢查輸入診斷「事件狀態」時可能看到的示例:

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

輸入閱讀器狀態

InputReader 負責將核心解碼的輸入事件解碼。其狀態傾印會顯示每部輸入裝置的設定方式,以及近期發生的狀態變更,例如按下按鍵或輕觸觸控螢幕。

以下範例顯示觸控螢幕的輸出結果。記下裝置的解析度和使用的校正參數。

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

在輸入讀取器狀態傾印的最後,有一些有關全域設定參數的相關資訊,例如輕觸間隔:

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

輸入發送器狀態

InputDispatcher 負責將輸入事件傳送至應用程式。如下列範例輸出所示,其狀態傾印顯示了輕觸的視窗、輸入佇列的狀態、是否有正在進行的 ANR,以及其他輸入事件資訊:

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

檢查事項

檢查 input 服務的輸出內容時,建議留意以下幾點:

事件中心狀態:

  • 顯示了所有預期的輸入裝置。
  • 每項輸入裝置都有合適的鍵盤版面配置檔案、鍵盤字元對應檔案以及輸入裝置的設定檔。如果欠缺檔案或含有語法錯誤,系統就不會將其載入。
  • 每項輸入裝置皆已正確分類。Classes 檔案中的位元會對應到 EventHub.h 中的旗標,例如 INPUT_DEVICE_CLASS_TOUCH_MT
  • BuiltInKeyboardId 是正確的。如果裝置沒有內建鍵盤,則 ID 必須是 -2。否則,這個值應為內建鍵盤的 ID。
    • 若發現 BuiltInKeyboardId 應為 -2 卻不是 -2,那麼您遺漏了特殊功能鍵盤所需的的鍵盤文字對應檔。特殊功能鍵盤裝置應含有僅含有 type SPECIAL_FUNCTION 行的鍵盤文字對應檔。

輸入閱讀器狀態:

  • 顯示了所有預期的輸入裝置。
  • 每項輸入裝置設定皆正確無誤。請特別留意觸控螢幕和搖桿是否正確無誤。

輸入調度工具狀態:

  • 所有輸入事件都會如預期照常處理。
  • 同時輕觸觸控螢幕並執行 dumpsys 後,TouchStates 行可正確識別您正觸控的視窗。

測試 UI 效能

指定 gfxinfo 服務可產生提供與錄製階段中發生的動畫頁框相關的效能資訊。下列指令使用 gfxinfo 收集特定套件名稱的 UI 效能資料:

adb shell dumpsys gfxinfo package-name

您也可以加入 framestats 選項,從最近的頁框擷取更詳細的影格時間資訊,協助您更準確地追蹤問題並進行除錯:

adb shell dumpsys gfxinfo package-name framestats

想要進一步瞭解如何使用 gfxinfoframestats 將 UI 效能測量結果整合至測試的做法,請參閱編寫 Macrobenchmark

檢查網路診斷

指定 netstats 服務即可取得自上次啟動裝置後所收集到的網路使用統計資料。如要輸出其他資訊 (例如 詳細的不重複使用者 ID (UID) 資訊),請加入 detail 選項,如下 所示:

adb shell dumpsys netstats detail

輸出結果會因連線裝置上執行的 Android 版本而有所不同。以下各節說明了您常會看到的資訊類型。

使用中的介面和使用中的 UID 介面

下列範例輸出會列出已連線裝置的有效介面和有效的 UID 介面。在多數情況下,使用中的介面和使用中的 UID 介面都是相同的。

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

「Dev」和「Xt」統計資料

以下是開發人員統計資料部分的輸出範例:

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 統計資料

以下是每個 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

如要找出應用程式的 UID,請執行這項指令:adb shell dumpsys package your-package-name。然後找出標有 userId 的行。

舉例來說,如要找出應用程式的網路用量「com.example.myapp」,請執行下列指令:

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

輸出的內容會類似以下:

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

使用上述的傾印範例,找出含有 uid=10007 的行。有如此的兩行:第一行代表行動網路連線,第二行代表 Wi-Fi 連線。在每一行的下方,您可以看到每兩小時間隔 (bucketDuration 以毫秒為單位表示) 的資訊:

  • set=DEFAULT 表示前景網路用量,set=BACKGROUND 則表示背景用量。set=ALL 表示兩者。
  • tag=0x0 表示與流量相關聯的通訊端標記。
  • rxBytesrxPackets 代表對應時間間隔內接收的位元組數和收到的封包。
  • txBytestxPackets 代表在對應的時間間隔內傳送 (已傳送) 位元組和已傳送封包。

檢查電池診斷

指定 batterystats 服務後,系統會根據不重複使用者 ID (UID) 整理裝置電池用量的 相關統計資料。如要瞭解如何使用 dumpsys 測試應用程式的 Doze 和 App Standby,請參閱使用 Doze 和 App Standby 進行測試

batterystats 的指令如下:

adb shell dumpsys batterystats options

如要查看 batterystats 可用的其他選項,請加上 -h 選項。以下範例顯示自裝置上次充電後,指定的應用程式套件的電池用量統計資料:

adb shell dumpsys batterystats --charged package-name

輸出結果通常包含以下內容:

  • 電池相關事件記錄
  • 裝置的全域統計資料
  • 每個 UID 和系統元件的概略耗電量
  • 每個封包每個應用程式的行動毫秒數
  • 系統 UID 匯總統計資料
  • 應用程式 UID 匯總統計資料

如要進一步瞭解如何使用 batterystats 並產生 HTML 視覺呈現的輸出,方便您輕鬆瞭解及診斷電池相關問題,請參閱使用 Batterystats 和 Battery Historian 設定剖析電池用量

檢查易於機器使用的輸出

您可以使用下列指令,產生機器可讀取的 CSV 格式 batterystats 輸出:

adb shell dumpsys batterystats --checkin

以下為輸出範例:

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

電池用量的觀察結果可能是依照 UID 或系統層級。系統會根據資料在分析電池效能的實用程度下選擇納入的資料。每列代表一個觀察項目,其中包含下列元素:

  • 預留位置整數
  • 與觀察項目相關聯的使用者 ID
  • 加總模式:
    • i 與充電/未充電狀態不相關的資訊。
    • --chargedl (自上次充電後的使用情形)。
    • --unpluggedu (自上次拔除電源後至今的使用情形)。將在 Android 5.1.1 版中淘汰。
  • 區段 ID,用來判定如何解譯行中的後續值。

下表說明各種可能出現的區段 ID:

表 2. 區段 ID 清單

區塊 ID 說明 其餘欄位

vers

版本

checkin versionparcel versionstart platform versionend platform version

uid

UID

uidpackage name

apk

APK

wakeupsAPKservicestart timestartslaunches

pr

程序

processusersystemforegroundstarts

sr

感應器

sensor numbertimecount

vib

震動

timecount

fg

前景

timecount

st

狀態時間

foregroundactiverunning

wl

Wake Lock

wake lockfull timeffull countpartial timeppartial countwindow timewwindow count

sy

同步處理

synctimecount

jb

工作

jobtimecount

kwl

核心 Wake Lock

kernel wake locktimecount

wr

喚醒原因

wakeup reasontimecount

nt

網路

mobile bytes RXmobile bytes TXWi-Fi bytes RXWi-Fi bytes TXmobile packets RXmobile packets TXWi-Fi packets RXWi-Fi packets TXmobile active timemobile active count

ua

使用者活動

otherbuttontouch

bt

電池

start countbattery realtimebattery uptimetotal realtimetotal uptimestart clock timebattery screen off realtimebattery screen off uptime

dc

電池放電

lowhighscreen onscreen off

lv

電量

start levelcurrent level

wfl

Wi-Fi

full Wi-Fi lock on timeWi-Fi scan timeWi-Fi running timeWi-Fi scan countWi-Fi idle timeWi-Fi receive timeWi-Fi transmit time

gwfl

全域 Wi-Fi

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

gble

全域藍牙

BT idle timeBT receive timeBT transmit timeBT power (mAh)

m

其他

screen on timephone on timefull wakelock time totalpartial wakelock time totalmobile radio active timemobile radio active adjusted timeinteractive timepower save mode enabled timeconnectivity changesdevice idle mode enabled timedevice idle mode enabled countdevice idling timedevice idling countmobile radio active countmobile radio active unknown time

gn

全域網路

mobile RX total bytesmobile TX total bytesWi-Fi RX total bytesWi-Fi TX total bytesmobile RX total packetsmobile TX total packetsWi-Fi RX total packetsWi-Fi TX total packets

br

螢幕亮度

darkdimmediumlightbright

sst

訊號掃描時間

signal scanning time

sgt

訊號強度時間

nonepoormoderategoodgreat

sgc

訊號強度計數

nonepoormoderategoodgreat

dct

數據連線時間

noneGPRSEDGEUMTSCDMAEVDO_0EVDO_A1xRTTHSDPAHSUPAHSPAIDENEVDO_BLTEEHRPDHSPAP, other

dcc

數據連線數量

noneGPRSEDGEUMTSCDMAEVDO_0EVDO_A1xRTTHSDPAHSUPAHSPAIDENEVDO_BLTEEHRPDHSPAPother

wst

Wi-Fi 狀態時間

offoff scanningon no networkson disconnectedon connected STAon connected P2Pon connected STA P2Psoft AP

wsc

Wi-Fi 狀態數量

offoff scanningon no networkson disconnectedon connected STAon connected P2Pon connected STA P2Psoft AP

wsst/p>

Wi-Fi 要求狀態時間

invaliddisconnectedinterface disabledinactivescanningauthenticatingassociatingassociatedfour-way handshakegroup handshakecompleteddormantuninitialized

wssc

Wi-Fi 要求狀態計數

invaliddisconnectedinterface disabledinactivescanningauthenticatingassociatingassociatedfour-way handshakegroup handshakecompleteddormantuninitialized

wsgt

Wi-Fi 訊號強度時間

nonepoormoderategoodgreat

wsgc

Wi-Fi 訊號強度計數

nonepoormoderategoodgreat

bst

藍牙狀態時間

inactivelowmedhigh

bsc

藍牙狀態數量

inactivelowmedhigh

pws

用電量摘要

battery capacitycomputed powerminimum drained powermaximum drained power

pwi

電力使用項目

labelmAh

dsd

放電步驟

durationlevelscreenpower-save

csd

充電步驟

durationlevelscreenpower-save

dtr

剩餘放電時間

battery time remaining

ctr

剩餘充電時間

charge time remaining

注意:對於 Android 6.0 以下版本,藍牙無線電、行動網路無線電和 Wi-Fi 的電力使用情形是由m (Misc) 區段類別追蹤。在 Android 6.0 以上版本中,這些元件是由 pwi (電源使用項目) 部分,以每個元件的個別標籤 (wifibluecell) 來追蹤電量使用情形。

查看記憶體配置

您可以透過下列兩種方式檢查應用程式的記憶體用量:使用 procstats 檢查特定期間,或是使用 meminfo 檢查某個特定時間點。以下說明如何使用這兩種方法。

追蹤記錄

procstats 可讓您瞭解應用程式隨著時間的行為,包括應用程式在背景執行的時間長度,以及在該時間範圍內的記憶體用量。 這項工具可協助您快速找到應用程式中會影響應用程式效能的效率低落和不當行為 (例如記憶體流失),尤其是在低記憶體裝置上執行時。其狀態傾印內容會顯示每個應用程式的執行階段、比例集大小 (PSS)、不重複集大小 (USS) 和常設集大小 (RSS) 等統計資料。

如要取得過去三小時的應用程式記憶體用量統計資料,並且是採用人類可讀取的格式,請執行下列指令:

adb shell dumpsys procstats --hours 3

如以下範例所示,輸出結果會顯示應用程式執行的時間百分比,以及 PSS、USS 和 RSS 以 minPSS-avgPSS-maxPSS/minUSS-avgUSS-maxUSS/minRSS-avgRSS-maxRSS 顯示再除以樣本數。

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

您可以使用下列指令來記錄應用程式記憶體分割於不同 RAM 分配方式的快照:

adb shell dumpsys meminfo package_name|pid [-d]

-d 旗標會顯示關於 Dalvik 和 ART 記憶體用量的詳細資訊。

輸出結果會列出應用程式目前的所有配置情形 (以 KB 為單位)。

檢查這類資訊時,您需熟悉下列類型的分配方式:

私有(乾淨頁與臟頁)RAM
這項記憶體資料僅由您的程序所使用。這是系統在應用程式的程序銷毀時可以恢復的大量 RAM。一般來說,這個環節最重要的部分是 Private Dirty RAM。這是最昂貴的記憶體,因為它供您的程序使用,其內容只會儲存於 RAM 中,所以無法改指向至儲存空間 (因為 Android 不會使用替換功能)。您所做的 Dalvik 和原生堆積分配量為 私有的 Dirty RAM。與 Zygote 程序共用的 Dalvik 和原生分配則為共用的 Dirty RAM。
比例集大小 (PSS)
這是應用程式 RAM 用量的測量結果,會將在不同程序間共用的頁面納入考量。任何程序專用的 RAM 頁面都會直接計入 PSS 值,而與其他程序共用的頁面則只會根據共用量比例計入 PSS 值。舉例來說,兩個程序共用的頁面,會是將其一半大小計入每個程序的 PSS。

測量 PSS 的一大優點是,您可以將所有 PSS 相加,藉此查看所有程序使用的實際記憶體。這表示 PSS 是程序實際 RAM 權重的理想指標,同時可用來與其他程序的 RAM 用量及可用的 RAM 總量進行比較。

舉例來說,以下是 Google 地圖程序在 Nexus 5 裝置上的輸出內容:

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

注意:這裡顯示的資訊可能會與您看到的略有不同,因為部分輸出內容會因平台版本而有所不同。

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

以下是 Gmail 應用程式的 Dalvik 較舊的 dumpsys

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

一般來說,只需留意 Pss TotalPrivate Dirty 資料欄。在某些情況下,Private CleanHeap Alloc 資料欄也提供了有趣的資料。

以下提供了您應該觀察的不同記憶體配置的詳細資訊:

Dalvik Heap
應用程式中 Dalvik 配置使用的 RAM。Pss Total 包含所有 Zygote 配置 (如上面的 PSS 定義所述,依據其在不同程序間的共用情況計入權重)。Private Dirty 是實際上僅適用於應用程式堆積的 RAM,當中包含您自己的配置,以及從 Zygote 分出您的應用程式程序以來已修改的任何 Zygote 配置頁面。

注意:在含有 Dalvik Other 區段的新版平台上,Dalvik Heap 的 Pss TotalPrivate Dirty 數字並不包含 Dalvik 的負荷,例如 just-in-time 編譯 (JIT) 和 GC 記帳,較舊版本則將其組合起來,列在 Dalvik 下方。

Heap Alloc 是 Dalvik 和原生堆積分配器追蹤的應用程式記憶體量。這個值大於 Pss TotalPrivate Dirty,因為您的處理程序是 Zygote 的分支,其中含有您的程序與所有其他程序共用的配置。

.so mmap.dex mmap
用於對應 .so (原生) 和 .dex (Dalvik 或 ART) 程式碼的 RAM。Pss Total 數字包含各個應用程式共用的平台程式碼。Private Clean 是應用程式本身的程式碼。一般來說,實際的對應大小會比較大。這裡的 RAM 只是應用程式所執行的程式碼所需的 RAM。不過,.so mmap 有很大的 Private Dirty,是因為原生程式碼載入至最終地址時的修正。
.oat mmap
這是程式碼映像檔使用的 RAM 容量。它是依據來自多個應用程式常用的預先載入類別而定。這個映像檔會由所有應用程式共用,且不會受特定應用程式影響。
.art mmap
這是堆積映像檔使用的 RAM 用量。它是依據來自多個應用程式常用的預先載入類別而定。這個映像檔會由所有應用程式共用,且不會受特定應用程式影響。雖然 ART 映像檔包含 Object 執行個體,但不會計入堆積大小,
.Heap (僅限帶有 -d 旗標)
這是應用程式的應用程式堆積記憶體大小。不包括映像檔的物件和大型物件的空間,但包含 Zygote 的空間和非移動的空間。
.LOS (僅限帶有 -d 旗標)
這是 ART 大型物件空間使用的 RAM 容量。其中包括 Zygote 的大型物件。大型物件是指所有超過 12 KB 的原始陣列配置。
.GC (僅限帶有 -d 旗標)
這是垃圾收集的負荷成本。這是無法降低的負荷。
.JITCache (僅限帶有 -d 旗標)
這是 JIT 資料和程式碼快取使用的記憶體量。 由於所有的應用程式在安裝時都會編譯,因此通常為 0。
.Zygote (僅限帶有 -d 旗標)
這是 Zygotte 空間使用的記憶體用量。系統會在裝置啟動時建立 Zygote 空間,而且不會將其分配。
.NonMoving (僅限帶有 -d 旗標)
這是指 ART 非移動空間所使用的 RAM 容量。非移動空間含有特殊的非移動物件,例如欄位和方法。如要降低這部分,請在應用程式中使用較少的欄位和方法。
.IndirectRef (僅限帶有 -d 旗標)
此為 ART 間接參考表格使用的 RAM 用量。 通常這個用量很小,不過如果過高,可以減少本機和全域 JNI 參照的數量來降低數量。
Unknown
任何無法歸類到其他特定項目的 RAM 頁面。目前這部分主要包含原生配置,因為收集這項資料時的位址空間版面配置隨機化 (ASLR),工具無法辨識這些資訊。與 Dalvik 堆積一樣,UnknownPss Total 會考慮與 Zygote 共用的情況,而 Private Dirty 則表示僅用於您的應用程式的不明 RAM。.
TOTAL
程序使用的總比例集 (PSS) RAM 總數。這是其上所有 PSS 欄位的總和。這代表著處理程序的整體記憶體權重,可直接與其他程序和可用的 RAM 總量進行比較。

Private DirtyPrivate Clean 是程序中的總分配狀況,不會與其他程序共用。程序刪除後,這些配置中的所有 RAM 都會釋放回系統。在刪除程序之前,您也可以先清除並釋放 Private Clean,但 Private Dirty 只會在程序刪除時釋出。

Dirty RAM 是經過修改的頁面,因此必須留在 RAM 中,因為未發生替換。Clean RAM 是指對應到永久檔案 (例如執行中的程式碼) 的頁面,如果一段時間未使用,可能會將其清除。

ViewRootImpl
程序中正在使用的根資料檢視次數。每個根檢視表都與某個視窗相關聯,因此可協助您識別與對話方塊或其他視窗有關的記憶體流失。
AppContextsActivities
目前在程序中運作的應用程式 ContextActivity 物件數量。這可協助您快速識別外洩的 Activity 物件,這些物件因存在靜態參照而無法進行垃圾收集,這是很常見的情況。這些物件通常有許多與之關聯的其他配置,因此能有效追蹤大量的記憶體流失。