EN

Android Perfetto 系列 17:专项场景自动化、问题清单与平台体系

字数统计: 11.5k阅读时长: 52 min
2026/05/04
loading

Camera 打开慢要区分 API 返回、HAL 首个 Buffer 和预览画面显示;Audio underrun 要看 App 写入与 mixer 周期是否稳定。这些事件分散在 App、系统服务、HAL 和调度轨道里,单列一张 Top slice 表还原不了顺序。

这里用 Camera 和 Audio 两个场景说明:先确认一次操作涉及哪些进程和线程,再按阶段或真实周期计算耗时,最后把异常时间点、来源轨道和质量限制写进报告。平台侧还要维护稳定的事件名和采集配置,下一次 Trace 才能复用查询。

版本说明(2026-10 核查):配置、SQL表与触发器按 Perfetto v58.3 核对。Android平台、设备producer与分析端版本分别记录。下文domain schema、事件名、角色、状态机和field限制是团队设计示例,不是Android自带接口或已实测的产品能力。

Perfetto 系列文章

  1. Android Perfetto 系列目录
  2. Android Perfetto 系列 1:Perfetto 工具简介
  3. Android Perfetto 系列 2:Perfetto Trace 抓取
  4. Android Perfetto 系列 3:熟悉 Perfetto View
  5. Android Perfetto 系列 4:使用命令行在本地打开超大 Trace
  6. Android Perfetto 系列 5:Android App 基于 Choreographer 的渲染流程
  7. Android Perfetto 系列 6:为什么是 120Hz?高刷新率的优势与挑战
  8. Android Perfetto 系列 7:MainThread 和 RenderThread 解读
  9. Android Perfetto 系列 8:深入理解 Vsync 机制与性能分析
  10. Android Perfetto 系列 9:CPU 信息解读
  11. Android Perfetto 系列 10:Binder 调度与锁竞争
  12. Android Perfetto 系列 11:PerfettoSQL、Trace Processor 与回归检测
  13. Android Perfetto 系列 12:Trace 数据流与丢失排查
  14. Android Perfetto 系列 13:Perfetto SDK、Track Event 与 App 现场 Trace
  15. Android Perfetto 系列 14:heapprofd 与内存 Profiling
  16. Android Perfetto 系列 15:Boot Trace、长时间现场 Trace 与偶发问题抓取
  17. Android Perfetto 系列 16:GPU、Power Counters 与硬件瓶颈分析
  18. Android Perfetto 系列 17:专项场景自动化、问题清单与平台体系
  19. Android Perfetto 系列 18:响应速度实战,从输入事件到首帧反馈
  20. 视频(B站) - Android Perfetto 基础和案例分享
  21. 视频(B站) - Android Perfetto 分享 - 出图类型分享:AOSP、WebView、Flutter + OEM 系统优化分享

自动化分析首先要认得领域对象。相同的 Running 或 Binder 等待,在 Camera open 与 Audio 播放里属于不同阶段;对象归属错了,SQL 汇总再准确也会误导报告。

专项分析保留对象与复查点

示意图:Camera 按同次操作拆阶段,Audio 按真实循环量周期;报告保留回到 UI 的时间点。

领域分析从对象字典开始

Camera 和 Audio 的难点不在“有没有 camera/audio 这个 category”,而在 Trace 里到底有哪些对象:

领域 对象 为什么要识别
Camera App client、cameraserver、provider、HAL、request/session id open、configure、preview、capture 可能分散在不同进程
Audio App audio thread、audioserver、MixerThread、FastMixer、audio HAL、Bluetooth/audio route underrun 往往来自周期抖动、写入不稳、HAL 阻塞或调度延迟

自动化分析的第一步是生成对象字典:相关进程、线程、track、slice 名称、log tag、request/session id。后面的 SQL 不直接猜根因,只围绕这个字典计算阶段耗时和阻塞证据。

对象字典建议由脚本输出,而不是一组只存在于人脑里的关键词。一次 Camera case 里可能同时出现 App 进程、cameraserver、provider@2.7-service、vendor camera daemon、codec、SurfaceFlinger;一次 Audio case 里可能同时出现 App、audioserver、audio.primary、Bluetooth、media codec。

确认后的对象字典先长这样,SQL 只是生成和验证它的一种方式:

这是假设已复查的记录,不是本次采集结果。upid/utid/track_id 只在同一份Trace内有效,归档时同时保存Trace hash、machine/boot、schema与SQL版本。confidence 没有校准模型时留null,不把关键词匹配写成概率;包名、SELinux域、厂商归属也需各自来源。旧HIDL provider名称只是例子:Camera从Android13支持AIDL HAL,Audio从Android14发展AIDL接口;实际服务名/transport应查设备,不能从系统版本或进程后缀推断。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
object_dictionary_version: camera_audio_v1
objects:
- role: camera_app_client
object_type: track
process_name: com.example.app
thread_name: main
upid: 42
utid: 51
track_id: 102
uid: 10123
package_name: com.example.app
service_instance: ""
hal_transport: ""
selinux_context_or_domain: null
vendor_owner: app-team
source_signal: track_event
confidence: null
owner_confirmed: true
- role: camera_service
object_type: process
process_name: cameraserver
vendor_owner: platform-camera
source_signal: atrace
confidence: null
owner_confirmed: true

领域 schema 是 App、平台、SQL 和报告之间的协作接口。它要版本化,而不是散在文章、脚本和口头约定里:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
schema_version: camera_domain_v1
domain: camera
scenario: camera_open_preview
owner_team: platform-camera
privacy_level: system-metadata-and-app-markers
object_roles:
- camera_app_client
- camera_service
- camera_provider
- camera_hal
- display_service
stable_events:
- event_name: Camera#OpenStart
owner: app
required_args: [client_instance_id, camera_id, session_id, operation_id, event_id]
- event_name: Camera#ConfigureStreamsStart
owner: platform
required_args: [client_instance_id, camera_id, session_id, operation_id, stream_id]
- event_name: Camera#FirstPreviewFrame
owner: platform
required_args: [client_instance_id, camera_id, session_id, operation_id, stream_id, surface_id]
- event_name: Camera#Opened
owner: app
required_args: [client_instance_id, camera_id, session_id, operation_id, result]
- event_name: Camera#OpenEnd
owner: app
required_args: [client_instance_id, camera_id, session_id, operation_id, event_id, result]
- event_name: Camera#ConfigureStreamsEnd
owner: platform
required_args: [client_instance_id, camera_id, session_id, operation_id, stream_id, result]
- event_name: Camera#FirstHalBuffer
owner: platform
required_args: [client_instance_id, camera_id, session_id, operation_id, stream_id]
stage_definitions:
- stage_name: open_api
start_event: Camera#OpenStart
end_event: Camera#OpenEnd
- stage_name: camera_open_callback
start_event: Camera#OpenStart
end_event: Camera#Opened
- stage_name: first_preview_marker
start_event: Camera#OpenStart
end_event: Camera#FirstPreviewFrame
report_fields:
- stage_name
- status
- start_ts
- end_ts
- dur_ms
- start_slice_id
- end_slice_id
- evidence_slice
- review_ts
- source_role

脚本先把候选对象列出来,领域负责人再确认哪些对象属于本次场景。确认结果不能只停在人脑里,要写成 domain_objects 表或同结构的 YAML/JSON,后续查询只 JOIN 这张字典。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
CREATE TABLE domain_objects AS
SELECT
'candidate' AS role,
'track' AS object_type,
p.name AS process_name,
p.upid,
p.machine_id,
p.pid,
NULL AS uid,
NULL AS package_name,
th.name AS thread_name,
th.utid,
th.tid,
tt.id AS track_id,
NULL AS log_tag,
NULL AS request_id_key,
NULL AS session_id_key,
NULL AS service_instance,
NULL AS hal_transport,
NULL AS selinux_context_or_domain,
NULL AS source_signal,
NULL AS vendor_alias,
NULL AS vendor_owner,
NULL AS confidence,
0 AS owner_confirmed
FROM thread th
LEFT JOIN process p USING (upid)
JOIN thread_track tt USING (utid)
WHERE LOWER(p.name) LIKE '%camera%'
OR LOWER(p.name) LIKE '%audio%'
OR LOWER(p.name) LIKE '%media%'
OR p.name IN ('com.example.app', 'cameraserver', 'audioserver',
'surfaceflinger', '/system/bin/surfaceflinger');

