mtfosbot/vendor/github.com/gin-contrib/pprof/README.md
2018-10-11 11:20:08 +08:00

1.9 KiB

pprof

Build Status codecov Go Report Card GoDoc Join the chat at https://gitter.im/gin-gonic/gin

gin pprof middleware

Package pprof serves via its HTTP server runtime profiling data in the format expected by the pprof visualization tool.

Usage

Start using it

Download and install it:

$ go get gopkg.in/gin-contrib/pprof.v1

Import it in your code:

import "gopkg.in/gin-contrib/pprof.v1"

Example:

package main

import (
	"github.com/gin-contrib/pprof"
	"github.com/gin-gonic/gin"
)

func main() {
  router := gin.Default()
  pprof.Register(router, nil)
  router.Run(":8080")
}

change default path prefix:

func main() {
	router := gin.Default()
	pprof.Register(router, &pprof.Options{
		// default is "debug/pprof"
		RoutePrefix: "debug/pprof",
	})
	router.Run(":8080")
}

Use the pprof tool

Then use the pprof tool to look at the heap profile:

go tool pprof http://localhost:8080/debug/pprof/heap

Or to look at a 30-second CPU profile:

go tool pprof http://localhost:8080/debug/pprof/profile

Or to look at the goroutine blocking profile, after calling runtime.SetBlockProfileRate in your program:

go tool pprof http://localhost:8080/debug/pprof/block

Or to collect a 5-second execution trace:

wget http://localhost:8080/debug/pprof/trace?seconds=5