mirror of
https://github.com/coredns/coredns.io.git
synced 2024-04-21 12:32:00 +00:00
Make notes in coredns' repo to make it authoritative there. Signed-off-by: Miek Gieben <miek@miek.nl>
60 lines
1.1 KiB
Markdown
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).
|