注意这里用的是普通 SQLite CREATE TABLE,而不是 CREATE PERFETTO TABLE:后者创建出来的表是只读的,无法再用 UPDATE 写回人工确认结果。这张表的字段至少要覆盖 role、进程/线程、track_id、厂商别名、置信度和人工确认状态。第一版仍然可以靠关键词生成,但报告只能使用 owner_confirmed = 1 的对象。否则 vendor HAL、provider、codec、Bluetooth route 一漂移,自动化还是会退回模糊匹配。

候选对象可以这样列给领域负责人复查:

1
2
3
4
5
6
7
8
9
10
SELECT DISTINCT
role, object_type, machine_id, upid, utid, track_id,
process_name,
pid,
thread_name,
tid,
confidence,
owner_confirmed
FROM domain_objects
ORDER BY process_name, thread_name;

这一步的输出要人工看一眼。自动化可以缩小范围,但不能凭 LIKE 把 provider、HAL、codec、Bluetooth route 的归属全判准。

确认后的对象要写回同一张表或归档为YAML/JSON。下面只确认复查过的具体 track_id;NULL必须替换,留空不会更新。先确认 upid/utid 与轨道归属,再逐条填写,避免按整个进程批量确认无关线程。Audio另行确认自己的角色。

1
2
3
4
5
6
7
8
9
10
11
WITH confirmed(track_id, role) AS (
VALUES (NULL, 'camera_app_client'),
(NULL, 'camera_service'),
(NULL, 'camera_provider')
)
UPDATE domain_objects
SET owner_confirmed = 1,
role = (SELECT role FROM confirmed c WHERE c.track_id = domain_objects.track_id)
WHERE track_id IN (SELECT track_id FROM confirmed WHERE track_id IS NOT NULL)
AND (SELECT COUNT(*) FROM confirmed c
WHERE c.track_id = domain_objects.track_id) = 1;

后续 SQL 只使用 owner_confirmed = 1 的对象。候选表缩小复查范围,确认表保留对象归属。固定 role enum 包括:camera_app_client、camera_service、camera_provider、camera_hal、display_service、audio_app、audio_server、audio_mixer、audio_hal、bluetooth_audio。

候选查询只扫描线程轨道,关键词也不保证找全。进程级、异步或自定义Track需要另行加入并验证归属,不能凭同名自动继承确认。下文slice查询采用精确track匹配;调度统计则将已确认轨道映射成去重utid。请在同一个Trace Processor实例中顺序建表、确认、查询;重建表会丢失确认结果,应先归档。

配置从领域 preset 开始

权限边界要先写清:

能力 谁能做 说明
App marker / metadata 普通 App android.os.Trace、NDK ATrace、Track Event、业务元数据
已登记 trigger 普通 App 或测试 harness 只能激活平台预先声明的 trigger 名称
App profiling shell + profileable 或 debuggable release 性能对比优先 profileable,debuggable 只用于调试
ftrace/process stats/FrameTimeline/system log shell、Traceur、平台/OEM 受信 consumer 受 SELinux 和 build 类型限制,普通App不能提交任意系统配置
上传、限频、隐私、preset 选择 平台/OEM 诊断流程 必须有授权、脱敏、保留周期和审计

下面这份是 lab_domain_debug 配置,不是低开销 field preset。它保留 sched/freq/idle、Camera/Audio/hal/binder atrace、FrameTimeline、process stats 和 log,用于研发设备、userdebug 或实验室复现。field 版本应减到必要数据源,log、binder_lock、高频领域事件只在专项短 Trace 打开。

按设备实际Android/Perfetto版本确认配置。Android12及以上优先将配置放在 /data/misc/perfetto-configs;shell重定向stdin与让perfetto直接打开文件是两条权限路径,不能混用结论。Camera可见首帧还需目标layer/present证据;FrameTimeline不覆盖所有预览路径,Camera/HAL事件只能证明相应阶段。128MiB central buffer是实验起点且已占默认extra guardrails总额,需实测写入率和窗口覆盖;这里不写入周期文件,flush_period_ms 表示producer flush请求,不是每10秒保存文件。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
duration_ms: 30000
flush_period_ms: 10000

buffers {
size_kb: 131072
fill_policy: RING_BUFFER
}

data_sources {
config {
name: "linux.ftrace"
ftrace_config {
compact_sched { enabled: true }
ftrace_events: "sched/sched_switch"
ftrace_events: "sched/sched_waking"
ftrace_events: "power/cpu_frequency"
ftrace_events: "power/cpu_idle"
atrace_categories: "camera"
atrace_categories: "audio"
atrace_categories: "gfx"
atrace_categories: "view"
atrace_categories: "hal"
atrace_categories: "binder_driver"
atrace_categories: "binder_lock"
atrace_categories: "am"
atrace_categories: "wm"
atrace_categories: "input"
# category/event 以目标设备 Record 页或 --query 输出为准。
atrace_apps: "<target_package>"
}
}
}

data_sources {
config {
name: "android.surfaceflinger.frametimeline"
}
}

data_sources {
config {
name: "linux.process_stats"
process_stats_config {
scan_all_processes_on_start: true
proc_stats_poll_ms: 5000
}
}
}

data_sources {
config {
name: "track_event"
track_event_config {
disabled_categories: "*"
enabled_categories: "camera"
enabled_categories: "audio"
}
}
# 替换为设备上实际注册的 App/平台 producer 名;需要时重复添加。
producer_name_filter: "<confirmed_producer_name>"
}

data_sources {
config {
name: "android.log"
android_log_config {
log_ids: LID_DEFAULT
log_ids: LID_SYSTEM
log_ids: LID_EVENTS
log_ids: LID_CRASH
filter_tags: "CameraService"
filter_tags: "CameraProvider"
filter_tags: "AudioFlinger"
filter_tags: "AudioTrack"
filter_tags: "AudioPolicyManager"
}
}
}

atrace_categories 打开的是 Android 系统 category,不会自动打开 App 里的 android.os.Trace 或 NDK ATrace;App 侧 ATrace 共享 ATRACE_TAG_APP,需要按包名配置 atrace_apps,没有独立 category 过滤。需要参数和跨线程关联时,改用第 13 篇的 Perfetto SDK Track Event。

user build上的release App可通过 <profileable android:shell="true" /> 向支持的shell profiling工具开放;debuggable会改变运行特征。不要把CPU/native profiling一概限定为userdebug:可采范围还取决于工具、App资格、堆类型及平台策略。系统服务、HAL、kernel stacks和其他进程另查权限。Android15/API35的 ProfilingManager 允许App请求受系统控制的profiling,包括system trace;这不授予任意TraceConfig、consumer socket或其他App原始数据的访问权。

官方文档将 android.log 支持范围写为 userdebug;已 root 且 logd/SELinux 权限允许的 user 构建也可能采到,但这不是仅靠 adb root 就能保证的通用能力。普通 user build 或线上场景不要假设日志一定在 Trace 里,外部 logcat、bugreport 或平台侧脱敏日志应放进同一个 case 包。现场包只保留白名单 tag 和窗口摘要,原始 log 要走授权和脱敏。

category 名称也要以目标系统为准。Perfetto 文档把 ATrace 分成 system category 和 per-app events,系统 category 来自 Android 内部进程;App event 共享 ATRACE_TAG_APP,需要按包名启用。写 preset 时不要只复制别人机器上的 category 列表,最好在 Perfetto UI 的 Record 页面或设备侧配置里确认当前版本支持什么。

