如何利用 Tracy 内置的 Achievements 成就教程快速上手各项分析功能【免费下载链接】tracyFrame profiler项目地址: https://gitcode.com/GitHub_Trending/tr/tracy刚接触 Tracy一款 frame profiler时最直接的问题是不知道界面里哪些窗口值得看、分析功能从哪一步开始用。Tracy 的分析器窗口内置了Achievements成就系统它把接入、插桩、查 zone、看统计、采样、存读 trace等上手路径拆成一个个带说明的任务逐个完成即可熟悉各项分析功能。本文基于仓库中profiler/src/achievements/目录下的成就文档梳理这条操作路径如何打开成就列表、如何按提示完成第一次 profiling 会话以及每个成就对应的界面按钮和代码改动。打开成就列表并看懂任务标记在 Tracy 的分析器窗口中点击Achievements按钮打开 Achievements List成就列表。列表会展示需要完成的任务及简短说明。随着你完成某个成就新的成就会自动出现所以要经常回列表查看。为便于发现新内容列表对任务带有标记New tasks新任务橙色标记Completed tasks已完成任务绿色标记。当列表中有新东西可看时Achievements 按钮会发出黄色高亮提示。成就文档的入口说明见 Intro.md。第一个成就完成首次 profiling 会话第一个成就First profiling session要求你把 Tracy 接入自己的应用并连接到分析器。按 ConnectToClient.md 给出的步骤操作将 Tracy Profiler 集成到你的应用。可以用 CMake、Meson也可以直接把源文件加入你的项目。确保TracyClient.cpp或 Tracy 库包含在你的构建里。在构建配置中为整个应用定义TRACY_ENABLE。不要只在单个源文件里定义那样不会生效。启动你的应用在 Tracy 中Connect连接到它。完成这四项后你就有了第一个可分析的 trace后续成就都建立在这个连接之上。插桩成就加 ZoneScoped 与 FrameMark 宏接下来的一组成就要求你给代码加插桩。插桩让你看到选定函数集合每次调用的精确运行时间代价是需要手动改代码见 InstrumentationIntro.md。用 ZoneScoped 标记函数打开一个源文件包含Tracy.hpp头文件然后在某个函数开头加ZoneScoped宏#include Tracy.hpp void SomeFunction() { ZoneScoped; // Your code here }插桩后重新运行应用并连接 Tracy时间线上每次调用该函数都会出现一个新的 zone可以看到每次调用的耗时和调用次数。ZoneScoped只是 Tracy 提供的众多宏之一以上是 C 的用法其他语言的处理方式类似需要参照对应语言的文档。用 FrameMark 标记帧InstrumentFrames.md 说明除了函数插桩还可以标记帧用来看每帧花了多少时间。在应用主循环或每帧开头被调用的函数中加FrameMark宏#include Tracy.hpp void Render() { // Render the frame SwapBuffers(); FrameMark; }每次调用FrameMark时间线上就出现一帧。分析器窗口顶部会绘制帧图frame graph可以一目了然地看到各帧耗时和每秒渲染帧数适合发现运行几分钟后才出现的性能问题。注意如果应用本身没有帧结构帧插桩可能没有意义跳过即可。分析成就查找 zone 与查看统计有了插桩数据后两个成就引导你使用 Tracy 的核心分析窗口。用 Find zone 定位并查看 zone 统计打开顶部工具栏的Find zone按钮进入搜索窗口输入 zone 名称大多数情况下就是代码里的函数名搜索。同名 zone 可能搜出多个界面会列出所有结果你可以任选其一。另一条路径是打开 Statistics 窗口后直接点击某条记录效果等同于对该 zone 执行了一次 Find zone 搜索。选中一个 zone 后界面会显示一组统计数据并绘制 zone 执行时间的直方图histogram。文档建议选一个调用次数多的 zone直方图才有意义。你还可以在直方图上拖出一个范围限制下方 zone 列表的条目数量列表支持逐个检查每个 zone也有若干 zone 分组可选选中某个分组后该分组对应的时间会在直方图上高亮。详见 FindZone.md。打开 Statistics 窗口点击顶部工具栏的Statistics按钮会打开一个列出 trace 中所有 zone 的窗口可以看到每个 zone 花掉了多少时间、被调用了多少次。详见 InstrumentationStatistics.md。进阶成就采样、帧截图、保存与读取 trace用采样找热点无需改代码插桩需要改代码而采样sampling不需要。它可以帮你找到程序中哪里最耗时、哪些代码执行最频繁但采样结果较粗且无法得知函数何时被调用、何时返回。采样在 Linux 上是自动的在 Windows 上必须以管理员身份运行被分析的应用。另外文档提示根据系统配置不同可能还需要额外步骤具体见用户手册。详见 SamplingIntro.md。给帧附加截图FrameImageTracy 允许通过FrameImage宏为每帧附加一张截图用于回答出问题那一刻屏幕上是什么这类问题。截图和缩放需要你自己实现用户手册中提供了高效实现的示例代码。帧图片在帧的上下文中显示例如把鼠标悬停在时间线或顶部帧图上的某一帧时。另外可以点Tools图标选择Playback选项回看当时应用在做什么。详见 FrameImages.md。保存与读取 trace保存点击屏幕左上角的Connection图标再点击Save trace按钮把 trace 存到磁盘。保留旧 trace 的好处是可以对比优化前后的性能trace 文件也可以分享给同事。注意文档中的警告trace 文件可能包含敏感信息如程序代码甚至源文件内容分享前需谨慎。见 SaveTrace.md。读取在欢迎界面用Open saved trace按钮打开之前保存的 trace 文件或打开别人发来的 trace。见 LoadTrace.md。边界与限制Global settings在欢迎界面点击Wrench扳手图标会打开 about 窗口展开Global settings菜单可调整 Tracy 的多种设置设置会在多次会话之间保存只需设置一次。见 GlobalSettings.md。大数据量的代价Tracy 可以处理单个 trace 中的上亿 zone对应成就 Its over 100 million!。但不要把每个小函数都插桩——插桩本身的开销可能高于函数本身的开销。此外 zone 越多分析器使用的内存和 CPU 时间越多捕获 1 亿个 zone 大约需要 4 GB 内存注意别把内存耗尽。见 100Million.md。更深入的细节如各平台采样所需的额外步骤、FrameImage 的完整示例代码成就文档均指向用户手册user manual可在仓库的 manual/tracy.tex 中查阅。按上面这条路径你从连接应用开始逐步完成插桩、找 zone、看统计、采样、存读 trace正好覆盖成就列表引导的各项分析功能每完成一个成就留意列表里新出现的橙色任务。【免费下载链接】tracyFrame profiler项目地址: https://gitcode.com/GitHub_Trending/tr/tracy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考