דאמפסי

dumpsys הוא כלי שפועל במכשירי Android ומספק מידע על שירותי המערכת. קריאה לפקודה dumpsys משורת הפקודה באמצעות Android Debug Bridge‏ (ADB) כדי לקבל פלט אבחון של כל שירותי המערכת שפועלים במכשיר מחובר.

בדרך כלל הפלט הזה מפורט יותר ממה שרוצים, לכן כדאי להשתמש באפשרויות שורת הפקודה שמפורטות בדף הזה כדי לקבל פלט רק של שירותי המערכת הרצויים. בדף הזה נסביר גם איך להשתמש ב-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, כפי שמוצג בפקודה הבאה, יגרום ליצירת גרסת dump של המצב של התקני הקלט של המערכת, כמו מקלדות ומסכים מגע, ושל עיבוד אירועי הקלט.

adb shell dumpsys input

הפלט משתנה בהתאם לגרסה של Android שפועלת במכשיר המחובר. בקטעים הבאים מתוארים סוגי המידע שמוצגים בדרך כלל.

המצב של Event Hub

לפניכם דוגמה למה שעשוי להופיע כשבודקים את מצב Event Hub של אבחון הקלט:

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 אחראי על פענוח אירועי קלט מהליבה. ב-dump הסטטוס מוצג מידע על הגדרת כל מכשיר קלט ועל שינויי הסטטוס האחרונים שהתרחשו, כמו הקשות על מקשים או נגיעות במסך המגע.

בדוגמה הבאה מוצג הפלט של מסך מגע. שימו לב למידע על הרזולוציה של המכשיר ועל פרמטרים של כיול שנעשה בהם שימוש.

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:

הסטטוס של Event Hub:

  • כל ציוד הקלט שציפיתם לו נמצא.

  • לכל מכשיר קלט יש קובץ מתאים של פריסת מפתחות, קובץ של מפת תווים של מפתחות וקובץ תצורה של מכשיר הקלט. אם הקבצים חסרים או מכילים שגיאות תחביר, הם לא נטענים.

  • כל מכשיר קלט מסווג בצורה נכונה. הביטים בשדה Classes תואמים לדגלים ב-EventHub.h, כמו INPUT_DEVICE_CLASS_TOUCH_MT.

  • הערך של BuiltInKeyboardId נכון. אם למכשיר אין מקלדת מובנית, המזהה צריך להיות -2. אחרת, זה צריך להיות המזהה של המקלדת המובנית.
    • אם אתם רואים שהתווית BuiltInKeyboardId היא לא -2, אבל היא אמורה להיות, סימן שחסר לכם קובץ של מפת תווים של מקש למקלדת עם פונקציות מיוחדות. במכשירים עם מקלדת פונקציות מיוחדת צריכים להיות קובצי מפות של תווים של מפתחות שמכילים רק את השורה type SPECIAL_FUNCTION.

מצב קורא הקלט:

  • כל מכשירי הקלט הצפויים נמצאים.
  • כל מכשיר הקלט מוגדר בצורה נכונה. במיוחד, בודקים שהציר של המסך המגע ושל מוט ההיגוי נכונים.

מצב של מפזר הקלט:

  • כל אירועי הקלט עוברים עיבוד כמצופה.
  • אחרי שמקישים על מסך המגע ומריצים את dumpsys בו-זמנית, השורה TouchStates מזהה בצורה נכונה את החלון שבו נוגעים.

בדיקת הביצועים של ממשק המשתמש

ציון השירות gfxinfo מאפשר לכלול בפלט מידע על הביצועים שקשור לפריימים של אנימציה שמתרחשים בשלב ההקלטה. הפקודה הבאה משתמשת ב-gfxinfo כדי לאסוף נתוני ביצועים של ממשק משתמש עבור שם חבילה ספציפי:

adb shell dumpsys gfxinfo package-name

אפשר גם לכלול את האפשרות framestats כדי לספק מידע מפורט יותר על תזמון המסגרות מהמסגרות האחרונות, וכך לעקוב אחרי בעיות ולפתור אותן בצורה מדויקת יותר:

adb shell dumpsys gfxinfo package-name framestats

מידע נוסף על השימוש ב-gfxinfo וב-framestats כדי לשלב מדידות של ביצועי ממשק המשתמש בשיטות הבדיקה מפורט במאמר כתיבת Macrobenchmark.

בדיקת ניתוח הרשת