buffers.size_kb 是 Perfetto central buffer,不等于 ftrace per-CPU kernel ring buffer。sched/ftrace 丢失要看 stats 里的 ftrace overrun/dropped/data_loss;必要时才调 ftrace_config.buffer_size_kb、drain_period_ms 这类参数,并先在短 Trace 验证设备兼容性和开销。新增 vendor kernel tracepoint 要先确认 /sys/kernel/tracing/events/*/*/format、字段稳定性和 Perfetto parser/stdlib 支持;否则只能作为 raw ftrace 候选证据,或需要改 Perfetto parser / 自定义 data source。

质量门禁不要只写一个抽象分数。至少固定跑这条 SQL:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
SELECT name, idx, severity, source, value
FROM stats
WHERE value != 0
AND (
severity IN ('error', 'data_loss')
OR name IN (
'ftrace_setup_errors',
'ftrace_cpu_has_data_loss',
'traced_buf_trace_writer_packet_loss',
'traced_buf_chunks_overwritten',
'traced_buf_chunks_discarded',
'traced_buf_patches_failed',
'traced_flushes_failed',
'traced_final_flush_failed',
'track_event_parser_errors',
'track_event_tokenizer_errors',
'track_event_thread_invalid_end',
'graphics_frame_event_parser_errors',
'systrace_parse_failure',
'clock_sync_failure',
'invalid_clock_snapshots'
)
OR name GLOB 'ftrace_cpu_*overrun*'
OR name GLOB 'ftrace_cpu_*dropped*'
OR name GLOB 'traced_buf_*packet_loss'
)
ORDER BY name, idx;

idx 随统计项变化:traced_buf_* 一般是 buffer 下标,ftrace CPU 项是 CPU 编号,其他项要查定义。报告要按 affected_signal 分组:ftrace/sched、atrace/systrace、track_event、FrameTimeline、android.log、clock、central_buffer。RING_BUFFER 下的 overwritten 要单独解释:它可能只是窗口外旧数据被覆盖,也可能说明问题前证据不够长。报告要把 data loss、packet loss、overwrite 分开降级。

该SQL是异常清单,不是完整性证明。还要查配置/启动错误的详细metadata、目标对象事件、问题窗覆盖、时钟与解析器兼容性;空结果不能填 data_quality=clean。v58.3的setup类统计可能是info,显式名单仍需保留。buffer或整Trace级统计无法自动定位到某条HAL事件,未知影响范围单独记录。filter_tags 只限制日志tag,不过滤消息内的用户内容,外部日志还需对齐时钟。

Camera 看阶段

Camera open 慢不能只写“camera 慢”。这里我更在意一次操作的阶段顺序:API 什么时候返回、HAL 什么时候给出 Buffer、预览画面什么时候真的显示。至少拆成这些阶段:

阶段 owner 关注点
App 发起 open App marker 用户操作、权限、UI thread 是否等待
App 到 cameraserver App + camera service Binder 往返、服务端线程池是否拥塞
cameraserver 到 provider/HAL platform event provider 进程、HAL 线程、设备等待
configure streams platform/HAL event stream 数量、分辨率、Surface、HAL configure 耗时
first HAL buffer HAL/provider event request 提交、buffer 从 HAL 返回
first presented frame SurfaceFlinger layer/present 证据 + App marker;适用时再用 FrameTimeline buffer 进入 SurfaceFlinger 后是否真正呈现;SurfaceView 预览不能只靠 FrameTimeline
capture/result platform/HAL event request id、result callback、buffer/metadata 返回

这里有三个不同口径:API 调用返回、第一帧从 HAL 返回、第一帧被用户看到。前两个偏 Camera framework / HAL,第三个还要经过 BufferQueue 和 SurfaceFlinger;FrameTimeline 是否可用取决于目标预览类型。报告里要写清你量的是哪一个,不然“open 变快了”可能只是 API 更早返回,预览首帧并没有提前。

Camera2还有一个必须单列的终点:CameraManager.openCamera() 返回只表示本次调用结束,成功打开通过 CameraDevice.StateCallback.onOpened() 通知,随后还需创建session与提交请求。下文 open_api 只量调用段;新增 camera_open_callback 从OpenStart量到Opened,包含回调派发等待,不能当成纯HAL耗时。成功、异常、断开分别记录;FirstHalBuffer也不等于capture result metadata回调或屏幕显示。

专项 SQL 必须绑定问题窗口。这个窗口可以来自 trigger metadata、业务 marker、用户复现步骤,或者人工在 UI 中选出的区间。缺 owner 事件时,报告写 missing_owner_event 或 stage_unavailable,不要把 LIKE 查询升级成阶段结论。

1
2
3
4
5
6
7
WITH target_window(start_ts, end_ts) AS (
VALUES (NULL, NULL)
)
SELECT start_ts, end_ts, (end_ts - start_ts) / 1e9 AS duration_s
FROM target_window
WHERE typeof(start_ts) = 'integer' AND typeof(end_ts) = 'integer'
AND end_ts > start_ts;

稳定事件存在时,先限定同一client实例的一次操作,跨进程传播 client_instance_id/camera_id/session_id/operation_id,目标stream与surface另行匹配。以下SQL只支持直接按schema写入的零时长Track Event markers,或事先保留原始ID的等价归一化事件;ATrace async slice不能直接冒充这类marker。NULL参数需替换为整数ns与已确认ID,窗口使用半开区间且覆盖完整操作。缺事件、重复、时间倒置或显式非success时不输出成功阶段耗时;原始slice/track/args仍可复查。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
WITH target_window(start_ts, end_ts) AS (
VALUES (NULL, NULL)
),
target_operation(client_instance_id, camera_id, session_id, operation_id, stream_id, surface_id) AS (
VALUES (NULL, NULL, NULL, NULL, NULL, NULL)
),
events AS (
SELECT s.id, s.track_id, s.name, s.ts,
EXTRACT_ARG(s.arg_set_id, 'debug.result') AS result
FROM slice s
CROSS JOIN target_window w
CROSS JOIN target_operation o
WHERE typeof(w.start_ts) = 'integer' AND typeof(w.end_ts) = 'integer'
AND w.end_ts > w.start_ts AND s.ts >= w.start_ts AND s.ts < w.end_ts
AND s.dur = 0
AND CAST(EXTRACT_ARG(s.arg_set_id, 'debug.client_instance_id') AS TEXT) = o.client_instance_id
AND CAST(EXTRACT_ARG(s.arg_set_id, 'debug.camera_id') AS TEXT) = o.camera_id
AND CAST(EXTRACT_ARG(s.arg_set_id, 'debug.session_id') AS TEXT) = o.session_id
AND CAST(EXTRACT_ARG(s.arg_set_id, 'debug.operation_id') AS TEXT) = o.operation_id
AND (s.name IN ('Camera#OpenStart', 'Camera#OpenEnd', 'Camera#Opened')
OR CAST(EXTRACT_ARG(s.arg_set_id, 'debug.stream_id') AS TEXT) = o.stream_id)
AND (s.name != 'Camera#FirstPreviewFrame'
OR CAST(EXTRACT_ARG(s.arg_set_id, 'debug.surface_id') AS TEXT) = o.surface_id)
AND EXISTS (
SELECT 1 FROM domain_objects d
WHERE d.owner_confirmed = 1 AND d.track_id = s.track_id
AND d.role IN ('camera_app_client', 'camera_service', 'camera_provider',
'camera_hal', 'display_service')
)
),
stage_pairs(stage_name, start_name, end_name, require_success) AS (
VALUES
('open_api', 'Camera#OpenStart', 'Camera#OpenEnd', 1),
('camera_open_callback', 'Camera#OpenStart', 'Camera#Opened', 1),
('configure_streams', 'Camera#ConfigureStreamsStart', 'Camera#ConfigureStreamsEnd', 1),
('first_hal_buffer', 'Camera#OpenStart', 'Camera#FirstHalBuffer', 0),
('first_preview_marker', 'Camera#OpenStart', 'Camera#FirstPreviewFrame', 0)
),
stages AS (
SELECT p.stage_name, p.require_success,
COUNT(CASE WHEN e.name = p.start_name THEN 1 END) AS start_count,
COUNT(CASE WHEN e.name = p.end_name THEN 1 END) AS end_count,
GROUP_CONCAT(e.id) AS candidate_slice_ids,
MAX(CASE WHEN e.name = p.start_name THEN e.id END) AS start_slice_id,
MAX(CASE WHEN e.name = p.end_name THEN e.id END) AS end_slice_id,
MAX(CASE WHEN e.name = p.start_name THEN e.ts END) AS start_ts,
MAX(CASE WHEN e.name = p.end_name THEN e.ts END) AS end_ts,
MAX(CASE WHEN e.name = p.end_name THEN e.result END) AS end_result
FROM stage_pairs p
LEFT JOIN events e ON e.name IN (p.start_name, p.end_name)
GROUP BY p.stage_name, p.require_success
),
classified AS (
SELECT *, CASE
WHEN NOT EXISTS (SELECT 1 FROM target_window w, target_operation o
WHERE typeof(w.start_ts) = 'integer' AND typeof(w.end_ts) = 'integer'
AND w.end_ts > w.start_ts AND o.client_instance_id IS NOT NULL
AND o.camera_id IS NOT NULL AND o.session_id IS NOT NULL
AND o.operation_id IS NOT NULL AND o.stream_id IS NOT NULL
AND o.surface_id IS NOT NULL) THEN 'invalid_selection'
WHEN start_count = 0 OR end_count = 0 THEN 'stage_unavailable'
WHEN start_count != 1 OR end_count != 1 OR end_ts < start_ts THEN 'ambiguous_or_invalid'
WHEN require_success = 1 AND end_result IS NULL THEN 'missing_result'
WHEN require_success = 1 AND end_result != 'success' THEN 'non_success'
ELSE 'marker_measured' END AS status
FROM stages
)
SELECT stage_name, status, start_count, end_count, candidate_slice_ids,
CASE WHEN start_count = 1 THEN start_slice_id END AS start_slice_id,
CASE WHEN end_count = 1 THEN end_slice_id END AS end_slice_id,
CASE WHEN start_count = 1 THEN start_ts END AS start_ts,
CASE WHEN end_count = 1 THEN end_ts END AS end_ts,
CASE WHEN status = 'marker_measured' THEN (end_ts - start_ts) / 1e6 END AS dur_ms
FROM classified;

