Búsqueda de seguimiento

Usa SQL para encontrar estados específicos en los registros de Winscope Perfetto. Usa el visor de búsqueda global en la IU de Winscope para ejecutar consultas y visualizar los resultados tabulados:

Figura 1: Pestaña del visor de búsqueda.

El visor de Search te permite escribir y ejecutar consultas de SQL personalizadas en los registros de Perfetto, así como acceder a las consultas recientes y guardadas. Winscope proporciona vistas SQL especializadas para ayudar a buscar registros de SurfaceFlinger, Transactions, Transitions y ViewCapture.

Usa las siguientes convenciones para todas las vistas:

• Para las columnas property y flat_property:

  • Los nombres de las propiedades están en formato snake_case, por ejemplo, visible_region de LayerProto.

  • La notación de puntos representa propiedades anidadas, por ejemplo, visible_region.rect.

  • Los campos repetidos en property se distinguen con corchetes:

    Por ejemplo, dentro de dos instancias del campo repetido visible_region.rect, el campo top se representa con visible_region.rect[0].top y visible_region.rect[1].top.

  • Los campos repetidos en flat_property no se pueden distinguir:

    Por ejemplo, dentro de dos instancias del campo repetido visible_region.rect, el campo top se representa con visible_region.rect.top en ambas instancias.

• En el caso de las columnas value y previous_value, los valores booleanos se representan con 0 (False) o 1 (True).

Winscope crea estas vistas combinando datos de tablas específicas del registro con la tabla args de Perfetto. Puedes consultar estas tablas directamente. En la tabla args, las columnas key, flat_key y display_value son análogas a las columnas de vista property, flat_property y value, respectivamente.

Tabla args:

Vistas de SQL de SurfaceFlinger

Los datos de SurfaceFlinger proto usan estos formatos:

• Los datos de la capa están en formato LayerProto.

• Los datos raíz de la jerarquía están en formato LayersSnapshotProto.

Para buscar datos de la capa, usa la vista sf_layer_search. Esta vista incluye las siguientes columnas:

Para buscar datos raíz de la jerarquía, usa la vista sf_hierarchy_root_search. Esta vista incluye las siguientes columnas:

Ejemplos de búsquedas

• Busca todos los fotogramas en los que la capa IME tenga límites de pantalla válidos:

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

• Busca todos los fotogramas en los que cambia la capa Taskbar color.a (alfa):

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

• Encuentra todos los fotogramas en los que el límite inferior de Wallpaper es menor o igual que 2400:

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

• Enumera todas las propiedades de las pantallas con una pila de capas válida:

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

• Encuentra todos los fotogramas en los que se ve el gesto de deslizar para volver.

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

Tablas de datos

Las vistas de SurfaceFlinger se crean con las siguientes tablas subyacentes.

surfaceflinger_layers_snapshot:

surfaceflinger_layer:

Vista de SQL de transacciones

Los datos de proto de transacciones usan el formato TransactionTraceEntry.

Para buscar datos de seguimiento de transacciones, usa la vista transactions_search. Esta vista incluye las siguientes columnas:

Ejemplos de búsquedas

• Busca el fotograma en el que se aplicó una transacción para cambiar la posición X de la capa a -54.0:

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

• Busca el fotograma en el que se agregó la capa ImeContainer:

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

Tablas de datos

La vista SQL de Transactions se crea con las siguientes tablas subyacentes.

surfaceflinger_transactions:

android_surfaceflinger_transaction:

android_surfaceflinger_transaction_flag:

Las transacciones individuales se agregan a la tabla de argumentos desde diferentes formatos de mensajes .proto según su tipo de transacción:

• LAYER_ADDED: Formato LayerCreationArgs
• LAYER_CHANGED: Formato LayerState
• DISPLAY_ADDED: Formato DisplayState
• DISPLAY_CHANGED: Formato DisplayState
• LAYER_DESTROYED: Sin argumentos
• LAYER_HANDLE_DESTROYED: Sin argumentos
• DISPLAY_REMOVED: Sin argumentos
• NOOP: Sin argumentos

Vista de SQL de Transitions

Los datos de proto de las transiciones usan el formato ShellTransition.

Para buscar datos de Transiciones, usa la vista transitions_search. Esta vista incluye las siguientes columnas:

Ejemplos de búsquedas

Encuentra propiedades de las transiciones controladas por el 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

Tablas de datos

La vista Transitions se crea con las siguientes tablas subyacentes.

window_manager_shell_transitions:

window_manager_shell_transition_handlers:

android_window_manager_shell_transition_participants:

Vista SQL de ViewCapture

Los datos de ViewCapture proto usan el formato View.

Para buscar datos de ViewCapture, usa la vista viewcapture_search. Esta vista incluye las siguientes columnas:

Ejemplos de búsquedas

Encuentra todos los estados cuando SearchContainerView se movió en la dirección Y:

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

Tablas de datos

La vista ViewCapture se crea con las siguientes tablas subyacentes.

android_viewcapture:

android_viewcapture_view:

Tabla de SQL de ProtoLog

Los datos de ProtoLog proto usan el formato ProtoLogMessage. Esta vista incluye las siguientes columnas:

Ejemplos de búsquedas

• Busca todos los registros con un mensaje que contenga transition:

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

• Busca todos los registros que contengan IDs de transacción válidos:

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

Ejecuta consultas

Puedes ejecutar búsquedas con el panel GLOBAL SEARCH que se encuentra a la izquierda del visor de Search.

Cuando interactúas por primera vez con el panel de BÚSQUEDA GLOBAL, se inicializa la búsqueda de registros y Winscope crea las vistas de SQL auxiliares. Este proceso tarda unos segundos. Mientras se inicializa la búsqueda de registros, la línea de tiempo no está disponible.

Para iniciar una búsqueda, escribe una consulta en el cuadro de búsqueda y haz clic en Ejecutar búsqueda o presiona Intro en el teclado para ejecutarla.

Cuando termines, la tabla de resultados se mostrará en el panel central. Tu búsqueda aparece debajo del cuadro de búsqueda, con un campo para guardar la búsqueda entre sesiones.

Para acceder a las consultas guardadas, haz clic en la pestaña Guardadas en el panel izquierdo. Para acceder a las consultas ejecutadas recientemente, haz clic en la pestaña Recientes:

Figura 2: Panel izquierdo del visor de búsqueda.

Resultados

Todas las consultas devuelven resultados tabulados, que se muestran en una vista desplazable con un comportamiento interactivo similar a los visores de registros basados en registros, como Transactions y ProtoLog:

Figura 3: Resultados del visor de búsqueda.

Si la tabla resultante contiene una columna ts, los valores de esa columna se interpretan como marcas de tiempo y se agregan a la superposición de la línea de tiempo como una nueva fila de entradas. Haz clic en esta fila y usa las teclas de flecha hacia la izquierda y la derecha para navegar entre las entradas:

Figura 4: Línea de tiempo de búsqueda.