Go pprof Operations
Internal
Make Sure an Executable Starts with the Profiling Subsystem Enabled
TODO
Connect with a Browser to an Executable that Has the Profiling Subsystem Enabled
Go to https://127.0.0.1:8443/debug/pprof/
If the process has TLS enabled, see TLS and Certificates for suggestions on how to address the issue.
Dump Profiles
Once a Go executable is started with the profiling subsystem enabled, you can use curl to connect to the embedded web server and dump various profiles.
Profiles can be dumped in text or binary formats.
The general syntax of the command to dump a profile in text format:
curl -k https://localhost:<http-port>/debug/pprof/<profile-name>[?debug=1|2]
where profile name can be one of goroutine, heap, threadcreate, block, mutex.
For example, to dump goroutines:
curl -k https://localhost:<http-port>/debug/pprof/goroutine?debug=2 > ~/tmp/goroutine-profile.txt
To dump the profile in a binary format that can then be fed to go tool pprof, use:
curl -k --output ~/tmp/goroutine.bin https://localhost:http-port>/debug/pprof/goroutine
TLS and Certificates
go tool pprof
go tool pprof is the tool to analyze the profiles collected from the Go process.
The tool can analyze profile collected previously, or it an attach to a live process and start a web server that allows live interaction.
go tool pprof Live
Assuming that your local 127.0.0.1 address is aliased to "localhost.somedomain.com" in /etc/hosts and the certificates are issued for "localhost.somedomain.com", set CERT_PATH to the directory that contains and and:
export CERT_PATH=/Users/ovidiu/some-project/config
go tool pprof \
-http 127.0.0.1:8080 \
-tls_cert ${CERT_PATH}/localhost.somedomain.com.chain.pem \
-tls_key ${CERT_PATH}/localhost.somedomain.com.key.pem \
https://localhost.somedomain.com:8443