如果稳定事件还没补齐,再退回候选 slice 查询。这个查询只用于建立候选阶段,重点看 process_name、thread_name、slice_name 和 dur_ms,不能直接替代上面的阶段口径:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
WITH target_window(start_ts, end_ts) AS (
VALUES (NULL, NULL)
)
SELECT s.id AS slice_id, s.track_id, s.ts, s.dur,
CASE WHEN s.dur >= 0 THEN s.dur / 1e6 END AS dur_ms,
CASE WHEN s.dur >= 0 THEN MAX(0, MIN(s.ts + s.dur, w.end_ts) - MAX(s.ts, w.start_ts)) END AS overlap_ns,
CASE WHEN s.dur = -1 THEN 'unclosed_candidate' ELSE 'observed' END AS status,
s.name AS slice_name, th.name AS thread_name, p.name AS process_name,
th.utid, th.tid, p.upid, p.pid, p.machine_id
FROM slice s
JOIN thread_track tt ON s.track_id = tt.id
JOIN thread th USING (utid)
LEFT JOIN process p USING (upid)
CROSS JOIN target_window w
WHERE typeof(w.start_ts) = 'integer' AND typeof(w.end_ts) = 'integer'
AND w.end_ts > w.start_ts
AND EXISTS (
SELECT 1 FROM domain_objects d
WHERE d.track_id = s.track_id AND d.owner_confirmed = 1
AND d.role IN ('camera_app_client', 'camera_service', 'camera_provider', 'camera_hal')
)
AND ((s.dur > 0 AND s.ts < w.end_ts AND s.ts + s.dur > w.start_ts)
OR (s.dur = 0 AND s.ts >= w.start_ts AND s.ts < w.end_ts)
OR (s.dur = -1 AND s.ts < w.end_ts))
ORDER BY s.dur DESC
LIMIT 100;

如果这条查不到足够的阶段信息,通常有两种处理:补 android.os.Trace / ATRACE / Track Event,或者让平台侧在 CameraService、provider、HAL 关键阶段补稳定事件名。事件参数里要校验 camera_id/session_id/request_id;用 Track Event 时从 args/debug annotation 或 flow id 取,不要只靠事件名。

候选SQL保留原始ns、slice/track/upid/utid以及窗口重叠时长。零时长marker按落点选入,dur=-1保留为未闭合候选且不计算耗时;其他非法负值需单独排查。TopN只是可读截断,不代表完整阶段覆盖。

Audio 看周期

Audio 问题比 Camera 更强调周期性。一次长 slice 不一定导致听感问题,连续几个 mixer 周期抖动、App 写入间隔不稳、HAL 写入阻塞,才更接近 underrun 或断续。

Audio 报告优先看的是:周期尾部是否变长,连续异常是否出现,异常是否和 underrun log、route change 或听感时间点重合。Top slice 只作为辅助线索。

Audio 候选 slice 也要绑定问题窗口,并优先使用 domain_objects,避免整段 trace 的历史噪声混进来:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
WITH target_window(start_ts, end_ts) AS (
VALUES (NULL, NULL)
)
SELECT s.id AS slice_id, s.track_id, s.ts, s.dur,
CASE WHEN s.dur >= 0 THEN s.dur / 1e6 END AS dur_ms,
CASE WHEN s.dur >= 0 THEN MAX(0, MIN(s.ts + s.dur, w.end_ts) - MAX(s.ts, w.start_ts)) END AS overlap_ns,
CASE WHEN s.dur = -1 THEN 'unclosed_candidate' ELSE 'observed' END AS status,
s.name AS slice_name, th.name AS thread_name, p.name AS process_name,
th.utid, th.tid, p.upid, p.pid, p.machine_id
FROM slice s
JOIN thread_track tt ON s.track_id = tt.id
JOIN thread th USING (utid)
LEFT JOIN process p USING (upid)
CROSS JOIN target_window w
WHERE typeof(w.start_ts) = 'integer' AND typeof(w.end_ts) = 'integer'
AND w.end_ts > w.start_ts
AND EXISTS (
SELECT 1 FROM domain_objects d
WHERE d.track_id = s.track_id AND d.owner_confirmed = 1
AND d.role IN ('audio_app', 'audio_server', 'audio_mixer', 'audio_hal', 'bluetooth_audio')
)
AND ((s.dur > 0 AND s.ts < w.end_ts AND s.ts + s.dur > w.start_ts)
OR (s.dur = 0 AND s.ts >= w.start_ts AND s.ts < w.end_ts)
OR (s.dur = -1 AND s.ts < w.end_ts))
ORDER BY s.ts, s.id
LIMIT 200;

