/sys/pprof
The /sys/pprof
endpoint is used to query. The response returned by these endpoints are equivalent to those returned by the http/pprof
package.
Index
This endpoint returns an HTML page listing the available profiles.
Method | Path |
---|---|
|
|
Sample request
Allocs
This endpoint returns a sampling of historical memory allocations over the life of the program.
Method | Path |
---|---|
|
|
Sample request
Block
This endpoint returns a sampling of goroutines involved in blocking on synchronization primitives.
It is included for completeness, but since Vault doesn't normally enable collection of this data, it won't return anything useful with the standard Vault binary.
Method | Path |
---|---|
|
|
Sample request
Cmdline
This endpoint returns the running program's command line, with arguments separated by NUL bytes.
Method | Path |
---|---|
|
|
Sample request
Goroutine
This endpoint returns stack traces of all current goroutines.
Method | Path |
---|---|
|
|
Parameters
debug
(int: 0)
- Specifies special arguments for the collection. A value of2
results in the stack traces being returned as text instead of the default pprof format.
Sample request
Heap
This endpoint returns a sampling of memory allocations of live object.
Method | Path |
---|---|
|
|
Sample request
Mutex
This endpoint returns a sampling of goroutines holding contended mutexes.
It is included for completeness, but since Vault doesn't normally enable collection of this data, it won't return anything useful with the standard Vault binary.
Method | Path |
---|---|
|
|
Sample request
Profile
This endpoint returns a pprof-formatted cpu profile payload. Profiling lasts for duration specified in seconds GET parameter, or for 30 seconds if not specified.
Method | Path |
---|---|
|
|
Parameters
seconds
(int: 30)
- Specifies the duration to run the profiling command. This value is specified as a query parameter.
Sample request
Symbol
This endpoint returns the program counters listed in the request.
Method | Path |
---|---|
|
|
Sample request
Threadcreate
This endpoint returns stack traces of goroutines that led to the creation of new OS threads.
Method | Path |
---|---|
|
|
Sample request
Trace
This endpoint returns the execution trace in binary form. Tracing lasts for duration specified in seconds GET parameter, or for 1 second if not specified.
Method | Path |
---|---|
|
|
Parameters
seconds
(int: 1)
- Specifies the duration to run the tracing command. This value is specified as a query parameter.
Sample request
Last updated