איסוף נתוני ביצועים

שירות נייטיב של הטיימר המפקח (watchdog) רושם נתוני ביצועים של קלט/פלט (I/O) מאז תחילת התהליך או אתחול המערכת. השירות המותאם אישית מוחק את נתוני הביצועים שנאספו דוח איתור באגים. ספקים יכולים לשלוח שאילתות על השירות המקורי באמצעות dumpsys כדי להשליך את שנאספו, או להתחיל סשן של איסוף בהתאמה אישית לניפוי באגים.

תדירות איסוף הנתונים

התדירות של איסוף נתוני הביצועים משתנה בהתאם ל-build מהסוג הזה.

  • ב-builds של userdebug או של eng, Watchdog אוסף נתוני ביצועים פעם אחת בכל שנייה במהלך האתחול של המערכת ופעם אחת בכל דקה לאחר סיום האתחול.
  • בגרסת build של משתמשים, ה-Watchdog אוסף את נתוני הביצועים פעם אחת בכל 20 שניות במהלך אתחול המערכת ופעם אחת בכל שתי (2) דקות לאחר השלמת ההפעלה.

אירועי איסוף נתונים

פרופיילינג מבוסס דגימות מבוצע במהלך אירועי מערכת שונים (כגון אתחול מערכת, ובמהלך חלון N הדקות האחרונות.

  • אירועים מ-N הדקות האחרונות לפני יצירת דוח הבאג: נוצרים במהלך חלון נע של 30 דקות.
  • אירועים בזמן האתחול: נוצרים אחרי האתחול.
  • אירועים של החלפת משתמש: נוצרים אחרי שמתבצעת שינוי של משתמש.
  • אירועי איסוף בהתאמה אישית: אפשר לציין את תקופת הדגימה, את משך הזמן המקסימלי ולעשות סינון לפי חבילות.

העתקת נתוני הביצועים

כשמתבצע איסוף של דוח על באג, השירות המקורי של Watchdog מעביר את נתוני הביצועים שנאספו לדוח הבאג. ספקים יכולים לשלוח שאילתה לשירות המקורי באמצעות הפקודה הבאה של dumpsys כדי לבצע גרסת dump של נתוני הביצועים שנאספו. פרטים נוספים על הדוח מופיעים בקטע הסבר על דוח נתוני הביצועים.

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default > /tmp/carwatchdog_dump.txt

איסוף נתוני ביצועים לניפוי באגים

ספקים יכולים להשתמש בשירות המקורי של הטיימר המפקח (watchdog) כדי לאסוף נתוני ביצועים בהתאמה אישית למטרות ניפוי באגים. לדוגמה, כדי להבין את השימוש בקלט/פלט (I/O) אפליקציה או שירות, ספקים יכולים לבצע איסוף של נתוני ביצועים בהתאמה אישית שמתאר את השימוש בקלט/פלט (I/O) ברשימה ספציפית של חבילות או בכל המערכת.

התחלת סשן של איסוף בהתאמה אישית

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

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --start_perf [--interval <seconds>] [--max_duration <seconds>] [--filter_packages <package_name>,<package_name>,...]
  • --start_perf מתחיל סשן של איסוף נתוני ביצועים בהתאמה אישית.
  • --interval <seconds> מציין את מרווח הזמן לפרופיל. כברירת מחדל, המרווח הוא 30 שניות.
  • --max_duration <seconds> מציין את משך הזמן המקסימלי של סשן איסוף הנתונים של ביצועים מותאמים אישית. אם הסשן לא יופסק באופן ידני, הוא יופסק והנתונים שנאספו יימחקו בתום פרק הזמן הזה. כברירת מחדל, משך הזמן המקסימלי הוא 30 דקות.
  • --filter_packages <package_name>,<package_name>... מציינת רשימה של שמות חבילות שמופרדים בפסיקים לפרופיל. אם הם יסופקו, האיסוף של נתוני הביצועים יהיה מוגבל לחבילות האלה. אחרת, האיסוף של נתוני הביצועים מתבצע לכל החבילות במערכת.

לדוגמה, הפקודה הבאה מפעילה איסוף של נתוני ביצועים בהתאמה אישית עם מרווח פרופיילינג של 10 שניות, איסוף מקסימלי למשך שעה אחת, ומגביל את הפרופיילינג com.google.android.car.kitchensink והקבוצה חבילות com.google.android.apps.maps.

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --start_perf --interval 10 --max_duration 3600 --filter_packages com.google.android.car.kitchensink,com.google.android.apps.maps

עצירה של הפעלת איסוף מותאם אישית ושינוי שלו

אחרי תיעוד השימוש בקלט/פלט של אפליקציה או שירות שעניינים אתכם, הספקים צריכים להפסיק את סשן איסוף נתוני הביצועים בהתאמה אישית כדי למחוק את הנתונים שנאספו. הפקודה הזו מפסיקה את האיסוף של נתוני הביצועים בהתאמה אישית ומעבירה את הנתונים שנאספו לקובץ /tmp/carwatchdog_dump.txt:

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --stop-perf > /tmp/carwatchdog_custom_dump.txt

עזרה בנושא Dumpsys

כדי לקבל עזרה בנושא dumpsys:

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --help

הטמעה בפורמט proto

אפשר גם להפיק נתוני dumpsys בפורמט proto:

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --proto

הסבר על הדוח 'נתוני ביצועים'

מידע נוסף זמין בדוח לדוגמה של נתוני הביצועים:

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default

---------------------------------
WatchdogPerfService report:
---------------------------------
Boot-time collection information:
=================================
Event polling interval: 1 second

Wake-up collection information:
===============================
Event polling interval: 1 second

User-switch collection information:
===================================
Event polling interval: 1 second

Periodic collection information:
================================
Event polling interval: 60 seconds
---------------------------------------------------------------------------
Boot-time performance report:
=================================
No collection recorded
---------------------------------------------------------------------------
Wake-up performance report:
===========================
No collection recorded
---------------------------------------------------------------------------
User-switch events performance report:
======================================
No collection recorded
---------------------------------------------------------------------------
Last N minutes performance report:
======================================
Collection duration: 10800 seconds
Number of collections: 181

Collection 0: <Mon Oct  2 18:36:06 2023 GMT>
=============================================
Total CPU time (ms): 473210
Total CPU cycles: 39553152000
Total idle CPU time (ms)/percent: 435860 / 92.11%
CPU I/O wait time (ms)/percent: 0 / 0.00%
Number of context switches: 13723415093
Number of I/O blocked processes/percent: 0 / 0.00%

Top N CPU Times:
----------------
Android User ID, Package Name, CPU Time (ms), Percentage of total CPU time, CPU Cycles
    Command, CPU Time (ms), Percentage of UID's CPU Time, CPU Cycles
10, com.google.android.carassistant, 13357, 2.82%, 16409088000
    assistant:interactor, 13360, 100.02%, 16409088000
0, system, 9097, 1.92%, 9640512000
    sensors@1.0-ser, 3790, 41.66%, 3773184000
    system_server, 2760, 30.34%, 3135936000
    com.android.car, 1150, 12.64%, 1099584000
    binder:621_4, 1000, 10.99%, 1281024000
    surfaceflinger, 230, 2.53%, 245376000
0, audioserver, 4383, 0.93%, 4597248000
    Main, 2690, 61.37%, 2980416000
    binder:916_2, 950, 21.67%, 925056000
    audioserver, 720, 16.43%, 691776000
0, root, 4357, 0.92%, 3727872000
    irq/311-iam2068, 2630, 60.36%, 2471616000
    irq/26-90b6400., 370, 8.49%, 561024000
    kworker/u16:4-bwmon_wq, 290, 6.66%, 48960000
    kworker/u16:1-memlat_wq, 270, 6.20%, 0
    ipcdaemon, 220, 5.05%, 218304000
10, com.google.android.apps.geo.automotive.adas, 1509, 0.32%, 1756416000
    adas:publishing, 1490, 98.74%, 1735680000
    as:clientparams, 10, 0.66%, 20736000
0, com.android.vending, 796, 0.17%, 765504000
    android.vending, 790, 99.25%, 765504000
0, shared:com.google.uid.shared, 581, 0.12%, 481152000
    google.android.gms, 340, 58.52%, 237312000
    .gms.persistent, 190, 32.70%, 184512000
    process.gservices, 50, 8.61%, 59328000
0, gps, 507, 0.11%, 659136000
    binder:920_2, 500, 98.62%, 659136000
10, com.android.vending, 489, 0.10%, 372288000
    android.vending, 480, 98.16%, 372288000
0, shared:android.uid.systemui, 438, 0.09%, 449856000
    android.systemui, 440, 100.46%, 449856000

Top N Storage I/O Reads:
-------------
Android User ID, Package Name, Foreground Bytes, Foreground Bytes %, Foreground Fsync, Foreground Fsync %, Background Bytes, Background Bytes %, Background Fsync, Background Fsync %
0, root, 56123392, 81.95%, 1, 100.00%, 0, 0.00%, 0, 0.00%
0, system, 12333056, 18.01%, 0, 0.00%, 0, 0.00%, 0, 0.00%

Top N Storage I/O Writes:
-------------------------
Android User ID, Package Name, Foreground Bytes, Foreground Bytes %, Foreground Fsync, Foreground Fsync %, Background Bytes, Background Bytes %, Background Fsync, Background Fsync %
0, com.android.vending, 0, 0.00%, 0, 0.00%, 520192, 46.35%, 20, 47.62%
10, com.android.vending, 0, 0.00%, 0, 0.00%, 520192, 46.35%, 20, 47.62%
10, shared:com.google.uid.shared, 0, 0.00%, 0, 0.00%, 45056, 4.01%, 0, 0.00%
0, shared:com.google.uid.shared, 0, 0.00%, 0, 0.00%, 36864, 3.28%, 2, 4.76%
0, logd, 24576, 40.00%, 0, 0.00%, 0, 0.00%, 0, 0.00%
0, root, 20480, 33.33%, 0, 0.00%, 0, 0.00%, 0, 0.00%
0, system, 16384, 26.67%, 0, 0.00%, 0, 0.00%, 0, 0.00%

Top N I/O waiting UIDs:
-----------------------
Android User ID, Package Name, Number of owned tasks waiting for I/O, Percentage of owned tasks waiting for I/O
    Command, Number of I/O waiting tasks, Percentage of UID's tasks waiting for I/O
0, root, 2, 0.39%
    dp_hdcp2p2, 1, 50.00%
    hdcp_2x, 1, 50.00%

Top N major page faults:
------------------------
Android User ID, Package Name, Number of major page faults, Percentage of total major page faults
    Command, Number of major page faults, Percentage of UID's major page faults
0, com.android.vending, 104, 48.83%
    android.vending, 104, 100.00%
10, com.android.vending, 104, 48.83%
    android.vending, 104, 100.00%
0, shared:com.google.uid.shared, 4, 1.88%
    .gms.persistent, 4, 100.00%
10, shared:com.google.uid.shared, 1, 0.47%
    .gms.persistent, 1, 100.00%
Number of major page faults since last collection: 213
Percentage of change in major page faults since last collection: 0.00%

בזמן יצירת דוח על באג, הרצת פקודת dumpsys של Watchdog ללא ארגומנטים או עצירה סשן איסוף מותאם אישית, השירות המקורי של הטיימר המפקח (Watchdog) יוצר דוח נתוני ביצועים שדומה לזה את הדוח שלמעלה.

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

פריט תיאור
פרטי האיסוף בזמן האתחול מספקת מידע על סשן איסוף הנתונים של הביצועים בזמן האתחול.
מידע על האיסוף בזמן השכמה מספק מידע על סשן איסוף הנתונים של ביצועי המערכת ממצב שינה מתעורר מההשעיה.
פרטי האוסף 'העברת משתמשים' מספק מידע על הסשן של איסוף נתוני הביצועים במעבר בין משתמשים, הוא החלפת משתמש.
מידע על איסוף תקופתי מספקת מידע על הסשן התקופתי של איסוף נתוני הביצועים שמתחיל בפוסט להשלים את האתחול.
דוח ביצועים בזמן האתחול מכיל נתוני ביצועים שנאספו במהלך הפעלת המערכת. הנתונים האלה נשארים בזיכרון עד שהמערכת מושבתת, כך שהנתונים מופיעים בכל הדוחות.
דוח ביצועים של התעוררות מכיל נתוני ביצועים שנאספו במהלך ההפעלה. הנתונים האלה נשמרים בזיכרון עד כיבוי המערכת, כך שהנתונים יועברו לכל הדוחות.
דוח ביצועים של החלפת משתמשים מכיל נתוני ביצועים שנאספו במהלך החלפת משתמש. הנתונים האלה נשמרים בזיכרון עד כיבוי המערכת, כך שהנתונים יועברו לכל הדוחות.
דוח ביצועי הקלט/פלט של N הדקות האחרונות מכיל נתוני ביצועים שנאספו (לפי סשן האיסוף התקופתי) במהלך N דקות לפני הפקת הדוח.
משך האיסוף משך הזמן הכולל של איסוף נתוני הביצועים.
מספר הקולקציות המספר הכולל של האוספים שדווחו בדוח יחיד.

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

פריט תיאור
זמן המתנה/אחוז של קלט/פלט ב-CPU זמן מעבד מוחלט ואחוז מזמן המעבד הכולל שהוקצה למעבר הקשר או להמתנה עקב פעולות קלט/פלט מאז האיסוף האחרון.
זמן כולל של CPU זמן המעבד (CPU) הכולל באלפיות השנייה.
סה"כ זמן CPU לא פעיל זמן המעבד הכולל שבו המחשב היה במצב חוסר פעילות.
זמן ההמתנה של קלט/פלט במעבד (CPU) סך כל הזמן שהמעבד הוקדש בהמתנה לפעולות קלט/פלט (I/O).
מספר העברות ההקשר מספר המעברים של המעבד מתהליך או משרשור אחד לשני.
מספר תהליכים חסומים של קלט/פלט (I/O)/אחוז המספר הכולל של התהליכים שנחסמו בהמתנה לקלט/פלט ואחוז התהליכים החסומים בהמתנה לקלט/פלט (I/O) מאז האוסף האחרון.
Top N CPU Times

חבילות ה-N המובילות שצרכו הכי הרבה זמן מעבד מאז האיסוף האחרון:

  • כל שורה ברמה העליונה מכילה את מזהה המשתמש, שם החבילה, זמן המעבד, אחוז מזמן המעבד הכולל ומחזורי המעבד.
  • השורות ברמה הפנימית מכילות את הפקודה, זמן המעבד, אחוז זמן המעבד של UID ומחזורי המעבד.
קריאות קלט/פלט (I/O) מובילות של N Storage

החבילות המובילות מתוך N חבילות שקראו את הכי הרבה נתונים מהדיסק מאז האיסוף האחרון.

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

כתבי קלט/פלט (I/O) מובילים של N Storage החבילות המובילות (Top N) שכתבו את רוב הנתונים בדיסק מאז האיסוף האחרון. כל שורה מכילה שדומים לשדה של N ערכי הקריאה המובילים.
ה-N מזהי ה-UID המובילים בהמתנה ל-I/O

החבילות המובילות עם מספר משימות ההמתנה הגדול ביותר של קלט/פלט.

  • כל שורה ברמה העליונה מכילה את מזהה המשתמש, שמות החבילות, מספר אחוז המשימות שבבעלות החבילה שממתינות לקלט/פלט (I/O).
  • השורות ברמה הפנימית מכילות את פרטי ההמתנה של הקלט/פלט לתהליכים המובילים שבבעלות החבילה.
N הפגמים העיקריים בדפים N החבילות המובילות עם השגיאות הנפוצות ביותר בדפים מאז האוסף האחרון.