代码 Go 1.28 的 PGO 能接受 perf 采样了:FromPProf 按 CPU 采样列取值

2026-11-17 21:04:45

Go 1.28 的 PGO 能接受 perf 采样了:FromPProf 按 CPU 采样列取值

信源:golang.design 的 Go 1.28 (dev) runtime/compiler history,以及 Go 1.28 相关 commit 记录。

默认 PGO 用法

Go 1.21 起 PGO GA。go build 默认使用 -pgo=auto:只要 main package 目录下存在 default.pgo,构建时就会自动使用,不需要额外参数。

  • -pgo=off:关闭 PGO
  • -pgo=auto:默认值,查找 main package 目录下的 default.pgo
  • -pgo=/path/to/file.pprof:显式指定 profile 文件

PGO 主要驱动 hot-call inlining 和 devirtualization(接口调用去虚化)。而且它只对 main module 内的包生效,依赖包默认不使用这份 profile。

profile 的来源是 runtime/pprof 的 CPU profile:pprof.Lookup("cpu"),或者 net/http/pprof 的 /debug/pprof/profile?seconds=30。

为什么需要外部 profile

Go 自带 pprof 采的是用户态样本,内核态以及用户态、内核态之间的混合栈拿不到,采出的调用关系在这些位置是断开的。线上服务通常也不方便为了取一份 profile 就长期开启 net/http/pprof 端点。还有一种情况是只想在特定负载下取样:比如只关心压测流量或某个业务高峰时的热点,这时需要从外部对目标进程采样。

Go 1.28 的改动

FromPProf 现在接受外部工具生成的 CPU profile,例如 Linux perf 的采样经 perf_to_profile 转成的 pprof 格式。perf 侧的值名和 Go 自己的不一样,常见 cycles_event、count 这类命名,此时实现会取 CPU 类的那一列采样(commit 3bd19c1c39,issue #64489)。

从 perf 采到 default.pgo

# 1. 对目标进程采样 30 秒,99Hz,带调用栈
perf record -F 99 -g -p
-- sleep 30

# 2. 用 perf_data_converter 里的 perf_to_profile 转成 pprof protobuf
#    具体参数名需按你的版本验证
perf_to_profile perf.data cpu.pb.gz

# 3. 放到 main package 目录,改名 default.pgo
mv cpu.pb.gz ./cmd/yourserver/default.pgo
go build ./cmd/yourserver

perf record 受 perf_event_paranoid 限制,权限不足时无法使用;在容器里通常要加 --cap-add SYS_ADMIN,或者先把内核参数调低。格式转换工具来自 Google 的 perf_data_converter 项目。

几个容易忽略的前提

  • profile 必须来自同一构建:同一份代码、同一套构建配置。如果线上二进制采样、本地另一份代码构建,内联决策会对不上。
  • CPU 族也要一致。指令选择、去虚化的收益在不同微架构上并不相同。
  • 样本量要够。30 秒 99Hz 大约几千个样本,采样太短得出的 hot call 不可信。
  • PGO 只影响内联与部分优化,不要把它当成整体性能改造。
  • FromPProf 对值名的判定逻辑、perf_to_profile 的命令行参数,需按你的 Go 版本与工具版本验证。
复制全文 生成海报 Go 性能 PGO perf

推荐文章

程序员茄子在线接单