חיפוש בנתוני מעקב

אפשר להשתמש ב-SQL כדי למצוא מצבים ספציפיים בקובצי מעקב של Winscope Perfetto. מציג החיפוש הגלובלי בממשק המשתמש של Winscope מאפשר להריץ שאילתות ולהציג תוצאות בטבלה:

איור 1. חיפוש בכרטיסייה 'צופים'.

הכלי Search מאפשר לכתוב ולהריץ שאילתות SQL מותאמות אישית על עקבות Perfetto. אפשר גם לגשת לשאילתות מהזמן האחרון ולשאילתות שמורות. ‫Winscope מספק תצוגות SQL מיוחדות שעוזרות לכם לחפש עקבות של SurfaceFlinger,‏ Transactions,‏ Transitions ו-ViewCapture.

המוסכמות הבאות חלות על כל התצוגות:

• עבור העמודות property ו-flat_property:

  • שמות הנכסים הם בפורמט snake case, לדוגמה visible_region מתוך LayerProto.

  • סימון נקודות מייצג נכסים מוטמעים, לדוגמה, visible_region.rect.

  • שדות חוזרים ב-property מובחנים באמצעות סוגריים מרובעים:

    לדוגמה, בשני מקרים של השדה החוזר visible_region.rect, השדה top מיוצג על ידי visible_region.rect[0].top ו-visible_region.rect[1].top.

  • אי אפשר להבחין בין שדות חוזרים ב-flat_property:

    לדוגמה, בשני מקרים של שדה חוזר visible_region.rect, השדה top מיוצג על ידי visible_region.rect.top בשני המקרים.

• בעמודות value ו-previous_value, ערכים בוליאניים מיוצגים על ידי 0 (False) או 1 (True).

כדי ליצור את התצוגות האלה, Winscope מצטרף לנתונים מטבלאות ספציפיות למעקב עם טבלת args Perfetto. אפשר להריץ שאילתות ישירות בטבלאות האלה. בטבלה args, העמודות key,‏ flat_key ו-display_value מקבילות לעמודות התצוגה property,‏ flat_property ו-value בהתאמה.

args טבלה:

תצוגות SQL של SurfaceFlinger

נתוני פרוטוקול SurfaceFlinger משתמשים בפורמטים הבאים:

• נתוני השכבה הם בפורמט LayerProto.
• נתוני השורש של ההיררכיה הם בפורמט LayersSnapshotProto.

כדי לחפש נתונים בשכבה, משתמשים בתצוגה sf_layer_search. התצוגה הזו כוללת את העמודות הבאות:

כדי לחפש נתונים של שורש ההיררכיה, משתמשים בתצוגה sf_hierarchy_root_search. התצוגה הזו כוללת את העמודות הבאות:

שאילתות לדוגמה

• חיפוש כל הפריימים שבהם השכבה IME גלויה:

  SELECT DISTINCT ts, layer_id, layer_name FROM sf_layer_search
    WHERE layer_name like 'IME%'
    AND is_visible=1
  

• חיפוש כל המסגרות שבהן לשכבה IME יש גבולות מסך תקינים:

  SELECT ts, value, previous_value FROM sf_layer_search
    WHERE layer_name like 'IME%'
    AND property='screen_bounds.bottom'
    AND value<='24000'
  

• כאן תוכלו לראות את כל הפריימים שבהם השכבה Taskbar color.a (אלפא) משתנה:

  SELECT ts, value, previous_value FROM sf_layer_search
    WHERE layer_name like 'Taskbar%'
    AND property='color.a'
    AND value!=previous_value
  

• כדי למצוא את כל המסגרות שבהן הגבול התחתון של Wallpaper קטן מ-2400 או שווה לו:

  SELECT ts, value, previous_value FROM sf_layer_search
    WHERE layer_name LIKE 'Wallpaper%'
    AND property='bounds.bottom'
    AND cast_int!(value) <= 2400
  

