callgrind 默认将分析结果写入当前目录的callgrind.out.pid文件,易被忽略且易堆积;应使用--callgrind-out-file显式指定输出路径,再用callgrind_annotate解析二进制结果。

Callgrind 生成的分析结果默认不保存到文件
直接运行 valgrind --tool=callgrind ./a.out 后,Callgrind 会把统计信息写入当前目录下的 callgrind.out.PID(如 callgrind.out.12345),但这个行为容易被忽略——它不打印路径、不提示、也不覆盖旧文件。如果你反复运行,会堆积多个 callgrind.out.* 文件,且无法区分哪次对应哪次测试。
用 --callgrind-out-file 显式指定输出路径
这是最可靠、最可控的方式。Callgrind 不支持通用的 --log-file,必须用它自己的参数:
-
--callgrind-out-file=profile-callgrind.log:固定文件名,每次覆盖 -
--callgrind-out-file=callgrind.%p.%t.log:%p是进程 PID,%t是启动时间戳(秒级),可避免冲突 - 路径支持相对或绝对路径,比如
--callgrind-out-file=/tmp/myapp-callgrind.log
示例命令:valgrind --tool=callgrind --callgrind-out-file=callgrind.main.log ./a.out
别忘了用 callgrind_annotate 解析原始数据
callgrind.out.* 是二进制格式,不能直接读。必须用配套工具解析:
-
callgrind_annotate callgrind.main.log:按函数耗时排序输出文本报告 -
callgrind_annotate --auto=yes callgrind.main.log:自动补全源码行号(需编译时带-g) - 若报错
command not found,说明callgrind_annotate未在 PATH 中——它和valgrind同包安装,但某些发行版(如部分 Alpine 镜像)可能没打包进主包,需单独确认
注意 Callgrind 的“伪实时”特性
Callgrind 不是采样器,而是逐指令插桩计数,所以:
- 输出文件只在程序退出(或收到
SIGTERM)时才完成写入;用kill -9强杀会导致文件损坏或为空 - 长时间运行的服务,建议配合
--dump-instr=yes和定时kill -USR2触发中间快照(需程序未屏蔽该信号) - 同一份
callgrind.out.*文件里可能混着多次dump的数据,解析时要用--inclusive=yes或--separate-thread=yes控制聚合粒度
真正需要长期监控时,callgrind 不是最佳选择——它开销太大(通常慢 20–50 倍),且不支持流式导出。这时候该切到 perf 或 ebpf 工具链。











