使用 Perfetto 采集应用内 trace

cmake_minimum_required(VERSION 3.13) project(Example) # Main executable add_executable(example example.cc)

# 建议使用最新版本的 CMake。 cmake_minimum_required(VERSION 3.13) # 项目名称。 project(Example) # 查找线程库，这是 Perfetto 的依赖项。 find_package(Threads) # 将 Perfetto SDK 源文件添加到静态库。 include_directories(perfetto/sdk) add_library(perfetto STATIC perfetto/sdk/perfetto.cc) # 将应用程序的源文件添加到可执行文件。 add_executable(example example.cc) # 将 Perfetto 库和线程库链接到你的可执行文件。 target_link_libraries(example perfetto ${CMAKE_THREAD_LIBS_INIT}) # Windows 特定设置。 if (WIN32) # Perfetto 库包含许多符号，因此需要"big object"格式。 target_compile_options(perfetto PRIVATE "/bigobj") # 禁用 windows.h 中的旧功能。 add_definitions(-DWIN32_LEAN_AND_MEAN -DNOMINMAX) # 在 Windows 上，我们需要链接到 WinSock2 库。 target_link_libraries(example ws2_32) endif (WIN32) # 使用 Visual Studio 编译器时启用标准兼容模式。 if (MSVC) target_compile_options(example PRIVATE "/permissive-") endif (MSVC)

#include <perfetto.h> PERFETTO_DEFINE_CATEGORIES( perfetto::Category("rendering") .SetDescription("Events from the graphics subsystem"), perfetto::Category("network") .SetDescription("Network upload and download statistics")); PERFETTO_TRACK_EVENT_STATIC_STORAGE(); int main(int argc, char** argv) { perfetto::TracingInitArgs args; args.backends |= perfetto::kInProcessBackend; perfetto::Tracing::Initialize(args); perfetto::TrackEvent::Register(); //... }

void DrawPlayer(int player_number) { TRACE_EVENT("rendering", "DrawPlayer", "player_number", player_number); // ... } void DrawGame() { TRACE_EVENT_BEGIN("rendering", "DrawGame"); DrawPlayer(1); DrawPlayer(2); TRACE_EVENT_END("rendering"); // ... TRACE_COUNTER("rendering", "Framerate", 120); }

// 创建一个 trace 配置对象。这用于定义缓冲区、数据源和 trace 的其他设置。 perfetto::TraceConfig cfg; // 向配置添加一个缓冲区。Trace 被写入内存中的此缓冲区。 cfg.add_buffers()->set_size_kb(1024); // 1 MB // 向配置添加一个数据源。这指定要收集的数据类型。在这种情况下，我们正在收集 track events。 auto* ds_cfg = cfg.add_data_sources()->mutable_config(); ds_cfg->set_name("track_event"); // 配置 track event 数据源。我们可以指定要启用或禁用哪些 categories 的事件。 perfetto::protos::gen::TrackEventConfig te_cfg; te_cfg.add_disabled_categories("*"); // 默认禁用所有 categories。 te_cfg.add_enabled_categories("rendering"); // 启用我们的"rendering" category。 ds_cfg->set_track_event_config_raw(te_cfg.SerializeAsString()); // 创建一个新的 tracing session。 std::unique_ptr<perfetto::TracingSession> tracing_session = perfetto::Tracing::NewTrace(); // 使用配置设置 tracing session。 tracing_session->Setup(cfg); // 开始 tracing。这将阻塞直到 trace 停止。 tracing_session->StartBlocking(); // tracing_session 对象必须在 trace 期间保持活动状态。 // ...

// 停止 tracing session。这将阻塞直到所有 trace 数据都被刷新。 tracing_session->StopBlocking(); // 从 session 读取 trace 数据。 std::vector<char> trace_data(tracing_session->ReadTraceBlocking()); // 将 trace 数据写入文件。 std::ofstream output; output.open("example.pftrace", std::ios::out | std::ios::binary); output.write(trace_data.data(), std::streamsize(trace_data.size())); output.close();