השירות המקורי של Watchdog מתעד נתוני ביצועים של קלט/פלט מאז שלב ה-init המוקדם במהלך אתחול המערכת. השירות המקורי מעביר את נתוני הביצועים שנאספו לדוח הבאג. ספקים יכולים לשלוח שאילתות על השירות המקורי באמצעות קובצי dumpsy כדי להעלות את הנתונים שנאספו או להתחיל סשן איסוף בהתאמה אישית לניפוי באגים.
תדירות איסוף הנתונים
תדירות האיסוף של נתוני הביצועים משתנה בהתאם לסוג ה-build.
- ב-builds של userdebug או של eng, Watchdog אוסף נתוני ביצועים פעם אחת בכל שנייה במהלך האתחול של המערכת ופעם אחת בכל דקה לאחר סיום האתחול.
- בגרסת build של משתמש, ה-Watchdog אוסף את נתוני הביצועים פעם אחת בכל 20 שניות במהלך האתחול של המערכת, ופעם אחת בכל שתי (2) דקות לאחר השלמת ההפעלה.
אירועי איסוף נתונים
יצירת הפרופיל על סמך דגימות מתבצעת במהלך אירועי מערכת שונים (כמו הפעלת המערכת, הפעלת המערכת מחדש והחלפת משתמש) ובמהלך חלון של N דקות אחרונות.
- אירועים מ-N הדקות האחרונות לפני יצירת דוח הבאג: נוצרים במהלך חלון נע של 30 דקות.
- אירועים מסוג 'זמן הפעלה': נוצרים אחרי ההפעלה.
- אירועי מעבר של משתמשים: נוצרים אחרי שמשתמש מבצע מעבר.
- אירועי איסוף בהתאמה אישית: אפשר לציין את תקופת הבדיקה, משך הזמן המקסימלי ואפשר לסנן לפי חבילות.
העתקת נתוני הביצועים
כשמתבצע איסוף של דוח על באג, השירות המקורי של Watchdog מעביר את נתוני הביצועים שנאספו לדוח הבאג. ספקים יכולים לשלוח שאילתה לשירות המקורי באמצעות הפקודה הבאה של dumpsys כדי לדגום את נתוני הביצועים שנאספו. פרטים על הדוח זמינים בסעיף הסבר על דוח נתוני הביצועים.
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
הפסקה ויצירת גרסת dump של סשן איסוף מותאם אישית
אחרי תיעוד השימוש בקלט/פלט של אפליקציה או שירות שעניינים אתכם, הספקים צריכים להפסיק את סשן איסוף נתוני הביצועים בהתאמה אישית כדי למחוק את הנתונים שנאספו. הפקודה הזו מפסיקה את האיסוף של נתוני הביצועים בהתאמה אישית ומעבירה את הנתונים שנאספו לקובץ /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 ללא ארגומנטים או עצירה של סשן איסוף מותאם אישית, שירות ה-Nativedog יוצר דוח נתוני ביצועים שדומה לדוח שלמעלה.
הדוח מכיל נתונים שנאספו במהלך הפעלת המערכת וב-N הדקות האחרונות לפני יצירת הדוח.
| פריט | תיאור |
|---|---|
| מידע על איסוף נתונים בזמן ההפעלה | מספק מידע על הסשן לאיסוף נתוני הביצועים בזמן האתחול. |
| מידע על איסוף הנתונים של התעוררות | מספק מידע על סשן האיסוף של נתוני הביצועים לאחר ההתעוררות, כשהמערכת מתעוררת ממצב השהיה. |
| מידע על איסוף נתונים של מתגים של משתמשים | המאפיין מספק מידע על סשן איסוף נתוני הביצועים של המשתמש, כשיש שינוי משתמש. |
| פרטי איסוף תקופתיים | מידע על הסשן התקופתי לאיסוף נתוני הביצועים שמתחיל אחרי שההפעלה מסתיימת. |
| דוח ביצועים בזמן האתחול | מכיל נתוני ביצועים שנאספו במהלך הפעלת המערכת. הנתונים האלה נשארים בזיכרון עד שהמערכת מושבתת, כך שהנתונים מופיעים בכל הדוחות. |
| דוח ביצועים של התעוררות | מכיל נתוני ביצועים שנאספו במהלך ההפעלה. הנתונים האלה נשמרים בזיכרון עד שהמערכת מושבתת, ולכן הם מופיעים בכל הדוחות. |
| דוח ביצועים של החלפת משתמשים | מכיל נתוני ביצועים שנאספו במהלך החלפת משתמש. הנתונים האלה נשארים בזיכרון עד שהמערכת מושבתת, ולכן הם מופיעים בכל הדוחות. |
| דוח ביצועי הקלט/פלט של N הדקות האחרונות | מכיל נתוני ביצועים שנאספו (על ידי סשן האיסוף התקופתי) במהלך N הדקות האחרונות לפני יצירת הדוח. |
| משך האיסוף | משך הזמן הכולל של איסוף נתוני הביצועים. |
| מספר האוספים | המספר הכולל של האוספים שדווחו בדוח אחד. |
כל אוסף שמדווח בדוח עשוי לכלול את כל הקטעים הבאים או חלק מהם. הנתונים הסטטיסטיים שמדווחים בכל אוסף הם השינוי מאז האוסף הקודם, מלבד הנתונים הסטטיסטיים המיידיים (למשל, לא מצטברים מאז הפעלת המערכת).
| פריט | תיאור |
|---|---|
| אחוז/זמן המתנה של קלט/פלט במעבד (CPU) | זמן מעבד מוחלט ואחוז מזמן המעבד הכולל שעבר על מעבר הקשר או על המתנה בגלל פעולות קלט/פלט מאז האיסוף האחרון. |
| זמן CPU כולל | הזמן הכולל של המעבד (CPU) באלפיות השנייה. |
| סה"כ זמן CPU במצב חוסר פעילות | זמן המעבד הכולל שבו המחשב היה במצב חוסר פעילות. |
| זמן ההמתנה של קלט/פלט במעבד (CPU) | הזמן הכולל שהמעבד בילה בהמתנה לפעולות קלט/פלט. |
| מספר המעברים להקשר | מספר המעברים של המעבד מתהליך או משרשור אחד לשני. |
| מספר תהליכים חסומים של קלט/פלט (I/O)/אחוז | המספר הכולל של תהליכים חסומים בהמתנה לקלט/פלט (I/O) ואחוז התהליכים חסומים בהמתנה לקלט/פלט (I/O) מאז האיסוף האחרון. |
| Top N CPU Times |
N החבילות המובילות שצרכו הכי הרבה זמן מעבד (CPU) מאז האיסוף האחרון:
|
| קריאות קלט/פלט (I/O) מובילות של N Storage |
N חבילות מובילות שקוראות הכי הרבה נתונים מהדיסק מאז האיסוף האחרון. כל שורה מכילה את מזהה המשתמש, שם החבילה, המספר הכולל של הבייטים שנקראים במצב חזית לעומת מצב רקע, אחוז הבייטים בכל הקריאות במצב חזית לעומת מצב רקע שנעשו במערכת, המספר הכולל של הקריאות ל- |
| Top N Storage I/O Writes | החבילות המובילות (Top N) שכתבו את רוב הנתונים בדיסק מאז האיסוף האחרון. כל שורה מכילה שדות דומים לאלה של 'הכתבות הנקראות ביותר'. |
| ה-UIDs המובילים של המתנה ל-I/O | החבילות המובילות עם מספר משימות ההמתנה הגדול ביותר של קלט/פלט.
|
| הכשלים העיקריים המובילים בדפים | חבילות N המובילות עם השגיאות העיקריות ביותר בדפים מאז האיסוף האחרון. |