perfetto הוא כלי שמאפשר לאסוף מידע על ביצועים ממכשירי Android באמצעות Android Debug Bridge (ADB). מפעילים את הכלי perfetto באמצעות הפקודה adb shell perfetto ....
perfetto משתמש במקורות שונים כדי לאסוף נתוני מעקב אחר ביצועים מהמכשיר, למשל:
-
ftraceלמידע מהליבה (kernel) atraceלהערות במרחב המשתמש בשירותים ובאפליקציותheapprofdלמידע על השימוש בזיכרון המקורי של שירותים ואפליקציות
בדף הזה מוסבר איך להפעיל את perfetto ולהגדיר אותו כדי ליצור את הפלט הרצוי. מידע נוסף זמין במאמרי העזרה של perfetto.
מיומנויות ב-Android
הצגת הקוד ב-GitHubכלי לניתוח ביצועים (profiler) של Android
android skills add android-profilerתחביר
בקטע הזה מוסבר איך להשתמש ב-ADB כדי להפעיל את perfetto במצבים שונים וליצור מעקב.
בחירת מקור נתונים
ל-perfetto יש שני מצבים שקובעים את מקורות הנתונים שבהם הוא משתמש כדי לתעד את המעקב:
- מצב בהיר: אפשר לבחור רק קבוצת משנה של מקורות נתונים, ספציפית
atraceו-ftrace. עם זאת, המצב הזה מציע ממשק דומה ל-systrace. - מצב רגיל: מקבל את ההגדרות שלו במאגר אחסון לפרוטוקולים ומאפשר לכם להשתמש בפונקציונליות נוספת של
perfettoבאמצעות מקורות נתונים שונים מ-atraceומ-ftrace.
אפשרויות כלליות
בטבלה הבאה מפורטות האפשרויות הזמינות כשמשתמשים ב-perfetto בכל אחד מהמצבים:
טבלה 1. רשימת האפשרויות הכלליות הזמינות בכלי perfetto.
| אפשרות | תיאור |
|---|---|
--background |
|
perfetto יוצא מיד מממשק שורת הפקודה וממשיך להקליט את המעקב ברקע. |
--background-wait | -D
|
כמו --background, אבל ממתין (עד 30 שניות) שכל מקורות הנתונים יתחילו לפני היציאה. קוד היציאה הוא אפס אם מתקבל אישור שהפעולה הצליחה, ואחרת הוא לא אפס (שגיאה או זמן קצוב לתפוגה).
|
--alert-id
|
מזהה ההתראה שהפעילה את המעקב הזה. |
--config-id
|
המזהה של ההגדרה שהפעילה את הכלל. |
--config-uid
|
UID של האפליקציה שרשמה את ההגדרה. |
--subscription-id
|
מזהה המינוי שהפעיל את המעקב הזה. |
--out OUT_FILE |
|
מציינת את הנתיב הרצוי לקובץ פרטי ההעברה או הערה: צריך לציין את שם הנתיב המלא של קובץ הפלט. בדרך כלל צריך לכתוב את הקבצים בתיקייה |
--upload
|
בסיום, מעבירה את נתוני המעקב לחבילה שצוינה בהודעה IncidentReportConfig בהגדרות של נתוני המעקב של הפרוטוקול. |
--no-guardrails
|
השבתת ההגנות מפני שימוש מוגזם במשאבים כשמפעילים את הדגל --upload במהלך הבדיקה. |
--reset-guardrails
|
איפוס המצב הקבוע של הגדרות הבטיחות והיציאות לצורך בדיקה. |
--rsave-for-bugreport
|
אם פועל מעקב עם bugreport_score > 0,
המעקב נשמר בקובץ. בסיום, הפלט הוא הנתיב.
|
--query
|
שליחת שאילתה לגבי מצב השירות והדפסה שלו כטקסט קריא לאנשים. |
--query-raw
|
דומה ל---query, אבל מדפיס בייטים גולמיים בקידוד פרוטו של
tracing_service_state.proto. |
--help | -h
|
מדפיס טקסט עזרה לכלי perfetto.
|
מצב בהיר
התחביר הכללי לשימוש ב-perfetto במצב בהיר הוא:
adb shell perfetto [ --time TIMESPEC ] [ --buffer SIZE ] [ --size SIZE ]
[ ATRACE_CAT | FTRACE_GROUP/FTRACE_NAME | FTRACE_GROUP/* ]...
--out FILE
בטבלה הבאה מפורטות האפשרויות הזמינות כשמשתמשים ב-perfetto במצב בהיר:
טבלה 2. רשימת האפשרויות הזמינות של הכלי perfetto במצב בהיר.
| אפשרות | תיאור |
|---|---|
--time TIME[s|m|h] |
|
מציין את משך המעקב בשניות, בדקות או בשעות.
לדוגמה, --time 1m מציין משך מעקב של דקה אחת.
ברירת המחדל למשך הזמן היא 10 שניות.
|
--buffer SIZE[mb|gb] |
|
מציינת את גודל שטח האחסון הזמני במגה-בייט (MB) או בג'יגה-בייט (GB).
הפרמטר שמוגדר כברירת מחדל הוא --buffer 32mb.
|
--size SIZE[mb|gb] |
|
מציינת את גודל הקובץ המקסימלי במגה-בייט (MB) או בג'יגה-בייט (GB). כברירת מחדל, perfetto משתמש רק במאגר נתונים זמני (ring-buffer) בזיכרון.
|
--app | -a
|
שם האפליקציה ב-Android (atrace) |
אחרי האפשרויות האלה מופיעה רשימה של מזהי אירועים:
טבלה 3. רשימת מזהי אירועים למצב בהיר.
| אירוע | תיאור |
|---|---|
| ATRACE_CAT |
מציינת את הקטגוריות של atrace שרוצים לתעד את המעקב שלהן.
לדוגמה, הפקודה הבאה עוקבת אחרי Window Manager באמצעות atrace:
adb shell perfetto --out FILE wm
כדי לתעד קטגוריות אחרות, אפשר לעיין ברשימה הזו של קטגוריות |
| FTRACE_GROUP/FTRACE_NAME |
מציינת את אירועי ftrace שרוצים לתעד את המעקב שלהם.
לדוגמה, הפקודה הבאה עוקבת אחרי אירועי sched/sched_switch:
adb shell perfetto --out FILE sched/sched_switch
|
מצב רגיל
התחביר הכללי לשימוש ב-perfetto במצב רגיל הוא:
adb shell perfetto [ --txt ] --config CONFIG_FILE --out FILE
בטבלה הבאה מפורטות האפשרויות הזמינות כשמשתמשים ב-perfetto במצב רגיל:
טבלה 4. רשימת האפשרויות הזמינות לכלי perfetto במצב רגיל.
| אפשרות | תיאור |
|---|---|
--config CONFIG_FILE | -c CONFIG_FILE
|
מציינת את הנתיב לקובץ תצורה. במצב רגיל, יכול להיות שחלק מההגדרות יקודדו במאגר אחסון לפרוטוקולים של הגדרות אישיות. הקובץ הזה חייב לעמוד בדרישות של סכימת מאגר האחסון לפרוטוקולים שמוגדרת ב-AOSP trace_config.proto.
בוחרים ומגדירים את מקורות הנתונים באמצעות האיבר |
--txt
|
הוראה ל-perfetto לנתח את קובץ התצורה כ-pbtxt. הדגל הזה מיועד לבדיקה מקומית בלבד, ולא מומלץ להפעיל אותו בסביבת ייצור. |
מקורות נתונים נתמכים
בקטע הזה מתוארים המקורות השונים שבהם perfetto משתמש כדי ליצור את המעקב.
ftrace
מקור הנתונים ftrace מאפשר ל-perfetto לקבל אירועים מהליבה.
כדי להפעיל את המקור הזה, מגדירים את
ftrace_config
ב-DataSourceConfig.
אפשר להפעיל את האירועים הבאים:
-
sched/sched_switchsched/sched_wakeupsched/sched_wakeup_newsched/sched_process_execsched/sched_process_exitsched/sched_process_forksched/sched_process_freesched/sched_process_hangsched/sched_process_wait
אירועים במערכת הקבצים:
יכול להיות שאירועים נוספים יהיו זמינים, בהתאם למכשיר, לגרסת מערכת ההפעלה או לליבה (kernel). מידע נוסף זמין בפרוטוקולים של ההגדרות.
נתונים סטטיסטיים של תהליכים
מקור הנתונים של נתוני התהליכים מאפשר לכם לקבל מוני דגימה לגבי המערכת ותהליכים ספציפיים.
כדי להפעיל את המקור הזה, צריך להגדיר את process_stats_config ואת sys_stats_config ב-DataSourceConfig.
הנתונים ש-perfetto יוצר כוללים:
-
/proc/meminfo/proc/vmstat/proc/stat
-
/proc/\<pid\>/status/proc/\<pid\>/oom_score_adj
יכול להיות שיהיו אירועים נוספים, בהתאם למכשיר, לגרסת מערכת ההפעלה ולליבה (kernel). מידע נוסף זמין בפרוטוקולים של ההגדרות של sys_stats ו-process_stats.
heapprofd
heapprofd מאפשר לכם לדגום את הגורמים לשימוש בזיכרון המקורי.
כדי להפעיל את המקור הזה, מגדירים את heapprofd_config ב-DataSourceConfig. ההגדרה הזו יוצרת את ProfilePackets, כולל הפריימים של Java במחסנית הקריאות.
מידע נוסף על השימוש ב-heapprofd זמין בכתובת perfetto.dev.
מקורות אחרים
יכול להיות שיהיו מקורות נתונים נוספים, בהתאם למכשיר, לגרסת מערכת ההפעלה ולליבה (kernel). למידע נוסף, קראו את הפרוטוקולים של הגדרת מקור הנתונים.
מידע נוסף על perfetto זמין בכתובת perfetto.dev.