Pyroscope Go客户端必须在main()第一行调用pyroscope.Start()，明确指定ApplicationName、ServerAddress（Docker/K8s中禁用localhost）、ProfileTypes（如CPU和AllocObjects），并确保服务端可达，否则火焰图为空。
Pyroscope 在 Golang 微服务中不是“配置完就跑”，而是必须确保客户端启动早于业务逻辑、服务端可达、且 ProfileTypes 明确指定，否则火焰图永远为空。
Go 客户端必须在 main() 最开头调用 pyroscope.Start()
常见错误是把 pyroscope.Start() 放在 HTTP server 启动之后，或嵌套在某个初始化函数里。此时 profiler 会错过应用启动初期的调用栈（比如依赖注入、DB 连接池初始化），导致火焰图顶部缺失关键函数。
- 正确位置：紧贴
func main()第一行，早于任何log、database.Open或http.ListenAndServe - 必须传入
ApplicationName和ServerAddress；若服务端在 Docker 网络内（如pyroscope容器名），不要写localhost:4040，而要用容器名：http://pyroscope:4040 - 忽略
Tags字段会导致多实例无法区分，建议至少带上"env"和"service"标签
ProfileTypes 不设默认值，CPU 和内存需显式启用
Pyroscope Go client 默认只采集 CPU，但多数线上瓶颈来自内存分配或 goroutine 泄漏。不手动添加类型，UI 里就看不到 alloc_objects 或 goroutines 切换项。
- CPU 分析必选：
pyroscope.ProfileCPU - 内存泄漏排查加：
pyroscope.ProfileAllocObjects（分配对象数）或pyroscope.ProfileInuseObjects（存活对象数） - 协程堆积问题加：
pyroscope.ProfileGoroutines；阻塞/锁竞争加：pyroscope.ProfileBlock和pyroscope.ProfileMutex - 避免全量开启：每多一种类型，采样开销略增；生产环境建议按需组合，例如
[]pyroscope.ProfileType{pyroscope.ProfileCPU, pyroscope.ProfileAllocObjects}
Docker 网络下服务端地址不能写 localhost
本地开发时 http://localhost:4040 可行，但微服务部署在 Docker Compose 或 Kubernetes 中时，Go 应用容器内的 localhost 指向自身，而非 Pyroscope 容器 —— 结果是连接拒绝，日志里反复出现 failed to send profile: Post "http://localhost:4040/ingest": dial tcp 127.0.0.1:4040: connect: connection refused。
立即学习“go语言免费学习笔记（深入）”；
- Docker Compose 场景：Pyroscope 服务名为
pyroscope，Go 应用应配http://pyroscope:4040 - Kubernetes 场景：用 Service DNS 名，如
http://pyroscope.default.svc.cluster.local:4040 - 验证方式：进入 Go 应用容器执行
curl -v http://pyroscope:4040/health，返回200 OK才算通
火焰图没数据？先查 pyroscope.HealthCheck 和采样频率
UI 界面显示 “No profiles found” 是最常遇到的问题，原因往往不是代码没写对，而是服务端不可达或采样被抑制。
- 加一行健康检查：在
pyroscope.Start()后立刻调用pyroscope.HealthCheck()，它会返回 error；若非 nil，说明 client 根本没连上服务端 - 默认采样频率是 97Hz（约每秒 97 次），但如果 Go runtime GC 频繁或 CPU 负载极高，实际采样可能被节流；可通过
SamplingFrequency参数微调，但不建议低于 50Hz - 确认 Go 应用未被
GODEBUG=madvdontneed=1等调试参数干扰 —— 这类参数会影响堆栈采集准确性
真正麻烦的不是接入，而是当火焰图里出现大量 runtime.mcall 或 runtime.gopark 占比过高时，你得判断这是正常调度开销，还是 goroutine 泄漏的前兆 —— 这时候标签分组和时间范围切换就变得关键了。