• רשימת כל הנכסים לתצוגות עם שכבות תקפות:

  SELECT STATE.* FROM sf_hierarchy_root_search STATE_WITH_DISPLAY_ON
  INNER JOIN sf_hierarchy_root_search STATE
    ON STATE.state_id = STATE_WITH_DISPLAY_ON.state_id
    AND STATE_WITH_DISPLAY_ON.flat_property='displays.layer_stack'
    AND STATE_WITH_DISPLAY_ON.value!='4294967295'
    AND STATE.property LIKE CONCAT(
      SUBSTRING(
          STATE_WITH_DISPLAY_ON.property,
          0,
          instr(STATE_WITH_DISPLAY_ON.property, ']')
      ),
      '%'
    )
  

• חיפוש כל המסגרות שבהן אפשר לראות את התנועה לחזרה אחורה

  SELECT DISTINCT STATE.ts FROM sf_layer_search STATE
    WHERE STATE.layer_name LIKE 'EdgeBackGestureHandler%'
  

טבלאות נתונים

התצוגות של SurfaceFlinger נוצרות באמצעות הטבלאות הבסיסיות הבאות.

surfaceflinger_layers_snapshot:

surfaceflinger_layer:

תצוגת SQL של עסקאות

נתוני הפרוטו של העסקאות משתמשים בפורמט TransactionTraceEntry.

כדי לחפש נתוני מעקב של עסקאות, משתמשים בתצוגה transactions_search. התצוגה הזו כוללת את העמודות הבאות:

שאילתות לדוגמה

• מוצאים את המסגרת שבה הוחלה עסקה כדי לשנות את המיקום של שכבה x ל-‎-54.0:

  SELECT ts, transaction_id, value FROM transactions_search
    WHERE flat_property='transactions.layer_changes.x'
    AND value='-54.0'
  

• מאתרים את המסגרת שבה נוספה השכבה ImeContainer:

  SELECT ts FROM transactions_search
    WHERE flat_property='added_layers.name'
    AND value='ImeContainer'
  

טבלאות נתונים

תצוגת ה-SQL של העסקאות נוצרת באמצעות הטבלאות הבסיסיות הבאות.

surfaceflinger_transactions:

android_surfaceflinger_transaction:

android_surfaceflinger_transaction_flag:

עסקאות בודדות מתווספות לטבלת הארגומנטים מפורמטים שונים של הודעות פרוטו, בהתאם לסוג העסקה:

• ‫LAYER_ADDED: פורמט LayerCreationArgs
• ‫LAYER_CHANGED: פורמט LayerState
• ‫DISPLAY_ADDED: פורמט DisplayState
• ‫DISPLAY_CHANGED: פורמט DisplayState
• ‫LAYER_DESTROYED: No args
• ‫LAYER_HANDLE_DESTROYED: No args
• ‫DISPLAY_REMOVED: No args
• ‫NOOP: No args

תצוגת SQL של מעברים

נתוני הפרוטו של המעברים משתמשים בפורמט ShellTransition.

כדי לחפש נתונים של מעברים, משתמשים בתצוגה transitions_search. התצוגה הזו כוללת את העמודות הבאות:

שאילתות לדוגמה

איתור מאפיינים של מעברים שמטופלים על ידי DefaultMixedHandler:

  SELECT
    PROPS.ts,
    PROPS.transition_id,
    PROPS.property,
    PROPS.value
  FROM transitions_search HANDLER_MATCH
  INNER JOIN transitions_search PROPS
    ON HANDLER_MATCH.transition_id = PROPS.transition_id
  WHERE HANDLER_MATCH.property = 'handler'
    AND HANDLER_MATCH.value LIKE "%DefaultMixedHandler"
  ORDER BY PROPS.transition_id, PROPS.property

טבלאות נתונים

התצוגה 'מעברים' נוצרת באמצעות הטבלאות הבסיסיות הבאות.

window_manager_shell_transitions:

window_manager_shell_transition_handlers:

android_window_manager_shell_transition_participants:

תצוגת SQL של ViewCapture

