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

שירות Watchdog מקליט נתוני ביצועים של קלט/פלט מאז early-init במהלך אתחול המערכת. השירות המקורי מציג את נתוני הביצועים שנאספו בדוח הבאגים. ספקים יכולים לשלוח שאילתות לשירות המקורי באמצעות dumpsys כדי להוציא את הנתונים שנאספו או להתחיל סשן איסוף מותאם אישית לצורך ניפוי באגים.

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

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

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

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

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

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

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

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

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

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

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

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

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

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 כדי ליצור קובץ dump של הנתונים בפורמט 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%

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

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

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

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

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

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

  • כל שורה ברמה העליונה מכילה את מזהה המשתמש, שם החבילה, זמן השימוש במעבד, אחוז זמן השימוש במעבד מתוך סה"כ זמן השימוש במעבד ומחזורי המעבד.
  • השורות ברמה הפנימית מכילות את הפקודה, זמן המעבד, אחוז זמן המעבד של ה-UID ומחזורי המעבד.
Top N Storage I/O Reads

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

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

Top N Storage I/O Writes ‫N החבילות המובילות שכתבו הכי הרבה נתונים לדיסק מאז האיסוף האחרון. כל שורה מכילה שדות דומים לאלה של 'הקריאות הכי נפוצות'.
מזהי UID של N המשתמשים המובילים בהמתנה לקלט/פלט

‫N החבילות המובילות עם הכי הרבה משימות בהמתנה לקלט/פלט.

  • כל שורה ברמה העליונה מכילה את מזהה המשתמש, שמות החבילות, המספר והאחוז של המשימות שבבעלות החבילה שממתינות לקלט/פלט.
  • השורות ברמה הפנימית מכילות את פרטי ההמתנה של קלט/פלט עבור התהליכים העליונים שבבעלות החבילה.
Top N major page faults ‫N החבילות המובילות עם מספר תקלות הדף הגדול ביותר מאז האוסף האחרון.