Files
coredns.io/content/plugins/pprof.md
T
Miek Gieben 9d3c78f16f Sync notes from coredns
Make notes in coredns' repo to make it authoritative there.

Signed-off-by: Miek Gieben <miek@miek.nl>
2019-03-03 14:12:07 +00:00

60 lines
1.1 KiB
Markdown

+++
title = "pprof"
description = "*pprof* publishes runtime profiling data at endpoints under `/debug/pprof`."
weight = 26
tags = [ "plugin", "pprof" ]
categories = [ "plugin" ]
date = "2019-03-03T14:11:50.604429"
+++
## Description
You can visit `/debug/pprof` on your site for an index of the available endpoints. By default it
will listen on localhost:6053.
This is a debugging tool. Certain requests (such as collecting execution traces) can be slow. If
you use pprof on a live server, consider restricting access or enabling it only temporarily.
This plugin can only be used once per Server Block.
## Syntax
~~~
pprof [ADDRESS]
~~~
If not specified, ADDRESS defaults to localhost:6053.
## Examples
Enable pprof endpoints:
~~~
. {
pprof
}
~~~
And use the pprof tool to get statistics: `go tool pprof http://localhost:6053`.
Listen on an alternate address:
~~~ txt
. {
pprof 10.9.8.7:6060
}
~~~
Listen on an all addresses on port 6060:
~~~ txt
. {
pprof :6060
}
~~~
## Also See
See [Go's pprof documentation](https://golang.org/pkg/net/http/pprof/) and [Profiling Go
Programs](https://blog.golang.org/profiling-go-programs).