再看已确认audio_mixer线程的调度区间。一次工作循环可能被抢占成多段sched,所以相邻Running起点差不是mixer周期。下文保utid/upid/ucpu与原始ns,只在问题窗内相邻已完成记录间算gap;窗口尾部没有下一条就留空。还需结合thread_state、HAL、underrun和route,缺失sched时不能把两条幸存记录间隔当完整调度历史。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
WITH target_window(start_ts, end_ts) AS (
VALUES (NULL, NULL)
),
mixer_runs AS (
SELECT ss.id, ss.utid, th.upid, ss.ucpu, ss.ts, ss.dur,
th.name AS thread_name,
LEAD(ss.ts) OVER (PARTITION BY ss.utid ORDER BY ss.ts, ss.id) AS next_ts
FROM sched ss
JOIN thread th USING (utid)
CROSS JOIN target_window w
WHERE typeof(w.start_ts) = 'integer' AND typeof(w.end_ts) = 'integer'
AND w.end_ts > w.start_ts AND ss.dur > 0
AND ss.ts < w.end_ts AND ss.ts + ss.dur > w.start_ts
AND EXISTS (SELECT 1 FROM domain_objects d
WHERE d.utid = ss.utid AND d.owner_confirmed = 1 AND d.role = 'audio_mixer')
)
SELECT id AS sched_id, utid, upid, ucpu, ts, dur, next_ts, thread_name,
dur / 1e6 AS full_running_ms,
CASE WHEN next_ts >= ts + dur THEN (next_ts - ts) / 1e6 END AS sched_start_interval_ms,
CASE WHEN next_ts >= ts + dur THEN (next_ts - (ts + dur)) / 1e6 END AS off_cpu_gap_ms
FROM mixer_runs
ORDER BY utid, ts, id;

sched_start_interval_ms 和 off_cpu_gap_ms 只描述调度。要量 mixer 周期,应使用已确认“一次循环一个”的业务/平台 slice,例如下文约定的 AudioFlinger#MixerCycle,限定同一track和route generation后按时间算相邻slice起点差;不能把任意调度切换与音频 buffer deadline 比较。

确认已经补齐或映射 AudioFlinger#MixerCycle 后,可以计算实际循环起点间隔:

这里额外约定每次有效循环提供整数 cycle_seq 和 route_generation:切路由、停播再启动、mixer重新配置均换generation;序号不连续或时间戳重复时留空。选择一个已确认track与generation,按时间输出以保连续异常顺序。没有这些字段时只能给候选间隔,不能声称完整周期;周期slice的dur是墙钟跨度,含可能的等待,并非CPU Running时间。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
WITH target(start_ts, end_ts, track_id, route_generation) AS (
VALUES (NULL, NULL, NULL, NULL)
),
raw_cycles AS (
SELECT s.id, s.track_id, s.ts, s.dur, tt.utid,
EXTRACT_ARG(s.arg_set_id, 'debug.cycle_seq') AS cycle_seq
FROM slice s
JOIN thread_track tt ON s.track_id = tt.id
CROSS JOIN target w
WHERE typeof(w.start_ts) = 'integer' AND typeof(w.end_ts) = 'integer'
AND w.end_ts > w.start_ts AND s.ts >= w.start_ts AND s.ts < w.end_ts
AND s.track_id = w.track_id AND s.name = 'AudioFlinger#MixerCycle'
AND CAST(EXTRACT_ARG(s.arg_set_id, 'debug.route_generation') AS TEXT) = w.route_generation
AND EXISTS (SELECT 1 FROM domain_objects d
WHERE d.track_id = s.track_id AND d.owner_confirmed = 1 AND d.role = 'audio_mixer')
),
cycles AS (
SELECT *, COUNT(*) OVER (PARTITION BY track_id, ts) AS timestamp_rows,
COUNT(*) OVER (PARTITION BY track_id, cycle_seq) AS sequence_rows
FROM raw_cycles
),
pairs AS (
SELECT *, LEAD(ts) OVER win AS next_ts, LEAD(cycle_seq) OVER win AS next_seq,
LEAD(timestamp_rows) OVER win AS next_timestamp_rows,
LEAD(sequence_rows) OVER win AS next_sequence_rows
FROM cycles
WINDOW win AS (PARTITION BY track_id ORDER BY ts, id)
)
SELECT track_id, utid, id AS slice_id, ts, dur, cycle_seq, next_ts,
CASE WHEN dur >= 0 THEN dur / 1e6 END AS cycle_wall_ms,
CASE WHEN timestamp_rows = 1 AND next_timestamp_rows = 1
AND sequence_rows = 1 AND next_sequence_rows = 1
AND typeof(cycle_seq) = 'integer' AND typeof(next_seq) = 'integer'
AND next_seq = cycle_seq + 1 AND next_ts > ts AND dur >= 0 AND ts + dur <= next_ts
THEN (next_ts - ts) / 1e6 END AS mixer_cycle_period_ms
FROM pairs
ORDER BY track_id, ts, id;

不要给 period_ms 写一个跨设备固定阈值。它和 sample rate、buffer size、fast path、Bluetooth route、offload、AAudio/OpenSL ES/AudioTrack 使用方式都有关系。更稳的做法是:同一设备同一 route 下拿一段干净播放作为基线,再比较异常现场里周期尾部是否变长、是否连续变长、是否和 underrun log 或听感时间点重合。

Running 和 Runnable 分开算

很多专项报告会把线程状态混在一起写。Running/Runnable 的状态定义、R+ 的含义和调度证据的前置条件(sched 数据齐全、stats 无 ftrace loss),第 09 篇和第 11 篇已经展开过,这里不重复。专项分析的差别只有一个:统计对象来自 domain_objects 字典里 owner_confirmed = 1 的线程,而不是靠线程名去猜。

这条 SQL 对问题窗口内的领域线程同时输出 Running 和 Runnable:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
WITH target_window(start_ts, end_ts) AS (
VALUES (NULL, NULL)
),
domain_threads AS (
SELECT th.utid, th.name AS thread_name, p.name AS process_name, p.upid, p.machine_id
FROM thread th LEFT JOIN process p USING (upid)
WHERE EXISTS (SELECT 1 FROM domain_objects d
WHERE d.utid = th.utid AND d.owner_confirmed = 1)
),
state_totals AS (
SELECT s.utid,
SUM(MIN(s.ts + s.dur, w.end_ts) - MAX(s.ts, w.start_ts)) AS covered_ns,
SUM(CASE WHEN s.state = 'Running'
THEN MIN(s.ts + s.dur, w.end_ts) - MAX(s.ts, w.start_ts) ELSE 0 END) AS running_ns,
SUM(CASE WHEN s.state IN ('R', 'R+')
THEN MIN(s.ts + s.dur, w.end_ts) - MAX(s.ts, w.start_ts) ELSE 0 END) AS runnable_ns
FROM thread_state s
CROSS JOIN target_window w
WHERE typeof(w.start_ts) = 'integer' AND typeof(w.end_ts) = 'integer'
AND w.end_ts > w.start_ts AND s.dur > 0 AND s.ts < w.end_ts AND s.ts + s.dur > w.start_ts
GROUP BY s.utid
)
SELECT
t.utid, t.upid, t.machine_id, w.start_ts, w.end_ts, s.covered_ns, t.process_name, t.thread_name,
CASE WHEN typeof(w.start_ts) != 'integer' OR typeof(w.end_ts) != 'integer'
OR w.end_ts <= w.start_ts THEN 'invalid_window'
WHEN s.covered_ns = w.end_ts - w.start_ts THEN 'full'
WHEN s.covered_ns IS NULL THEN 'missing' ELSE 'partial' END AS sched_coverage,
CASE WHEN s.covered_ns = w.end_ts - w.start_ts THEN s.running_ns / 1e6 END AS running_ms,
CASE WHEN s.covered_ns = w.end_ts - w.start_ts THEN s.runnable_ns / 1e6 END AS runnable_ms
FROM domain_threads t
CROSS JOIN target_window w
LEFT JOIN state_totals s USING (utid)
ORDER BY runnable_ms DESC, running_ms DESC;

这里用 thread_state 的 Running/Runnable 状态统一统计,缺记录或只覆盖部分窗口时耗时留空。full 也只表示区间覆盖,不能替代 stats 检查;线程只在窗口的一部分存活时,应缩小窗口后再算。

该覆盖计算依赖同一utid的状态区间不重叠;发现重叠或非法时长应先降级,不能靠求和补齐缺口。原始事件时钟由Trace Processor归一;外部marker/log需证明同boot和时钟转换,不能把wall-clock或MONOTONIC直接标成同一ns时间轴。

