Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
COREDNS-PPROF(7)		 CoreDNS Plugins		COREDNS-PPROF(7)

NAME
     pprof - publishes runtime profiling data at endpoints under /debug/pprof.

DESCRIPTION
     You  can visit /debug/pprof on your site for an index of the available end-
     points. 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 restrict-
     ing access or enabling it only temporarily.

     This plugin can only be used once per Server Block.

SYNTAX
	    pprof [ADDRESS]

     Optionally pprof takes an address; the default is localhost:6053.

     An extra option can be set with this extended syntax:

	    pprof [ADDRESS] {
	       block [RATE]
	    }

     *	 block option enables block profiling, RATE defaults to 1. RATE must  be
	 a    positive	  value.     See    Diagnostics,    chapter    profiling
	 <https://golang.org/doc/diagnostics.html> and runtime.SetBlockProfileR-
	 ate  <https://golang.org/pkg/runtime/#SetBlockProfileRate>   for   what
	 block profiling entails.

EXAMPLES
     Enable a pprof endpoint:

	    . {
		pprof
	    }

     And  use  the  pprof  tool  to  get statistics: go tool pprof http://local-
     host:6053.

     Listen on an alternate address:

	    . {
		pprof 10.9.8.7:6060
	    }

     Listen on an all addresses on port 6060, and enable block profiling

	    . {
		pprof :6060 {
		   block
		}
	    }

SEE ALSO
     See Go's pprof documentation  <https://golang.org/pkg/net/http/pprof/>  and
     Profiling Go Programs <https://blog.golang.org/profiling-go-programs>.

     See  runtime.SetBlockProfileRate <https://golang.org/pkg/runtime/#SetBlock-
     ProfileRate> for background on block profiling.

CoreDNS 			   March 2026			COREDNS-PPROF(7)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=coredns-pprof&sektion=7&manpath=FreeBSD+Ports+15.1.quarterly>

home | help