go-extend: github.com/thinkeridea/go-extend/exnet/exhttp/expprof Index | Files

package expprof

import "github.com/thinkeridea/go-extend/exnet/exhttp/expprof"

Package expprof 这是从 net/http/pprof 包复制过来的,做了一些调整 我希望核心的逻辑不变,保持和标准库一致的功能,会调整使用的接口,使之易于控制。

我为什么会有这样的想法,主要源于自己想对程序的性能做分析,但是每次都需要调整程序并重新发布, 这极大的浪费了我的时间,在调整完之后我需要调整代码,去除 net/http/pprof 包,因为该包会暴露默认路由, 这容易导致三方服务来分析我的程序,是极度危险的情况。

我想通过暴露简单的接口实现自定义路由前缀,并且可以使用内网中间件来过滤接口只允许内网访问。

疑惑:我不知道这么做是否真的好,但是我感觉自己需要这个功能,暂时我还不清楚 pprof 包采集数据的原理,是否会一直采集数据, 采集数据是否会对程序运行有影响,这让我有些迷茫,我简单查看了源码,貌似有些数据程序是一直采集的,但是有些数据是访问过指定功能后开始持续采集的, 像 CPUProfile 是可以在程序内开关的,这导致我无法确定接口一直可用是否会对程序运行有影响,但是这个功能确实非常有用,随着我的学习这些疑惑应该会逐步解决, 所以是否使用该包由用户自己决定,如果你了解这些可以及时联系我进行交流。

原生 net/http 使用示例:

expprof.RoutePrefix = "/debug/"
http.HandleFunc(expprof.RoutePrefix, func(w http.ResponseWriter, r *http.Request) {
	if !exnet.HasLocalIPddr(exnet.ClientIP(r)) {
		w.WriteHeader(http.StatusNotFound)
		return
	}

	expprof.ServeHTTP(w, r)
})

log.Println(http.ListenAndServe("localhost:6060", nil))

gin 使用示例:

    expprof.RoutePrefix = "/debug/"
	g := gin.Default()
	g.GET(expprof.RoutePrefix+"*cmd", func(c *gin.Context) {
		if !exnet.HasLocalIPddr(exnet.ClientIP(c.Request)) {
			c.Status(http.StatusNotFound)
			c.Abort()
		}
	}, gin.WrapF(expprof.ServeHTTP))

	g.Run(":6060")

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

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

Or to look at a 30-second CPU profile:

go tool pprof http://localhost:6060/debug/pprof/profile?seconds=30

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

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

Or to collect a 5-second execution trace:

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

Or to look at the holders of contended mutexes, after calling runtime.SetMutexProfileFraction in your program:

go tool pprof http://localhost:6060/debug/pprof/mutex

To view all available profiles, open http://localhost:6060/debug/pprof/ in your browser.

For a study of the facility in action, visit

https://blog.golang.org/2011/06/profiling-go-programs.html

Index

Package Files

doc.go pprof.go

Variables

var (
    // RoutePrefix 路由前缀,必须与实际路由匹配,否者无法解析
    RoutePrefix = "/pprof/"
)

func ServeHTTP Uses

func ServeHTTP(w http.ResponseWriter, r *http.Request)

ServeHTTP http.HandlerFunc 接口

Package expprof imports 15 packages (graph). Updated 2019-02-12. Refresh now. Tools for package owners.