如果 Runnable 很高,优先看 CPU 竞争、线程优先级、频率和唤醒源;如果 Running 很高,再考虑 CPU profiling 或函数级热点。

Log 用来补阶段语义

日志适合补 request id、session id、route change、underrun、错误码。Trace 里有 android.log 时,也要限制在问题窗口内:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
WITH target_window(start_ts, end_ts) AS (
VALUES (NULL, NULL)
)
SELECT
l.id AS log_id, l.ts, l.utid, th.upid, p.machine_id,
p.name AS process_name,
l.prio,
l.tag,
l.msg
FROM android_logs l
LEFT JOIN thread th USING (utid)
LEFT JOIN process p USING (upid)
CROSS JOIN target_window w
WHERE typeof(w.start_ts) = 'integer' AND typeof(w.end_ts) = 'integer'
AND w.end_ts > w.start_ts AND l.ts >= w.start_ts
AND l.ts < w.end_ts
AND EXISTS (SELECT 1 FROM domain_objects d
WHERE d.upid = th.upid AND d.owner_confirmed = 1)
AND (
LOWER(l.tag) LIKE '%camera%'
OR LOWER(l.tag) LIKE '%audio%'
OR LOWER(l.msg) LIKE '%underrun%'
OR LOWER(l.msg) LIKE '%configurestream%'
OR LOWER(l.msg) LIKE '%route%'
)
ORDER BY l.ts, l.id;

不要把 log 当成唯一证据。它负责给阶段命名,耗时和阻塞仍要回到 slice、sched、thread_state、Binder 和 HAL 线程。

这里按已确认进程筛日志,仍是候选清单:共享服务可能包含其他client/request,必须继续匹配session/operation/route。pid/utid缺失的日志不会进入本查询,应另列未归属证据;零结果不能证明没有underrun。

报告输出要能回 UI

自动化报告不要只吐 SQL 表。建议固定四块:

模块 输出
数据质量 Trace 时长、stats 异常、关键数据源是否存在
对象字典 相关进程、线程、track、log tag、request/session id、确认状态
阶段指标 Camera open/config/HAL buffer/presented frame,Audio write/mix/output 周期
复查点 ts、dur、进程、线程、slice/log 名称

下面的数值只展示报告字段,不来自实测 Trace;真正输出时每个时间点仍须能跳回原始轨道:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Camera open analysis
trace: camera_open_run03.perfetto-trace
data_quality: not_evaluated
target_window: 123.000s..124.200s
phase:
open_api: 42 ms
configure_streams: 98 ms
first_hal_buffer: 286 ms
first_preview_marker_candidate: 486 ms # 未核对目标 layer/present 前,不称可见首帧
observations_not_yet_attributed:
cameraserver Binder thread runnable: 41 ms
provider HAL slice: 98 ms
review:
ts=123.456s process=cameraserver thread=Binder:1234 slice=connectDevice dur=73ms
ts=123.612s process=provider thread=CamX slice=configure_streams dur=98ms

报告里每个异常都要能跳回 Perfetto UI。只有结论没有时间点,别人没法复查。

对领域负责人来说,报告要指向可复查的时间段,而不是停在“脚本判断 Camera HAL 慢”。例如 provider configure 花了 98ms、对应 request id 是 17、同一时间 Binder 线程 Runnable 41ms、没有 data loss。脚本负责把上下文整理到一起,最终结论仍要能被 UI 和源码路径复核。

服务端和问题包还要有机器可读的 summary.json。下面保留示意耗时展示结构,未做质量/归因/脱敏验收的字段明确为unknown或not_evaluated。实报要替换hash、Trace/设备版本、对象ID、时间窗与证据定位;前后两个示例不是同一次实测输出:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
{
"case_id": "case-20260504-camera-001",
"domain": "camera",
"scenario": "camera_open_preview",
"preset_id": "camera_open_lab_v4",
"config_version": "v4",
"trace_config_hash": "sha256:...",
"analysis_processor_version": "v58.3",
"trigger": "app_camera_open_slow",
"target_window": {
"start_ts": 123000000000,
"end_ts": 124200000000,
"source": "track_event",
"clock_domain": "trace_processor_normalized_ns"
},
"data_quality": "not_evaluated",
"required_signals_available": null,
"missing_required_signals": null,
"stats_findings": null,
"object_dictionary_version": "camera_audio_v1",
"domain_objects": [
"camera_app_client",
"camera_service",
"camera_provider"
],
"stage_metrics": [
{
"stage_name": "configure_streams",
"status": "illustrative",
"start_ts": 123612000000,
"end_ts": 123710000000,
"dur_ms": 98,
"source_role": "camera_provider",
"evidence_slice": "configure_streams",
"review_ts": 123612000000,
"start_slice_id": null,
"end_slice_id": null
}
],
"blocking_evidence": [
{
"type": "runnable",
"process": "cameraserver",
"thread": "Binder:1234",
"dur_ms": 41,
"source_sql": "sql/domain_thread_state.sql",
"status": "illustrative_observation_not_causal",
"upid": null,
"utid": null,
"interval_start_ts": null,
"interval_end_ts": null
}
],
"app_marker_status": "not_evaluated",
"platform_event_status": "not_evaluated",
"fallback_used": "none",
"evidence_grade": "ungraded",
"assignee_hint": "platform-camera",
"ui_review_points": [
{
"ts": 123612000000,
"dur": 98000000,
"process": "provider",
"thread": "CamX",
"track_id": 88,
"slice": "configure_streams"
}
],
"privacy_mode": "log_tag_whitelist",
"redaction_status": "not_evaluated",
"raw_trace_available": null,
"log_excerpt_policy": "window_only",
"retention_until": "2026-05-07T15:30:12+08:00",
"next_action": "owner_review",
"example_only": true,
"device_service_version": null,
"trace_sha256": null
}

让 App 和平台补稳定事件

Camera/Audio 自动化最怕名称漂移。不同 Android 版本、厂商 HAL、相机模组、音频路由,slice 名称都可能变。可控代码里应补稳定事件:

事件 owner required args 用途 隐私边界
Camera#OpenStart App client_instance_id, camera_id, session_id, operation_id, event_id open_api 起点 不写用户内容
Camera#OpenEnd App client_instance_id, camera_id, session_id, operation_id, event_id, result open_api 终点 错误码白名单
Camera#Opened App client_instance_id, camera_id, session_id, operation_id, result onOpened成功回调 错误码白名单
Camera#ConfigureStreamsEnd platform client_instance_id, camera_id, session_id, operation_id, stream_id, result configure终点 错误码白名单
Camera#FirstHalBuffer platform client_instance_id, camera_id, session_id, operation_id, stream_id 目标stream首个有效buffer 不写画面内容
Camera#ConfigureStreamsStart platform client_instance_id, camera_id, session_id, operation_id, stream_id configure 阶段起点 分辨率/格式可保留
Camera#FirstPreviewFrame platform/App client_instance_id, camera_id, session_id, operation_id, stream_id, surface_id 可见首帧候选 不写画面内容
AudioFlinger#MixerCycle platform cycle_seq, route_generation 已确认track的每次循环 不写媒体内容
Audio#TrackStart App/platform track_id, route, sample_rate, buffer_frames 音频周期起点 route 用枚举
Audio#WriteBuffer App track_id, frames, buffer_level App 写入节奏 不写媒体内容
Audio#Underrun platform track_id, route, sample_rate, buffer_frames, underrun_count underrun 事件 route/tag 白名单
Audio#RouteChange platform old_route, new_route, reason route 变化 不写设备唯一标识

Camera marker的result按示例约定为字符串success或明确错误枚举;OpenEnd的success仅表示调用正常返回。Audio领域的track_id是业务音轨ID,不等于Trace Processor的轨道ID,需显式映射。

这些事件可以来自 android.os.Trace、NDK ATrace、Perfetto SDK Track Event 或平台侧 ATRACE。事件名要稳定,不能把动态 id 拼进事件名。

