Perfetto

‫perfetto הוא כלי שמאפשר לאסוף מידע על ביצועים ממכשירי Android באמצעות Android Debug Bridge‏ (ADB). מפעילים את הכלי perfetto באמצעות הפקודה adb shell perfetto .... ‫perfetto משתמש במקורות שונים כדי לאסוף נתוני מעקב אחר ביצועים מהמכשיר, למשל:

  • ‫ftrace למידע מהליבה (kernel)
  • atrace להערות במרחב המשתמש בשירותים ובאפליקציות
  • heapprofd למידע על השימוש בזיכרון המקורי של שירותים ואפליקציות

בדף הזה מוסבר איך להפעיל את perfetto ולהגדיר אותו כדי ליצור את הפלט הרצוי. מידע נוסף זמין במאמרי העזרה של perfetto.

תחביר

בקטע הזה מוסבר איך להשתמש ב-ADB כדי להפעיל את perfetto במצבים שונים וליצור מעקב.

בחירת מקור נתונים

ל-perfetto יש שני מצבים שקובעים את מקורות הנתונים שבהם הוא משתמש כדי לתעד את המעקב:

  • מצב בהיר: אפשר לבחור רק קבוצת משנה של מקורות נתונים, ספציפית atrace ו-ftrace. עם זאת, המצב הזה מציע ממשק דומה ל-systrace.
  • מצב רגיל: מקבל את ההגדרות שלו במאגר אחסון לפרוטוקולים ומאפשר לכם להשתמש בפונקציונליות נוספת של perfetto באמצעות מקורות נתונים שונים מ-atrace ומ-ftrace.

אפשרויות כלליות

בטבלה הבאה מפורטות האפשרויות הזמינות כשמשתמשים ב-perfetto בכל אחד מהמצבים:

טבלה 1. רשימת האפשרויות הכלליות הזמינות בכלי perfetto.

אפשרות תיאור
--background |
-d
‫perfetto יוצא מיד מממשק שורת הפקודה וממשיך להקליט את המעקב ברקע.
--background-wait | -D כמו --background, אבל ממתין (עד 30 שניות) שכל מקורות הנתונים יתחילו לפני היציאה. קוד היציאה הוא אפס אם מתקבל אישור שהפעולה הצליחה, ואחרת הוא לא אפס (שגיאה או זמן קצוב לתפוגה).
--alert-id מזהה ההתראה שהפעילה את המעקב הזה.
--config-id המזהה של ההגדרה שהפעילה את הכלל.
--config-uid ‫UID של האפליקציה שרשמה את ההגדרה.
--subscription-id מזהה המינוי שהפעיל את המעקב הזה.
--out OUT_FILE |
-o OUT_FILE

מציינת את הנתיב הרצוי לקובץ פרטי ההעברה או - עבור stdout. ‫perfetto כותב את הפלט בקובץ שמתואר בדגלים הקודמים. פורמט הפלט תואם לפורמט שמוגדר ב-AOSP trace.proto.

הערה: צריך לציין את שם הנתיב המלא של קובץ הפלט. בדרך כלל צריך לכתוב את הקבצים בתיקייה /data/misc/perfetto-traces.

--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] |
-t TIME[s|m|h]
מציין את משך המעקב בשניות, בדקות או בשעות. לדוגמה, --time 1m מציין משך מעקב של דקה אחת. ברירת המחדל למשך הזמן היא 10 שניות.
--buffer SIZE[mb|gb] |
-b SIZE[mb|gb]
מציינת את גודל שטח האחסון הזמני במגה-בייט (MB) או בג'יגה-בייט (GB). הפרמטר שמוגדר כברירת מחדל הוא --buffer 32mb.
--size SIZE[mb|gb] |
-s 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
    

כדי לתעד קטגוריות אחרות, אפשר לעיין ברשימה הזו של קטגוריות atrace.

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.

בוחרים ומגדירים את מקורות הנתונים באמצעות האיבר DataSourceConfig של TraceConfig, כפי שמוגדר ב-AOSP data_source_config.proto.

--txt הוראה ל-perfetto לנתח את קובץ התצורה כ-pbtxt. הדגל הזה מיועד לבדיקה מקומית בלבד, ולא מומלץ להפעיל אותו בסביבת ייצור.

מקורות נתונים נתמכים

בקטע הזה מתוארים המקורות השונים שבהם perfetto משתמש כדי ליצור את המעקב.

ftrace

מקור הנתונים ftrace מאפשר ל-perfetto לקבל אירועים מהליבה.

כדי להפעיל את המקור הזה, מגדירים את ftrace_config ב-DataSourceConfig.

אפשר להפעיל את האירועים הבאים:

  • פעילות תזמון:

    • sched/sched_switch
    • sched/sched_wakeup
    • sched/sched_wakeup_new
    • sched/sched_process_exec
    • sched/sched_process_exit
    • sched/sched_process_fork
    • sched/sched_process_free
    • sched/sched_process_hang
    • sched/sched_process_wait
  • אירועים במערכת הקבצים:

  • atrace אירועים

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

נתונים סטטיסטיים של תהליכים

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

כדי להפעיל את המקור הזה, צריך להגדיר את process_stats_config ואת sys_stats_config ב-DataSourceConfig.

הנתונים ש-perfetto יוצר כוללים:

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

heapprofd

‫heapprofd מאפשר לכם לדגום את הגורמים לשימוש בזיכרון המקורי.

כדי להפעיל את המקור הזה, מגדירים את heapprofd_config ב-DataSourceConfig. ההגדרה הזו יוצרת את ProfilePackets, כולל הפריימים של Java במחסנית הקריאות.

מידע נוסף על השימוש ב-heapprofd זמין בכתובת perfetto.dev.

מקורות אחרים

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

מידע נוסף על perfetto זמין בכתובת perfetto.dev.