淘先锋技术网

首页 1 2 3 4 5 6 7

在go语言gin框架中,日志是默认输出到终端的,但是我们在实际工作中,一般来说是需要记录服务器日志的。而最常用的日志库就是zap日志库,我们需要将gin在终端输出的内容通过zap日志库记录到文件中,首先我们看gin默认的日志输出:

package main

import (
	"github.com/gin-gonic/gin"
	"net/http"
)

func main() {
	r := gin.Default()
	r.GET("/", func(c *gin.Context) {
		c.String(http.StatusOK, "hello gin!")
	})
	r.Run(":80")
}

代码中我们起了一个80端口的服务,访问这个端口"/"目录时,gin在终端打印的日志如下:

但是在生产环境中,这样做显然是不符合要求的,此时我们就需要将日志输出到文件中,这时候我们就不能使用gin.Default()函数来初始化引擎了,我们会用到另一个函数:gin.New()和Engine.Use(),我们先看gin中gin.Default()的源码:

// Default returns an Engine instance with the Logger and Recovery middleware already attached.
func Default() *Engine {
	debugPrintWARNINGDefault()
	engine := New()
	engine.Use(Logger(), Recovery())
	return engine
}

我们可以发现实际上gin.Default()就是对gin.New()和Engine.Use()的一个封装而已,而Engine.Use()中的两个全局中间件就是决定我们日志记录方式的关键。那么我们要根据自己的意愿记录日志的话,那么我们就需要自己去实现这两个中间件,然后使用Engine.Use()将我们的中间件导入就可以了。在这之前,我们先来初始化我们的zap日志库:

// 此处用到另外一个第三方库lumberjack,可以实现日志切割等功能,具体的配置项可自行配置,此处是输出json格式的日志
func InitZap() {
	encoderConfig := zapcore.EncoderConfig{
		TimeKey:        "ts",
		LevelKey:       "level",
		NameKey:        "Logger",
		CallerKey:      "caller",
		FunctionKey:    zapcore.OmitKey,
		MessageKey:     "msg",
		StacktraceKey:  "stacktrace",
		LineEnding:     zapcore.DefaultLineEnding,
		EncodeLevel:    zapcore.LowercaseLevelEncoder,
		EncodeTime:     zapcore.ISO8601TimeEncoder,
		EncodeDuration: zapcore.SecondsDurationEncoder,
		EncodeCaller:   zapcore.ShortCallerEncoder,
	}
	encoder := zapcore.NewJSONEncoder(encoderConfig)

	lumberjackLogger := &lumberjack.Logger{
		Filename:   "test.log",
		MaxSize:    10,
	}
	writeSyncer := zapcore.AddSync(lumberjackLogger)
	var l zapcore.Level
	err := l.UnmarshalText([]byte("debug"))
	if err != nil {
		panic(err)
	}
	core := zapcore.NewCore(encoder, writeSyncer, l)
	lg := zap.New(core, zap.AddCaller())
	zap.ReplaceGlobals(lg)
}

接下来我们来实现上面所说的那两个中间件:

Logger()实现方法:

// GinLogger 接收gin框架默认的日志
func GinLogger() gin.HandlerFunc {
	return func(c *gin.Context) {
		start := time.Now()
		path := c.Request.URL.Path
		query := c.Request.URL.RawQuery 
		c.Next()

		cost := time.Since(start) // 本次请求的总共消耗时间
        // 写入日志
		zap.L().Info(path,
			zap.Int("status", c.Writer.Status()),
			zap.String("method", c.Request.Method),
			zap.String("path", path),
			zap.String("query", query),
			zap.String("ip", c.ClientIP()),
			zap.String("user-agent", c.Request.UserAgent()),
			zap.String("errors", c.Errors.ByType(gin.ErrorTypePrivate).String()),
			zap.Duration("cost", cost),
		)
	}
}

Recovery()实现方法:

// GinRecovery recover掉项目可能出现的panic
// 此函数是捕获panic,根据gin框架内的Recovery修改的
func GinRecovery(stack bool) gin.HandlerFunc {
	return func(c *gin.Context) {
		defer func() {
			if err := recover(); err != nil {
				var brokenPipe bool
				if ne, ok := err.(*net.OpError); ok {
					if se, ok := ne.Err.(*os.SyscallError); ok {
						if strings.Contains(strings.ToLower(se.Error()), "broken pipe") || strings.Contains(strings.ToLower(se.Error()), "connection reset by peer") {
							brokenPipe = true
						}
					}
				}

				httpRequest, _ := httputil.DumpRequest(c.Request, false)
				if brokenPipe {
					zap.L().Error(c.Request.URL.Path,
						zap.Any("error", err),
						zap.String("request", string(httpRequest)),
					)
					c.Error(err.(error)) 
					c.Abort()
					return
				}

				if stack {
					zap.L().Error("[Recovery from panic]",
						zap.Any("error", err),
						zap.String("request", string(httpRequest)),
						zap.String("stack", string(debug.Stack())),
					)
				} else {
					zap.L().Error("[Recovery from panic]",
						zap.Any("error", err),
						zap.String("request", string(httpRequest)),
					)
				}
				c.AbortWithStatus(http.StatusInternalServerError)
			}
		}()
		c.Next()
	}
}

现在我们用上我们上面编写的代码来启一个服务:


func main() {
	InitZap()
	r := gin.New()
	r.Use(GinLogger(), GinRecovery(true))
	r.GET("/", func(c *gin.Context) {
		c.String(http.StatusOK, "hello gin!")
	})
	r.Run(":80")
}

这个时候再访问一下127.0.0.1就会发现你的当前目录下多了一个test.log的文件,打开后发现里面的内容是一条json格式的日志:

{"level":"info","ts":"2022-10-20T14:09:30.815+0800","caller":"test/test_main.go:26","msg":"/","status":200,"method":"GET","path":"/","query":"","ip":"127.0.0.1","user-agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/106.0.0.0 Safari/537.36","errors":"","cost":0}

这样我们就把gin中默认输出到终端的日志记录到.log文件中了!

如果本篇博客帮助到了您,请点一个赞。感谢!