הנתונים בפרוטוקול ViewCapture משתמשים בפורמט View.

כדי לחפש נתונים של ViewCapture, משתמשים בתצוגה viewcapture_search. התצוגה הזו כוללת את העמודות הבאות:

שאילתות לדוגמה

כדי למצוא את כל המצבים שבהם SearchContainerView זז בכיוון y:

  SELECT * FROM viewcapture_search
  WHERE class_name LIKE '%SearchContainerView'
    AND flat_property='translation_y'
    AND value!=previous_value

טבלאות נתונים

התצוגה ViewCapture נוצרת באמצעות הטבלאות הבסיסיות הבאות.

android_viewcapture:

android_viewcapture_view:

טבלת SQL של ProtoLog

נתוני ה-proto של ProtoLog הם בפורמט ProtoLogMessage. התצוגה הזו כוללת את העמודות הבאות:

שאילתות לדוגמה

• למצוא את כל היומנים עם הודעה שמכילה את transition:

  SELECT ts, message, location FROM protolog
    WHERE message LIKE '%transition%'
  

• כדי למצוא את כל היומנים שמכילים מזהי עסקאות תקינים:

  CREATE PERFETTO VIEW valid_tx_ids AS
    SELECT DISTINCT transaction_id FROM transactions_search
    WHERE transaction_id IS NOT NULL AND transaction_id != '0';
  
  SELECT TRANS.transaction_id, message FROM valid_tx_ids TRANS
  INNER JOIN protolog LOGS
    ON LOGS.message LIKE CONCAT('%', TRANS.transaction_id, '%');
  

תצוגת SQL של WindowManager

נתוני הפרוטו של WindowManager משתמשים בפורמט ההיררכי WindowManagerServiceDumpProto. אפשר לחפש מאפיינים של כל מאגר WindowManager, כולל:

• DisplayContentProto
• DisplayAreaProto
• TaskProto
• ActivityRecordProto
• WindowTokenProto
• WindowStateProto
• TaskFragmentProto
• WindowContainerProto

כדי לחפש נתונים של WindowManager, משתמשים בתצוגה wm_search. התצוגה הזו כוללת את העמודות הבאות:

שאילתות לדוגמה

• איתור כל המדינות שבהן LauncherActivity מוצג:

  SELECT DISTINCT ts, title, token FROM wm_search
    WHERE title like '%LauncherActivity%'
    AND is_visible=1
  

• איתור כל המדינות שבהן פני השטח של Wallpaper נמצאים בתנועה:

  SELECT ts, value, previous_value FROM wm_search
    WHERE title like '%Wallpaper%'
    AND property like '%surface_position%'
    AND value != previous_value
  

טבלאות נתונים

התצוגה WindowManager נוצרת באמצעות הטבלאות הבסיסיות הבאות.

android_windowmanager:

android_windowmanager_windowcontainer:

הרצת שאילתות

אפשר להריץ שאילתות חיפוש באמצעות החלונית חיפוש גלובלי שמימין למציג החיפוש.

כשאתם משתמשים בפעם הראשונה בחלונית GLOBAL SEARCH, מתבצעת אתחול של חיפוש העקבות ו-Winscope יוצרת את תצוגות העזר של SQL. התהליך נמשך כמה שניות. בזמן האתחול של חיפוש העקבות, ציר הזמן לא זמין.

כדי להריץ שאילתה, כותבים אותה בתיבת החיפוש ולוחצים על הפעלת שאילתת חיפוש או מקישים על Enter במקלדת.

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

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

איור 2. החלונית השמאלית של כלי הצפייה בחיפוש.

תוצאות

כל השאילתות מחזירות תוצאות בטבלה, שמוצגות בתצוגה שאפשר לגלול בה עם התנהגות אינטראקטיבית שדומה לכלי הצגת עקבות מבוסס-יומן, כמו Transactions ו-ProtoLog:

איור 3. תוצאות החיפוש.

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

איור 4. חיפוש בציר הזמן.