Поиск трассировки

Используйте SQL, чтобы найти определенные состояния в трассировках Winscope Perfetto. Глобальный инструмент Поиск в интерфейсе Winscope позволяет выполнять запросы и визуализировать результаты в виде таблиц:

Рисунок 1. Вкладка поиска в окне просмотра.

В окне Search (Поиск) можно писать и выполнять SQL-запросы к трассировкам Perfetto. Вы также можете получить доступ к недавним и сохраненным запросам. В Winscope есть специальные представления SQL, которые помогают искать трассировки SurfaceFlinger, Transactions, Transitions и ViewCapture.

Для всех представлений используются следующие условные обозначения:

• Для столбцов property и flat_property:

  • Названия свойств пишутся в змеином регистре, например 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:

Отдельные транзакции добавляются в таблицу args из разных форматов сообщений proto в зависимости от типа транзакции:

• LAYER_ADDED: формат LayerCreationArgs
• LAYER_CHANGED: формат LayerState
• DISPLAY_ADDED: формат DisplayState
• DISPLAY_CHANGED: формат DisplayState
• LAYER_DESTROYED: нет аргументов
• LAYER_HANDLE_DESTROYED: нет аргументов
• DISPLAY_REMOVED: нет аргументов
• NOOP: нет аргументов

Представление 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:

Представление ViewCapture SQL

Протокол 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

Данные ProtoLog proto используют формат 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. Это займет несколько секунд. Пока выполняется инициализация поиска трассировки, временная шкала недоступна.

Чтобы начать поисковый запрос, введите его в окно поиска и нажмите Выполнить поисковый запрос или Ввод на клавиатуре.

Результаты поиска появятся на средней панели. Ваш запрос появится под окном поиска, а рядом с ним – поле, в котором можно сохранить запрос между сеансами.

Чтобы посмотреть сохраненные запросы, нажмите на вкладку Сохраненные на панели слева. Чтобы посмотреть недавно выполненные запросы, нажмите на вкладку Недавние.

Рисунок 2. Поиск на левой панели просмотра.

Результаты

Все запросы возвращают результаты в виде таблицы, которую можно прокручивать. Взаимодействие с таблицей аналогично тому, как это происходит в средствах просмотра трассировки на основе журналов, например в инструментах "Транзакции" и ProtoLog.

Рисунок 3. Результаты поиска.

Если в итоговой таблице есть столбец ts, значения в нем интерпретируются как временные метки и добавляются в оверлей временной шкалы в виде новой строки записей. Нажмите на эту строку и используйте клавиши со стрелками влево и вправо, чтобы перемещаться между записями:

Рисунок 4. Поиск по временной шкале.