如果用 ATrace,重点是稳定 slice 名和 async cookie。ID 类信息优先放 Track Event 参数、flow id、log/side table 或同一 case 的元数据;counter 只放 queue depth、buffer level、underrun count 这类可解释数值。需要更完整的参数和跨线程关联时,优先用第 13 篇讲过的 Perfetto SDK Track Event。

平台自定义 data source 优先级更低。只有高频、强结构化,或普通 slice/counter 表达不了时才做;manifest 里要写清 data source name、producer 进程、SELinux 域、TraceConfig、解析器和 SQL 兼容策略。

从专项方法扩展到问题清单

Camera/Audio 只是例子。团队要把 Perfetto 用稳,需要把常见现象翻译成采集 preset、采集方、构建类型、分析路径和输出证据。

问题 基础数据源 专项加开 默认输出
UI 卡顿 sched、freq、idle、gfx、view、wm、input、process_stats、FrameTimeline binder_driver、App ATrace/Track Event 问题帧、App/HWUI/SurfaceFlinger 阶段、线程状态
点击响应慢 input、sched、freq、view、wm、binder_driver、FrameTimeline App 视觉状态 counter、高速相机对照 input 到首个可见变化
App 启动 sched、freq、am、wm、view、binder_driver、FrameTimeline log、CPU profiling、App ATrace/Track Event 启动阶段、首帧、Top wait
ANR sched、freq、binder_driver、am、wm userdebug/授权环境的 log、lock、IO、CPU profiling 主线程等待证据
Binder 慢 sched、binder_driver、binder_lock、process_stats system_server log、接口事件 慢事务 TopN、server 状态
Native 内存 process_stats heapprofd、log、业务 trigger 分配栈和增长趋势
Camera sched、freq、camera、hal、binder_driver、SurfaceFlinger layer/present;适用时加 FrameTimeline log、CPU profiling、平台事件 open/config/HAL buffer/可见首帧
Audio sched、freq、audio、hal、binder_driver 授权环境的log、CPU profiling、平台事件 underrun 前后周期抖动
功耗/温控 sched、freq、idle、android.power、thermal 授权环境的 log、GPU counters、devfreq、power rails 资源趋势和异常窗口

每个 preset 都要有负责人、版本、用途、默认窗口、采集方、构建边界、数据源、开销等级、隐私等级和质量门禁。没有这些字段,preset 很快会变成一堆没人敢删的配置:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
preset_id: ui_jank_v4
maintainer: platform-performance
mode: ring_buffer_stop_trigger
default_window: 30s
collector: platform_trace_service
consumer_identity: oem_perfetto_collector
selinux_domain: oem_tracing_service
allowed_data_sources:
- linux.ftrace
- android.surfaceflinger.frametimeline
- track_event
- linux.process_stats
can_read_trace_output: true
upload_path: oem_diagnostics
supported_builds:
- userdebug
- oem_diagnostics_user
app_marker_policy:
atrace_apps:
- com.example.app
requires_profileable_or_debuggable: true
requires_userdebug_or_root: false
requires_vendor_producer: false
runtime_overhead_level: unmeasured
data_rate_budget_mb_s: 1.0 # Proposed budget; not a measured rate
max_duration_s: 60
forbidden_sources_in_field:
- linux.perf
- heapprofd
- gpu.counters
- syscall_high_frequency
- page_fault_high_frequency
privacy_level: system-metadata-and-app-markers
trace_config: configs/ui_jank_v4.pb
config_format: binary_proto
config_hash: sha256:...
review_status: draft
required_signals:
- FrameTimeline
- sched
- process_stats
derived_tables_required:
- thread_state
fallback_sources:
- bugreport_summary
- external_logcat
quality_gate:
quality_sql: sql/trace_health.sql
disallow_data_loss: true
required_stats_clean:
- ftrace/sched
- central_buffer
- clock
require_required_signals: true
report_template: reports/ui_jank.md

普通App不能提交任意系统级TraceConfig或直接持有consumer socket。它可以写marker、发trigger、补元数据,也可在API35+通过ProfilingManager请求受系统政策约束的profiling。完整平台session通常由OEM诊断服务、Traceur、shell或实验室脚本持有;请求被接受与收到可用结果分别验收。

user build 上常见的系统 Trace 入口包括 Traceur、shell 和经平台权限及 SELinux 授权的诊断组件;具体可用 consumer 由设备实现决定。普通 App 或未授权诊断 App 不能直接控制系统级 Perfetto consumer socket。本文团队策略只下发审核过的binary TraceConfig或preset id;二进制格式利于机器兼容,但不是权限或脱敏机制,仍须校验允许的数据源与字段。

线上上传前要有相应授权、访问控制、保留周期与可核验脱敏结果。trace_filter 在service ReadBuffers阶段作用于IPC读回及write_into_file,不保证敏感字段从未进入producer/central buffer。Android12的早期实现有缺陷,Android13重引入,Android14新增支持字符串过滤的bytecode版本;按目标service生成并验证规则,默认未匹配字符串可能原样保留。metadata写规则版本与结果hash,tag白名单不等于消息脱敏。

报告也要给结论分级:

等级 写法 必须字段
确认 X 在窗口 A 内阻塞了 Y required_signals_available=true、data_quality=clean、owner_confirmed=true、阶段事件完整且顺序有效、直接依赖/等待链与替代原因核查、ui_review_points>=1、source_sql
倾向 更像 X 方向 主证据成立,missing_evidence 列出缺源码、日志或领域状态
排除 暂不支持 X 结论 signal_present=true 且指标没有支持该方向,不能来自数据缺失
降级 本 Trace 不能判断 X degrade_reason 写明 data loss、数据源缺失或样本不足

报告把「确认」「倾向」「排除」「降级」分别保留,复查时就能看到哪些判断有完整证据,哪些仍缺 HAL、日志或目标窗口数据。

完整阶段和clean数据只支持观测值,不能自动证明“X阻塞Y”。例如整个窗口累计Runnable 41ms与configure 98ms并不说明同一次Binder调用被阻塞41ms;要在目标依赖区间内重算并建立等待链。把耗时变长归因于策略或硬件时,还需匹配条件的对照或A/B证据。

平台和 OEM 侧要建设什么

App 侧能补业务语义,但很多问题发生在 App 看不到的地方:system_server Binder 堵塞、AudioFlinger underrun、Camera HAL 阻塞、Power HAL 策略切换、调度器迁核、GPU 执行轨道不足、Bugreport 里证据散落。平台侧要把四件事固定下来:preset、trigger、证据包格式、自动分析入口。

平台侧不要让工程师每次临时写 TraceConfig。TraceConfig 应该像接口一样被版本化管理,放在仓库里评审、测试、发布:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
perfetto-presets/
base/
base_low_overhead_v1.pbtx
ui/
ui_jank_field_v3.pbtx
media/
audio_underrun_field_v3.pbtx
camera_open_lab_v4.pbtx
system/
binder_slow_field_v2.pbtx
thermal_degrade_field_v2.pbtx
boottrace_v2.pbtx
manifest.yaml
sql/
ui_jank_summary.sql
audio_mixer_jitter.sql
camera_open_stage.sql

一套 Perfetto 体系至少分三层:

层级 使用场景 采集方 采集特点 典型数据源
field user build 线上/灰度问题 平台/OEM 诊断组件或 Traceur;App 只发 marker/trigger 低开销、Ring Buffer、短窗口 stop trigger sched、process stats、少量 App ATrace、必要 counter
lab 实验室复现和版本对比 shell、测试框架、平台脚本 可控设备、可重复脚本、指标稳定 FrameTimeline、freq、idle、Binder、领域 log 摘要
deep 专项排查 userdebug/root、平台工程工具 短时间、高开销、人工操作 heapprofd、linux.perf、GPU counters、更多 HAL 事件

