השירות נייטיב של הטיימר המפקח (watchdog) מתעד נתוני ביצועים של קלט/פלט (I/O) מאז תחילת ההפעלה המוקדמת של המערכת. שירות ה-Native מוחק את נתוני הביצועים שנאספו בדוח הבאגים. ספקים יכולים לשלוח שאילתות על השירות המקורי באמצעות קובצי dumpsy כדי למחוק את הנתונים שנאספו או להתחיל סשן איסוף בהתאמה אישית לניפוי באגים.
תדירות איסוף הנתונים
התדירות של איסוף נתוני הביצועים משתנה בהתאם לסוג ה-build.
- ב-Userdebug או בקובצי build של מעורבות, הכלי Watchdog אוסף נתוני ביצועים פעם אחת (1) בשנייה במהלך האתחול של המערכת, ופעם אחת (1) דקות לאחר ההפעלה.
- בגרסת build של משתמש, ה-Watchdog אוסף את נתוני הביצועים פעם אחת בכל 20 שניות במהלך האתחול של המערכת, ופעם אחת בכל שתי (2) דקות לאחר השלמת ההפעלה.
אירועי איסוף נתונים
פרופיילינג מבוסס דגימות מבוצע במהלך אירועי מערכת שונים (כמו אתחול מערכת, הוצאת מערכת ממצב שינה והחלפת משתמש) ובמהלך חלון N הדקות האחרונות.
- אירועים ב-N הדקות האחרונות לפני יצירת דוח על באג: נוצר במהלך חלון זמן מצטבר של 30 דקות.
- אירועים מסוג 'זמן הפעלה': נוצרים אחרי ההפעלה.
- אירועים של החלפת משתמש: נוצרים אחרי שמתבצע שינוי של משתמש.
- אירועי איסוף בהתאמה אישית: אפשר לציין את תקופת הדגימה ואת משך הזמן המקסימלי ולסנן לפי חבילות.
מחיקת נתוני הביצועים
כשדוח על באג מתועדים, השירות המקורי של Watchdog מאחסן את נתוני הביצועים שנאספו בדוח הבאג. הספקים יכולים לשלוח שאילתות על השירות המקורי באמצעות הפקודה dumpsys שבהמשך כדי להעלות את נתוני הביצועים שנאספו. פרטים על הדוח זמינים בסעיף הסבר על דוח נתוני הביצועים.
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default > /tmp/carwatchdog_dump.txt
איסוף נתוני ביצועים לניפוי באגים
ספקים יכולים להשתמש בשירות המקורי של הטיימר המפקח (watchdog) כדי לאסוף נתוני ביצועים למטרות ניפוי באגים בהתאמה אישית. לדוגמה, כדי להבין את השימוש בקלט/פלט (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
Dump לפורמט אב
אופציונלי: אפשר להוריד את נתוני dumpsys בפורמט פרוטו:
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 הדקות האחרונות לפני יצירת הדוח.
| שם | תיאור |
|---|---|
| מידע על איסוף נתונים בזמן ההפעלה | מספקת מידע על סשן איסוף הנתונים של הביצועים בזמן האתחול. |
| מידע על האיסוף בזמן השכמה | מספק מידע על סשן איסוף הנתונים של ביצועי המצב ממצב שינה כשהמערכת מתעוררת מההשעיה. |
| פרטי האוסף 'העברת משתמשים' | מספקת מידע על הסשן של איסוף נתוני הביצועים לאחר העברת המשתמש כשיש שינוי משתמש. |
| פרטי איסוף תקופתיים | מספק מידע על הסשן התקופתי של איסוף נתוני הביצועים שמתחיל לאחר השלמת האתחול. |
| דוח ביצועים בזמן ההפעלה | מכיל נתוני ביצועים שנאספו במהלך אתחול המערכת. נתונים אלה נשמרים בזיכרון עד שהמערכת משביתה אותם, לכן הוספת הנתונים לכל הדוחות מתבצעת. |
| דוח הביצועים לאחר יציאה ממצב שינה | מכילה נתוני ביצועים שנאספו במהלך ההתעוררות. הנתונים האלה נשמרים בזיכרון עד להשבתת המערכת, ולכן הם לא נשמרים בכל הדוחות. |
| דוח ביצועים של החלפת משתמשים | מכילה נתוני ביצועים שנאספו במהלך מעבר המשתמש. הנתונים האלה נשמרים בזיכרון עד להשבתת המערכת, ולכן הוספת הנתונים לכל הדוחות מתבצעת. |
| דוח ביצועי I/O של N הדקות האחרונות | מכיל נתוני ביצועים שנאספו (לפי סשן האיסוף התקופתי) במהלך N הדקות האחרונות לפני יצירת הדוח. |
| משך האיסוף | משך הזמן הכולל של איסוף נתוני הביצועים. |
| מספר הקולקציות | המספר הכולל של האוספים שדווחו בדוח אחד. |
כל אוסף שמופיע בדוח עשוי להכיל את כל הקטעים הבאים, או חלק מהם. הנתונים הסטטיסטיים שמדווחים בכל אוסף הם השינויים בדלתא מאז האוסף האחרון, מלבד הנתונים הסטטיסטיים מיידיים (לדוגמה, לא נצברים מאז הפעלת המערכת).
| שם | תיאור |
|---|---|
| אחוז/זמן המתנה של קלט/פלט במעבד (CPU) | זמן המעבד (CPU) המוחלט והאחוז הכולל של זמן המעבד (CPU) שהוקדש לשינוי הקשר או להמתנה עקב פעולות קלט/פלט (I/O) מאז האיסוף האחרון. |
| זמן CPU כולל | זמן המעבד (CPU) הכולל באלפיות השנייה. |
| סה"כ זמן CPU לא פעיל | הזמן הכולל של המעבד (CPU) במצב לא פעיל. |
| זמן המתנה של קלט/פלט במעבד (CPU) | סך כל הזמן שהמעבד הוקדש בהמתנה לפעולות קלט/פלט (I/O). |
| מספר העברות ההקשר | מספר המעבדים (CPU) שעוברים מתהליך או משרשור אחד לתהליך אחר. |
| מספר תהליכי קלט/פלט (I/O) חסומים/אחוזים | המספר הכולל של התהליכים שנחסמו בהמתנה לקלט/פלט ואחוז התהליכים שנחסמו בהמתנה לקלט/פלט מאז האיסוף האחרון. |
| N המעבדים (CPU) המובילים |
N החבילות המובילות שצרכו הכי הרבה זמן מעבד (CPU) מאז האיסוף האחרון:
|
| קריאות קלט/פלט (I/O) מובילות של N Storage |
N חבילות מובילות שקוראות הכי הרבה נתונים מהדיסק מאז האיסוף האחרון. כל שורה כוללת את מזהה המשתמש, שם החבילה, המספר הכולל של הבייטים שנקראו במצב חזית לעומת מצב הרקע, אחוז הבייטים שנקראו בכל המצב הקדמי לעומת
הקריאות במצב רקע במערכת, המספר הכולל של הקריאות ל- |
| כתבי קלט/פלט (I/O) מובילים של N Storage | N החבילות המובילות שכתבו את רוב הנתונים לדיסק מאז האיסוף האחרון. בכל שורה יש שדות שדומים לשדות של N הספרים המובילים. |
| מזהי UID/ N/O מובילים בהמתנה | N חבילות מובילות עם הכי הרבה משימות בהמתנה של קלט/פלט.
|
| N הפגמים העיקריים בדפים | N החבילות המובילות עם השגיאות הנפוצות ביותר בדפים מאז האוסף האחרון. |