README.template.md

pprofutils

pprofutils is a swiss army knife for pprof files. You can use it as a command line utility or as a free web service.

• Install
• Utilities: {{range $i, $util := .}}{{if $i}} · {{end}}{{.Name}}{{end}}
• Use Cases: Convert linux perf profiles to pprof
• License

Install

pprofutils requires Go 1.16 and can be installed like this:

go install github.com/felixge/pprofutils/v2/cmd/pprofutils@latest

Alternatively you can use it as a free web service hosted at https://pprof.to.

Utilities

{{range $i := .}}### {{.Name}}

{{.LongHelp}}

Use {{.Name}} utility via cli

pprofutils {{.Name}} {{.ShortUsage}}{{if .Flags}}

FLAGS:{{range $name, $flag := .Flags}}
  -{{$name}}={{defaultval .Default}} {{.Usage}}{{end}}{{else}}{{end}}

Use {{.Name}} utility via web service

curl --data-binary @<input file> 'pprof.to/{{.Name}}{{queryflags .Flags}}' > <output file>

{{examples .}}

{{end}}

Use Cases

Convert linux perf profiles to pprof

Convert a Linux perf.data profile to pprof, via Brendan Gregg's stackcollapse-perf.pl script:

perf script | stackcollapse-perf.pl | pprofutils folded > perf.pprof

License

pprofutils is licensed under the MIT License.