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

Используйте 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 создает эти представления, объединяя данные из таблиц, специфичных для трассировки, с таблицей Perfetto args . Вы можете напрямую запрашивать эти таблицы. В таблице 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 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 :

Просмотр 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 :

Таблица ProtoLog SQL

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, '%');
  

Выполнять запросы

Вы можете выполнять поисковые запросы с помощью панели ГЛОБАЛЬНОГО ПОИСКА в левой части окна просмотра поиска .

При первом взаимодействии с панелью GLOBAL SEARCH инициализируется поиск трассировки, а Winscope создает вспомогательные представления SQL. Это занимает несколько секунд. Пока инициализируется поиск трассировки, временная шкала недоступна.

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

После завершения таблица результатов отображается на средней панели. Ваш запрос отображается под полем поиска с полем для сохранения запроса между сеансами.

Вы можете получить доступ к сохраненным запросам, нажав на вкладку Сохраненные на левой панели, а также получить доступ к недавно выполненным запросам, нажав на вкладку Недавние :

Рисунок 2. Левая панель средства просмотра поиска.

Результаты

Все запросы возвращают табличные результаты, отображаемые в прокручиваемом виде с интерактивным поведением, аналогичным средствам просмотра трассировки на основе журналов, таким как Transactions и ProtoLog:

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

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

Рисунок 4. Хронология поиска.