Perfetto项目中的Trace配置详解

Perfetto项目中的Trace配置详解

perfetto Performance instrumentation and tracing for Android, Linux and Chrome (read-only mirror of https://android.googlesource.com/platform/external/perfetto/) 项目地址: https://gitcode.com/gh_mirrors/pe/perfetto

概述

Perfetto是一款强大的系统性能分析工具，与传统的持续日志系统不同，Perfetto的所有数据源在默认情况下都处于空闲状态，只有在明确配置后才会开始记录数据。本文将深入解析Perfetto中的Trace配置机制，帮助开发者更好地理解和使用这一工具。

Trace配置基础

核心概念

Perfetto的Trace配置通过TraceConfig协议缓冲区消息定义，主要包含三大类配置：

1. 系统行为配置：控制整个追踪系统的行为

   • 最大追踪时长(duration_ms)
   • 内存缓冲区数量和大小(buffers)
   • 输出文件最大尺寸(max_file_size_bytes)

2. 数据源配置：指定要启用的数据源及其参数

   • 内核事件追踪(linux.ftrace)
   • 堆内存分析(android.heapprofd)
   • 系统统计信息(linux.sys_stats)

3. 缓冲区映射：定义数据源与缓冲区的对应关系

基本配置示例

一个简单的Trace配置示例如下：

duration_ms: 10000  # 追踪持续10秒

buffers {
  size_kb: 65536    # 64MB缓冲区
  fill_policy: RING_BUFFER  # 环形缓冲区策略
}

data_sources {
  config {
    name: "linux.ftrace"  # 启用内核ftrace数据源
    target_buffer: 0      # 使用缓冲区0
    ftrace_config {
      ftrace_events: "sched_switch"  # 追踪调度切换事件
      ftrace_events: "sched_wakeup"  # 追踪唤醒事件
    }
  }
}

缓冲区管理

缓冲区类型

Perfetto支持两种缓冲区填充策略：

1. 环形缓冲区(RING_BUFFER)：默认策略，当缓冲区满时，新数据会覆盖最旧的数据
2. 丢弃缓冲区(DISCARD)：缓冲区满后停止接受新数据

多缓冲区策略

当不同数据源产生数据的速率差异很大时，建议使用多缓冲区配置：

buffers {
  size_kb: 4096  # 缓冲区0: 4MB
}

buffers {
  size_kb: 8192  # 缓冲区1: 8MB
}

data_sources {
  config {
    name: "linux.ftrace"
    target_buffer: 0  # 高频率数据使用缓冲区0
  }
}

data_sources {
  config {
    name: "linux.sys_stats"
    target_buffer: 1  # 低频率数据使用缓冲区1
  }
}

配置格式

Perfetto支持两种配置格式：

1. 文本格式(PBTX)：适合人工编辑和调试

   perfetto --txt -c config.pbtx -o trace.perfetto-trace
   

2. 二进制格式：适合自动化工具和脚本

   perfetto -c config.bin -o trace.perfetto-trace
   

长时追踪策略

对于需要长时间运行的追踪任务，Perfetto提供了流式写入功能：

write_into_file: true          # 启用定期写入
file_write_period_ms: 5000     # 每5秒写入一次
max_file_size_bytes: 1073741824 # 最大文件大小1GB
buffers {
  size_kb: 32768               # 32MB内存缓冲区
}

这种配置可以显著减少内存占用，但会增加I/O开销。

数据源特定配置

每个数据源可以有自己的专有配置，这些配置会被原样传递给对应的数据源处理器。例如：

data_sources {
  config {
    name: "android.power"
    android_power_config {
      battery_poll_ms: 1000
      collect_power_rails: true
    }
  }
}

多进程数据源处理

当多个进程提供相同的数据源时，可以通过生产者名称过滤器进行精确控制：

data_sources {
  config {
    name: "track_event"
  }
  producer_name_filter: "com.example.app1"
  producer_name_filter: "com.example.app2"
}

触发器机制

Perfetto提供了灵活的触发器机制，可以在特定事件发生时启动或停止追踪：

启动触发器

trigger_config {
  trigger_mode: START_TRACING
  triggers {
    name: "app_slow_event"
    stop_delay_ms: 3000  # 触发后3秒停止
  }
  trigger_timeout_ms: 60000  # 超时60秒
}

停止触发器

trigger_config {
  trigger_mode: STOP_TRACING
  triggers {
    name: "frame_drop"
    stop_delay_ms: 1000  # 触发后1秒停止
  }
}

Android平台注意事项

在Android平台上使用Perfetto时需注意：

1. 使用adb shell时，Ctrl+C信号可能无法正常传递
2. 在Android 12之前，非root设备需要通过stdin传递配置
3. 长时追踪建议使用后台模式：

   PID=$(perfetto --background)
   # 稍后停止
   kill $PID
   

最佳实践建议

1. 对于高频率事件(如调度器事件)和低频率事件(如内存统计)，使用不同的缓冲区
2. 长时追踪时启用write_into_file并适当增大缓冲区
3. 生产环境使用二进制配置格式，开发调试使用文本格式
4. 合理设置触发器，实现精准的事件捕获

通过深入理解这些配置选项，开发者可以充分发挥Perfetto的强大功能，获取精确的系统性能数据。

perfetto Performance instrumentation and tracing for Android, Linux and Chrome (read-only mirror of https://android.googlesource.com/platform/external/perfetto/) 项目地址: https://gitcode.com/gh_mirrors/pe/perfetto