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

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

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

Средство просмотра поиска позволяет создавать и выполнять пользовательские 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 используйте представление 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 :

Таблица ProtoLog SQL

Данные 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. Временная шкала поиска.