ציון השירות netstats מספק נתונים סטטיסטיים של שימוש ברשת שנאספו מאז שהמכשיר הקודם הופעל. כדי להפיק מידע נוסף, כמו פרטים מפורטים של מזהה משתמש ייחודי (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 מציין את תג השקע שמשויך לתנועה.
  • rxBytes ו-rxPackets מייצגים את הבייטים והחבילות שהתקבלו במרווח הזמן המתאים.
  • txBytes ו-txPackets מייצגים בייטים שנשלחו (הועברו) וחבילות שנשלחו בפרק הזמן המתאים.

בדיקת אבחון הסוללה

ציון השירות batterystats יוצר נתונים סטטיסטיים על השימוש בסוללה במכשיר, שמאורגנים לפי מזהה משתמש ייחודי (UID). במאמר בדיקה באמצעות Doze ו-App Standby מוסבר איך משתמשים ב-dumpsys כדי לבדוק את האפליקציה לצורך התאמה ל-Doze ול-App Standby.

הפקודה של batterystats היא:

adb shell dumpsys batterystats options

כדי לראות רשימה של אפשרויות נוספות שזמינות ל-batterystats, צריך לכלול את האפשרות -h. בדוגמה הבאה מוצגת הפלט של נתונים סטטיסטיים לגבי השימוש בסוללה של חבילת אפליקציות מסוימת מאז הטעינה האחרונה של המכשיר:

adb shell dumpsys batterystats --charged package-name

בדרך כלל הפלט כולל את הפרטים הבאים:

  • היסטוריה של אירועים הקשורים לסוללה
  • נתונים סטטיסטיים גלובליים של המכשיר
  • צריכת החשמל המשוערת לכל מזהה משתמש (UID) ורכיב מערכת
  • אלפיות שנייה לכל חבילה בנייד לכל אפליקציה
  • נתונים סטטיסטיים מצטברים של UID המערכת
  • נתונים סטטיסטיים מצטברים של מזהה ייחודי (UID) של אפליקציה

במאמר יצירת פרופיל של השימוש בסוללה באמצעות Batterystats ו-Battery Historian מוסבר איך משתמשים ב-batterystats כדי ליצור תצוגה חזותית של הפלט ב-HTML, וכך להבין ולזהות בקלות בעיות שקשורות לסוללה.

בדיקת פלט שמתאים למכונות

אפשר ליצור פלט של batterystats בפורמט CSV קריא למחשבים באמצעות הפקודה הבאה:

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

התצפיות לגבי השימוש בסוללה יכולות להיות לפי מזהה משתמש או ברמת המערכת. הנתונים נבחרים להכללה על סמך התועלת שלהם בניתוח ביצועי הסוללה. כל שורה מייצגת תצפית, עם הרכיבים הבאים:

  • מספר שלם של placeholder
  • מזהה המשתמש שמשויך לתצפית
  • מצב הצבירה:
    • i למידע שלא קשור לסטטוס טעינה/לא טעינה.
    • l עבור --charged (שימוש מאז הטעינה האחרונה).
    • u עבור --unplugged (שימוש מאז הניתוק האחרון). הוצא משימוש ב-Android 5.1.1.
  • מזהה הקטע, שמגדיר איך לפרש את הערכים הבאים בשורה.

בטבלה הבאה מתוארים מזהים שונים של קטעים שעשויים להופיע:

טבלה 2. רשימת מזהים של קטעים

מזהה מדור תיאור שדות נוספים

vers

גרסה

checkin version, parcel version, start platform version, end platform version

uid

UID

uid, package name

apk

APK

wakeups, APK, service, start time, starts, launches

pr

תהליך

process, user, system, foreground, starts

sr

חיישן

sensor number, time count

vib

ויברטור

time, count

fg

חזית

time, count

st

זמן המדינה

foreground, active running

wl

חסימת מצב שינה

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

sy

סנכרון

sync, time count

jb

משרה

job, time count

kwl

Kernel Wake Lock

kernel wake lock, time count

wr

הסיבה להפעלה מחדש

wakeup reason, time count

nt

רשת

mobile bytes RX, mobile bytes TX, Wi-Fi bytes RX, Wi-Fi bytes TX, mobile packets RX, mobile packets TX, Wi-Fi packets RX, Wi-Fi packets TX, mobile active time, mobile active count

ua

פעילות משתמש

other, button touch

bt

סוללה

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

dc

פריקת סוללה

low, high, screen on, screen off

lv

רמת סוללה

start level, current level

wfl

Wi-Fi

full Wi-Fi lock on time, Wi-Fi scan time, Wi-Fi running time, Wi-Fi scan count, Wi-Fi idle time, Wi-Fi receive time, Wi-Fi transmit time

gwfl

Global Wi-Fi

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

gble

Global Bluetooth

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

m

שונות

screen on time, phone on time, full wakelock time total, partial wakelock time total, mobile radio active time, mobile radio active adjusted time, interactive time, power save mode enabled time, connectivity changes, device idle mode enabled time, device idle mode enabled count, device idling time, device idling count, mobile radio active count, mobile radio active unknown time

gn

רשת גלובלית

mobile RX total bytes, mobile TX total bytes, Wi-Fi RX total bytes, Wi-Fi TX total bytes, mobile RX total packets, mobile TX total packets, Wi-Fi RX total packets, Wi-Fi TX total packets

br

בהירות המסך

dark, dim, medium, light, bright

sst

זמן הסריקה של האות

signal scanning time

sgt

זמן עוצמת האות

none, poor, moderate, good, great

sgc

ספירת עוצמת האות

none, poor, moderate, good, great

dct

זמן חיבור הנתונים

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

dcc

מספר חבילת הגלישה

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

wst

זמן מצב ה-Wi-Fi

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

wsc

מספר המצבים של Wi-Fi

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

wsst/p>

זמן המצב של Wi-Fi Supplicant

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

wssc

Wi-Fi Supplicant State Count

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

wsgt

זמן עוצמת האות של Wi-Fi

none, poor, moderate, good, great

wsgc

ספירת עוצמת האות של Wi-Fi

none, poor, moderate, good, great

bst

זמן מצב Bluetooth

inactive, low, med, high

bsc

ספירת המצבים של Bluetooth

inactive, low, med, high

pws

סיכום של צריכת החשמל

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

pwi

פריט של צריכת חשמל

label, mAh

dsd

שלב פריקה

duration, level, screen, power-save

csd

שלב החיוב

duration, level, screen, power-save

dtr

זמן טעינה שנותר

battery time remaining

ctr

זמן הטעינה שנותר

charge time remaining

הערה: לפני Android 6.0, המעקב אחר צריכת החשמל של רדיו Bluetooth, רדיו סלולרי ו-Wi-Fi היה בקטגוריה m (שונות). ב-Android מגרסה 6.0 ואילך, המעקב אחר צריכת החשמל של הרכיבים האלה מתבצע בקטע pwi (פריט של צריכת חשמל) עם תוויות נפרדות (wifi, ‏ blue, ‏ cell) לכל רכיב.

הצגת הקצאות זיכרון

אפשר לבדוק את השימוש בזיכרון של האפליקציה באחת משתי דרכים: לאורך תקופת זמן באמצעות procstats או בנקודת זמן מסוימת באמצעות meminfo. בקטעים הבאים מוסבר איך להשתמש בשתי השיטות.

procstats

procstats מאפשר לראות את התנהגות האפליקציה לאורך זמן, כולל משך הזמן שהיא פועלת ברקע וכמות הזיכרון שהיא משתמשת בו במהלך הזמן הזה. בעזרת הכלי הזה תוכלו למצוא במהירות חוסר יעילות והתנהגות לא תקינה באפליקציה, כמו דליפות זיכרון, שיכולות להשפיע על הביצועים שלה, במיוחד כשהיא פועלת במכשירים עם נפח זיכרון נמוך. ב-dump המצב מוצגים נתונים סטטיסטיים על זמן הריצה של כל אפליקציה, על גודל הקבוצה היחסית (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 [-d] package_name|pid

הדגל -d מדפיס מידע נוסף שקשור לשימוש בזיכרון של Dalvik ו-ART. הדגל -h מדפיס את כל הדגלים הנתמכים.

הפלט כולל את כל ההקצאות הנוכחיות של האפליקציה, שנמדדות בקילובייט.

כשבודקים את המידע הזה, חשוב להכיר את סוגי ההקצאה הבאים:

זיכרון RAM פרטי (נקי ומלוכלך)
זוהי זיכרון שמשמש רק את התהליך שלכם. זהו רוב נפח ה-RAM שהמערכת יכולה למחזר כשתהליך האפליקציה נהרס. בדרך כלל, החלק החשוב ביותר הוא זיכרון RAM פרטי מלוכלך, שהוא היקר ביותר כי רק התהליך שלכם משתמש בו, כי התוכן שלו קיים רק ב-RAM, ולכן אי אפשר להעביר אותו לאחסון כי ב-Android לא נעשה שימוש בהחלפה (swap). כל ההקצאות של Dalvik ושל אשכול מקומי הן זיכרון RAM פרטי ומלוכלך. הקצאות של Dalvik ושל קוד מקורי שאתם משתפים עם תהליך Zygote הן זיכרון RAM משותף ומלוכלך.
Proportional Set Size‏ (PSS)
מדד של השימוש של האפליקציה ב-RAM, שמביא בחשבון חלוקת דפים בין תהליכים. דפי RAM ייחודיים לתהליך תורמים ישירות לערך ה-PSS שלו, בעוד שדפים שמשותפים עם תהליכים אחרים תורמים לערך ה-PSS רק בהתאם לכמות השיתוף. לדוגמה, דף שמשותף בין שני תהליכים תורם מחצית מהגודל שלו ל-PSS של כל תהליך.

מאפיין של מדידת ה-PSS הוא שאפשר להוסיף את ה-PSS של כל התהליכים כדי לקבוע את נפח הזיכרון בפועל שבו משתמשים כל התהליכים. כלומר, PSS הוא מדד טוב למעמס ה-RAM בפועל של תהליך, ולצורך השוואה לשימוש ב-RAM של תהליכים אחרים ולזיכרון ה-RAM הכולל שזמין.

לדוגמה, זהו הפלט של התהליך של Map במכשיר Nexus 5:

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

הערה: יכול להיות שהמידע שיוצג לכם יהיה שונה במקצת מהמידע שמוצג כאן, כי פרטים מסוימים של הפלט משתנים בין גרסאות הפלטפורמה.

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

זוהי גרסה ישנה יותר של dumpsys ב-Dalvik של אפליקציית 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

באופן כללי, צריך להתמקד רק בעמודות Pss Total ו-Private Dirty. במקרים מסוימים, העמודות Private Clean ו-Heap Alloc מספקות גם נתונים מעניינים.

בהמשך מפורט מידע נוסף על הקצאות הזיכרון השונות שצריך לשים לב אליהן:

Dalvik Heap
ה-RAM שמשמש להקצאות של Dalvik באפליקציה. הערך של Pss Total כולל את כל ההקצאות של Zygote, שמוערכות לפי השיתוף שלהן בין התהליכים, כפי שמתואר בהגדרה של PSS. המספר Private Dirty הוא נפח ה-RAM בפועל שהוקצה רק ל-heap של האפליקציה, והוא מורכב מהקצאות שלכם ודפי הקצאה של Zygote שהשתנו מאז היצירה של תהליך האפליקציה מ-Zygote.

הערה: בגרסאות פלטפורמה חדשות יותר עם הקטע Dalvik Other, המספרים Pss Total ו-Private Dirty של Dalvik Heap לא כוללים את התקורה של Dalvik, כמו הידור בזמן אמת (JIT) ורישום בחשבון של GC, בעוד שבגרסאות ישנות יותר כל הנתונים האלה מפורטים בשילוב בקטע Dalvik.

הערך Heap Alloc הוא נפח הזיכרון שמערכת הקצאת הזיכרון של Dalvik ושל הערימה המקומית עוקבת אחריו עבור האפליקציה. הערך הזה גדול יותר מ-Pss Total ומ-Private Dirty כי התהליך הופרד מ-Zygote וכולל הקצאות שהתהליך משתף עם כל שאר התהליכים.

.so mmap וגם .dex mmap
ה-RAM שמשמש לקוד .so (מקורי) ו-.dex (Dalvik או ART) ממופה. המספר Pss Total כולל קוד פלטפורמה ששותף בין אפליקציות. Private Clean הוא הקוד של האפליקציה שלכם. בדרך כלל, הגודל הממופה בפועל גדול יותר. כאן, ה-RAM הוא רק מה שצריך להיות כרגע ב-RAM עבור הקוד שהאפליקציה הפעילה. עם זאת, ל-.so mmap יש נפח גדול של נתונים פרטיים לא נקיים, שנובעים מתיקונים בקוד המקורי כשהוא נטען לכתובת הסופית שלו.
.oat mmap
זהו נפח ה-RAM שבו משתמש קובץ האימג' של הקוד. הוא מבוסס על הכיתות שהועלו מראש, שבהן משתמשות בדרך כלל כמה אפליקציות. התמונה הזו משותפת לכל האפליקציות, והיא לא מושפעת מאפליקציות מסוימות.
.art mmap
זהו נפח ה-RAM שבו נעשה שימוש בתמונה של אשכול. הוא מבוסס על הכיתות שהועלו מראש, שבהן משתמשות בדרך כלל כמה אפליקציות. התמונה הזו משותפת בין כל האפליקציות ולא מושפעת מאפליקציות מסוימות. למרות שתמונת ה-ART מכילה מכונות Object, היא לא נכללת בגודל האוסף.
.Heap (רק עם הדגל -d)
נפח הזיכרון ב-heap של האפליקציה. לא נכללים אובייקטים ב-image ובמרחבים של אובייקטים גדולים, אבל כן נכללים המרחב של Zygote והמרחב הלא נע.
.LOS (רק עם הדגל -d)
זו כמות ה-RAM שבה נעשה שימוש במרחב של אובייקטים גדולים ב-ART. כולל אובייקטים גדולים של Zygote. אובייקטים גדולים הם כל הקצאות מערכי פריטים פרימיטיביים שגדולים מ-12KB.
.GC (רק עם הדגל -d)
זוהי עלות העלויות הנלוות של איסוף האשפה. אין דרך לצמצם את העלויות האלה.
.JITCache (רק עם הדגל -d)
זהו נפח הזיכרון שמשמש את המטמון של הנתונים והקוד של JIT. בדרך כלל הערך הזה הוא אפס, כי כל האפליקציות מקובצות בזמן ההתקנה.
.Zygote (רק עם הדגל -d)
זהו נפח הזיכרון שבו נעשה שימוש במרחב Zygote. המרחב של Zygote נוצר במהלך הפעלת המכשיר ואף פעם לא מוקצה.
.NonMoving (רק עם הדגל -d)
נפח ה-RAM שמשמש את האזור הלא נע של ART. המרחב הלא נע מכיל אובייקטים מיוחדים שלא ניתן להעביר, כמו שדות ושיטות. כדי לצמצם את הקטע הזה, אפשר להשתמש בפחות שדות ושיטות באפליקציה.
.IndirectRef (רק עם הדגל -d)
זוהי כמות ה-RAM שבה נעשה שימוש בטבלאות ההפניה העקיפות של ART. בדרך כלל הסכום הזה קטן, אבל אם הוא גבוה מדי, יכול להיות שתוכלו לצמצם אותו על ידי צמצום מספר ההפניות המקומיות והגלובליות ל-JNI שבהן אתם משתמשים.
Unknown
כל דפי ה-RAM שהמערכת לא הצליחה לסווג לאחד מהפריטים הספציפיים יותר האחרים. בשלב זה, הנתונים האלה מכילים בעיקר הקצאות מקומיות, שהכלי לא יכול לזהות בזמן איסוף הנתונים בגלל רנדומיזציה של פריסת מרחב הכתובות (ASLR). בדומה לאוסף של Dalvik, הערך של Pss Total עבור Unknown מתייחס לשיתוף עם Zygote, ו-Private Dirty הוא זיכרון RAM לא ידוע שמיועד רק לאפליקציה שלכם.
TOTAL
נפח ה-RAM הכולל של Proportional Set Size‏ (PSS) שבו השתמש התהליך. זהו הסכום של כל שדות ה-PSS שמעליו. הוא מציין את משקל הזיכרון הכולל של התהליך, שניתן להשוות אותו ישירות לתהליכים אחרים ולסך כל הזיכרון הזמין ב-RAM.

Private Dirty ו-Private Clean הם ההקצאות הכוללות בתהליך, שלא משותפות עם תהליכים אחרים. כשהתהליך נהרס, כל ה-RAM מהקצאות האלה מוחזר למערכת. אפשר גם להוציא את Private Clean מהדף ולשחרר אותו לפני שהתהליך נהרס, אבל Private Dirty משוחרר רק כשהתהליך נהרס.

זיכרון RAM מלוכלך הוא דפים שעברו שינוי, ולכן הם חייבים להישאר ב-RAM כי אין החלפה. זיכרון RAM נקי הוא דפים שהותאמו מקובץ מתמיד, כמו קוד שפועל, ואפשר להוציא אותם מהזיכרון אם לא משתמשים בהם במשך זמן מה.

ViewRootImpl
מספר תצוגות השורש הפעילות בתהליך. כל תצוגת root משויכת לחלון, כך שאפשר להשתמש בה כדי לזהות דליפות זיכרון שכוללות חלונות דו-שיח או חלונות אחרים.
AppContexts וגם Activities
מספר האובייקטים מסוג Context ו-Activity של האפליקציה שנמצאים כרגע בתהליך. כך תוכלו לזהות במהירות אובייקטים של Activity שדלפו ולא ניתן לאסוף אותם בגלל הפניות סטטיות, מצב נפוץ. לרוב, לאובייקטים האלה משויכות הקצאות רבות אחרות, ולכן הם דרך טובה למעקב אחרי דליפות זיכרון גדולות.