本文的field基线排除deep preset,避免把未测开销的实验配置直接长期启用。这是团队默认策略,不是Perfetto禁止线上profiling:heapprofd、linux.perf或系统管理的profiling可有受控现场用途,应单独评审目标范围、采样率、时长、扰动和隐私,而不是沿用本例低开销标签。

deep preset 的边界要单独写:

  • linux.perf 是采样 profiler,不是全量事件;默认只限短窗口、低频率、目标进程/线程 scope,并写清 unwind、kernel frame、root/userdebug/kptr 限制。
  • vendor tracepoint 先查 /sys/kernel/tracing/events/*/*/format、字段稳定性和 ftrace_setup_errors;未知事件只能作为 raw event 或候选证据。
  • 本例field策略排除 linux.perf、heapprofd、GPU counters、syscall/pagefault 高频事件;必要 counter 必须写采样周期、单位、设备支持范围和上传隐私级别。
  • 每个 preset 要有实测写入速率和 data loss 基线,不用一个 cost_level 代替真实预算。

Ring Buffer 适合保留触发前后的短窗口,不等于可以无限期留住全量上下文;长 Trace 要用第 15 篇那套后台采集、分段保存和明确退出条件。

trigger 中心也要收敛。App 代理、Framework watchdog、AudioFlinger、CameraService、Thermal/Power、实验室工具都只能发送已登记的 trigger 名称。平台侧再按设备、用户、版本、场景、网络和存储状态限频。名称进入平台后不要随意改,否则服务端索引、SQL 模板、历史趋势和告警规则都会断开。

“已登记”是团队协议:producer可以发送未配置的名称,但不会触发对应session动作。实际接收还受trigger配置、超时、采样、限频及可选producer_name_regex约束;发送返回不证明已采到Trace。名称不是secret或授权凭证,producer名称过滤也不能替代平台身份校验。

Bugreport 也要和 Perfetto 结合。bugreport_score > 0 会把正在运行的 trace session 标记为 Bugreport 候选;bugreport_score <= 0 的 session 不会进入候选。Android dumpstate 调用 perfetto --save-for-bugreport 时,会选择最高分候选 trace 保存到 Bugreport 路径。Android 12/13 上会保存候选 trace 并提前停止原 session;Android 14 及以上版本会创建只读快照,原 session 可以继续运行。bugreport_filename 是Android15/Perfetto v42+字段,用于 --save-all-for-bugreport 的输出命名;save-all与只取最高分是不同入口。正score允许其他UID克隆该session,不等于允许同UID约束之外的detach重接;manifest需记录此访问边界。保存Trace也不等于已经打包或上传Bugreport。

系统埋点要先建字典,再补代码:

1
2
3
4
5
6
7
8
9
10
11
camera:
CameraService#Open
CameraProvider#ConfigureStreams
CameraHAL#FirstRequest
CameraHAL#FirstResult

audio:
AudioTrack#Start
AudioFlinger#MixerCycle
AudioHAL#Write
BluetoothAudio#RouteChange

这份平台字典和前面 domain schema 里的 Camera#* 是两层东西:CameraService#Open、CameraHAL#FirstResult 是各服务里的埋点实现名,Camera#OpenStart、Camera#FirstHalBuffer 是分析和报告使用的接口名。两层靠 schema 里 stable_events 的 owner 字段和一张映射表对上;SQL 和报告只认 schema 名,埋点实现改名时只更新映射,不动分析层。

这些实现名也是假设示例。owner字段不会执行映射;映射层还须定义begin/end时间点、单位、args传播、成功/失败和原始slice/track ID。FirstResult可能仅是metadata,不能仅改名成FirstHalBuffer。上文SQL直接读schema marker;若只有实现事件,必须先完成这层转换并核验语义。

命名要稳定,含义要能被 SQL 聚合。动态信息放参数、counter 或 metadata,不要拼进事件名。URL、联系人、消息内容、搜索词、地理位置明文不能进入 trace event。

服务端至少要做五件事:文件验收、可信度验收、场景摘要、聚合索引、人工入口。人工打开 UI 前,报告里应该已经写清楚 preset、trigger、触发窗口、质量门禁状态、相关进程线程和机器摘要指向哪个负责人。

处理状态建议写成显式状态机:

1
2
3
4
5
6
7
8
9
10
ingested
-> quality_checked
-> scenario_classified
-> assignee_selected
-> evidence_graded
-> issue_linked
-> fix_build_recorded
-> same_preset_rerun
-> before_after_compared
-> regression_rule_updated

处理状态还应记录 preset、SQL 版本和证据等级。版本升级后若字段改名或数据源缺失,在 quality_checked 阶段标出降级原因,后续报告就不会沿用旧结论。

常见坑

  • 只按 LIKE '%camera%' 会漏掉 provider、vendor HAL、codec、media 进程。
  • 只开 atrace_categories 会漏掉 App 侧 android.os.Trace,需要 atrace_apps 或 Track Event。
  • 普通App不能提交任意系统采集配置;除marker/trigger外,API35+还可请求系统管理的ProfilingManager。
  • 常规 View UI、启动、点击响应场景应优先采 FrameTimeline;目标使用 SurfaceView 或设备不提供对应帧数据时,改查目标 layer/present 等证据,并明确帧指标不可用。
  • android.log 默认按 userdebug 支持范围设计;已 root 的 user 设备需实测权限和数据,普通 user build 要准备替代来源。
  • Binder 慢只是现象,服务端可能在等 HAL、锁、IO 或下游硬件。
  • Audio 要看周期抖动,不要只看 Top long slice。
  • Camera 要拆 open、configure、preview、capture,不要混成一个总耗时。
  • Running 看实际运行区间(sched 或 thread_state 的 Running),Runnable 看 thread_state 的 R/R+,两者分开算。
  • Agent 或脚本只能组织证据,不能替代 UI 复查和领域负责人判断。
  • Camera 首帧要区分 API 返回、HAL buffer 返回和画面显示。
  • Audio 周期阈值要按设备、route、buffer 配置建立基线。
  • 线上 preset 越开越重,会带来功耗、隐私和稳定性问题。
  • 系统埋点没有字典,事件名漂移后 SQL 和历史趋势都会失效。
  • Bugreport 和 Trace 分离,研发要在多个附件里手工找同一时间窗口。

小结

Camera 报告要分别列 API 返回、HAL 首个 Buffer 和预览首帧;Audio 报告要保留实际 mixer 周期、写入间隔和 underrun marker。两类报告都应能从异常时间点跳回 Trace,并说明缺失的数据源。WebView、Flutter 或游戏专项可以沿用这套对象归属与证据分级方法,再换成各自的阶段字典。

SmartPerfetto 将场景查询与证据复查接在一起;项目当前支持的场景和边界以仓库说明为准,写作时的设计过程见六周更新复盘。

参考文档

  1. ATrace data source
  2. Track events
  3. Android Log data source
  4. Android Jank detection with FrameTimeline
  5. Buffers and dataflow
  6. Trace Processor Stats
  7. Getting Started with PerfettoSQL
  8. Trace Processor Python API
  9. AOSP Camera HAL
  10. AOSP Audio architecture
  11. Advanced System Tracing on Android
  12. TraceConfig reference
  13. Android <profileable> manifest element

源码核对版本:v58.3(2026-10-14)。

关于我 && 博客

欢迎关注 Android Performance。

CATALOG
  1. 1. Perfetto 系列文章
  2. 2. 领域分析从对象字典开始
  3. 3. 配置从领域 preset 开始
  4. 4. Camera 看阶段
  5. 5. Audio 看周期
  6. 6. Running 和 Runnable 分开算
  7. 7. Log 用来补阶段语义
  8. 8. 报告输出要能回 UI
  9. 9. 让 App 和平台补稳定事件
  10. 10. 从专项方法扩展到问题清单
  11. 11. 平台和 OEM 侧要建设什么
  12. 12. 常见坑
  13. 13. 小结
  14. 14. 参考文档
  15. 15. 关于我 && 博客