使用 SQL 在 Winscope Perfetto 跟踪记录中查找特定状态。使用 Winscope 界面中的全局搜索查看器运行查询并直观呈现表格化结果:
图 1. 搜索查看器标签页
借助搜索查看器,您可以针对 Perfetto 跟踪记录编写和运行自定义 SQL 查询,并访问近期和已保存的查询。Winscope 提供了专用的 SQL 视图,以帮助搜索 SurfaceFlinger 和事务跟踪记录。
所有视图应遵守以下规则:
对于
property
和flat_property
列:- 属性名称采用蛇形命名法,例如
LayerProto
中的visible_region
。 点表示法用于表示嵌套属性,例如
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
) 表示。
- 布尔值由
SurfaceFlinger SQL 视图
SurfaceFlinger proto 数据使用以下格式:
图层数据采用
LayerProto
格式。层次结构根数据采用
LayersSnapshotProto
格式。
如需搜索图层数据,请使用 sf_layer_search
视图。此视图包含以下列:
列 | 说明 |
---|---|
state_id |
图层所属条目的唯一 ID |
ts |
图层所属条目的时间戳 |
layer_id |
图层 ID |
parent_id |
父级的图层 ID |
layer_name |
图层名称 |
property |
考虑重复字段的属性名称 |
flat_property |
属性名称不考虑重复字段 |
value |
以字符串格式显示的属性值 |
previous_value |
上一个条目的属性值(字符串格式) |
如需搜索层次结构根数据,请使用 sf_hierarchy_root_search
视图。此视图包含以下列:
列 | 说明 |
---|---|
state_id |
条目的唯一 ID |
ts |
条目的时间戳 |
property |
考虑重复字段的属性名称 |
flat_property |
属性名称不考虑重复字段 |
value |
以字符串格式显示的属性值 |
previous_value |
上一个条目的属性值(字符串格式) |
示例查询
查找
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
(alpha) 发生变化的所有帧: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, ']') ), '%' )
事务 SQL 视图
事务 proto 数据使用 TransactionTraceEntry
格式。
如需搜索事务数据,请使用 transactions_search
视图。此视图包含以下列:
列 | 说明 |
---|---|
state_id |
proto 属性所属条目的唯一 ID |
ts |
proto 属性所属条目的时间戳 |
transaction_id |
事务 ID(如有) |
property |
考虑重复字段的属性名称 |
flat_property |
属性名称不考虑重复字段 |
value |
以字符串格式显示的属性值 |
示例查询
找到应用了事务的帧,以将层 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 视图
过渡 proto 数据使用 ShellTransition
格式。
如需搜索过渡数据,请使用 transitions_search
视图。此视图包含以下列:
列 | 说明 |
---|---|
ts |
分派时间 - 如果有发送时间,则回退到发送时间,否则为 0 |
transition_id |
过渡 ID |
property |
考虑重复字段的属性名称 |
flat_property |
属性名称不考虑重复字段 |
value |
以字符串格式显示的属性值 |
示例查询
查找由 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
ViewCapture SQL 视图
ViewCapture proto 数据使用 View
格式。
如需搜索 ViewCapture 数据,请使用 viewcapture_search
视图。此视图包含以下列:
列 | 说明 |
---|---|
state_id |
视图所属状态的唯一 ID |
ts |
视图所属状态的时间戳 |
package_name |
软件包名称 |
window_name |
窗口名称 |
class_name |
查看类名称 |
property |
考虑重复字段的属性名称 |
flat_property |
属性名称不考虑重复字段 |
value |
以字符串格式显示的属性值 |
previous_value |
上一个状态的属性值(字符串格式) |
示例查询
查找 SearchContainerView
在 y 方向移动时的所有状态:
SELECT * FROM viewcapture_search
WHERE class_name LIKE '%SearchContainerView'
AND flat_property='translation_y'
AND value!=previous_value
ProtoLog SQL 表
ProtoLog proto 数据使用 ProtoLogMessage
格式。此视图包含以下列:
列 | 说明 |
---|---|
ts |
日志的时间戳 |
level |
日志级别 |
tag |
日志记录组标记 |
message |
日志消息 |
stacktrace |
堆栈轨迹(如果有) |
location |
消息的来源代码位置 |
示例查询
查找消息中包含
transition
的所有日志:SELECT ts, message, location FROM protolog WHERE message LIKE '%transition%'
查找包含有效事务 ID 的所有日志:
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, '%');
运行查询
使用左侧面板时,系统会开始搜索跟踪记录。此过程需要几秒钟的时间。在开始时,时间轴不可用。
开始跟踪记录搜索后,在搜索框中输入查询,然后点击 Run Search Query 或按键盘上的 Enter 以运行该查询。
完成后,结果表格会显示在中间面板中。您的查询会显示在搜索框下方,并带有一个在会话之间保存查询的字段。
您可以通过点击左侧面板中的 Saved 标签页来访问已保存的查询,也可以通过点击 Recent 标签页来访问最近运行的查询:
图 2. 搜索查看器左侧面板。
结果
所有查询都会返回表格式结果,并在可滚动视图中显示,其交互行为类似于基于日志的跟踪记录查看器(例如 Transactions 和 ProtoLog):
图 3. 搜索查看器结果。
如果生成的表格包含 ts
列,则该列中的值会被解释为时间戳,并作为新行条目添加到时间轴叠加层中。点击此行,然后使用向左和向右箭头键在条目之间导航:
图 4. 搜索时间轴。