Go Web编程添加服务器错误和访问日志

 更新时间:2022年06月25日 11:24:56   作者:KevinYan11  
这篇文章主要为大家介绍了Go Web编程添加服务器错误日志和访问日志的示例解析,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪

前言

错误日志和访问日志是一个服务器必须支持的功能,我们教程里使用的服务器到目前为止还没有这两个功能。正好前两天也写了篇介绍logrus日志库的文章,那么今天的文章里就给我们自己写的服务器加上错误日志和访问日志的功能。在介绍添加访问日志的时候会介绍一种通过编写中间件获取HTTP响应的StausCodeBody的方法。

Go Web 编程系列的每篇文章的源代码都打了对应版本的软件包,供大家参考。公众号中回复gohttp11获取本文源代码

初始化日志记录器

我们先来做一下初始化工作,在项目里初始化记录错误日志和访问日志的记录器Logger

// ./utils/vlog
package vlog
import (
    "github.com/sirupsen/logrus"
    "os"
)
var ErrorLog *logrus.Logger
var AccessLog *logrus.Logger
var errorLogFile = "./tmp/log/error.log"
var accessLogFile = "./tmp/log/access.log"
func init () {
    initErrorLog()
    initAccessLog()
}
func initErrorLog() {
    ErrorLog = logrus.New()
    ErrorLog.SetFormatter(&logrus.JSONFormatter{})
    file , err := os.OpenFile(errorLogFile, os.O_RDWR | os.O_CREATE | os.O_APPEND, 0755)
    if err != nil {
        panic(err)
    }
    ErrorLog.SetOutput(file)
}
func initAccessLog() {
    AccessLog = logrus.New()
    AccessLog.SetFormatter(&logrus.JSONFormatter{})
    file , err := os.OpenFile(accessLogFile, os.O_RDWR | os.O_CREATE | os.O_APPEND, 0755)
    if err != nil {
        panic(err)
    }
    AccessLog.SetOutput(file)
}
  • 我们新定义一个packageinit函数中来初始化记录器,这样服务器成功启动前就会初始化好记录器。
  • /tmp/log这个目录要提前创建好,执行init函数时会自动创建好access.logerror.log

添加错误日志

我们创建服务器使用的net/http包的Server类型中,有一个ErrorLog字段供开发者设置记录错误日志用的记录器Logger,默认使用的是log包默认的记录器(应该是系统的标准错误):

type Server struct {
   Addr    string  // TCP address to listen on, ":http" if empty
   Handler Handler // handler to invoke, http.DefaultServeMux if nil
   ...
   // ErrorLog specifies an optional logger for errors accepting
   // connections, unexpected behavior from handlers, and
   // underlying FileSystem errors.
   // If nil, logging is done via the log package's standard logger.
   ErrorLog *log.Logger
     ...
}

我们之前在创建服务器的时候自己实现了Server类型的对象,那么现在要做的就是将上面初始化好的错误日志的记录器指定给ServerErrorLog字段。

func main() {
  ...
    // 将logrus的Logger转换为io.Writer
    errorWriter := vlog.ErrorLog.Writer()
    // 记得关闭io.Writer
    defer errorWriter.Close()
    server := &http.Server{
        Addr:    ":8080",
        Handler: muxRouter,
        // 用记录器转换成的io.Writer创建log.Logger
        ErrorLog: log.New(vlog.ErrorLog.Writer(), "", 0),
    }
    ...
}

添加好错误日志的记录器后,我们找个路由处理函数,在里面故意制造运行时错误验证一下是否能记录到错误。

func (*HelloHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
   ints := []int{0, 1, 2}
   fmt.Fprintf(w, "%v", ints[0:5])
}

在上面处理函数中,通过切片表达式越界故意制造了一个运行时错误,打开error.log后能看到文件里已经记录到这个运行时错误及其Stack trace

添加访问日志

Server对象可以设置错误日志的记录器不一样,访问日志只能是我们通过自己编写中间件的方式来实现了。在记录访问日志的中间件里我们会记录ipmethodpathqueryrequest_bodystatusresponse_body这些个字段的内容。

statusresponse_body两个字段来自请求对应的响应。响应在net/http包里是用http.ResponseWriter接口表示的

type ResponseWriter interface {
    Header() Header
    Write([]byte) (int, error)
    WriteHeader(statusCode int)
}

接口本身以及net/http提供的实现都没有让我们进行读取的方法,所以在编写的用于记录访问日志的中间件里需要对net/http库本身实现的ResponseWriter做一层包装。

利用Go语言结构体类型嵌套匿名类型后,结构体拥有了被嵌套类型的所有导出字段和方法的特性,我们可以很方便地对原来的ResponseWriter做一层包装,然后只重新实现需要更改的方法即可:

type ResponseWithRecorder struct {
   http.ResponseWriter
   statusCode int
   body bytes.Buffer
}
func (rec *ResponseWithRecorder) WriteHeader(statusCode int) {
   rec.ResponseWriter.WriteHeader(statusCode)
   rec.statusCode = statusCode
}
func (rec *ResponseWithRecorder) Write(d []byte) (n int, err error) {
   n, err = rec.ResponseWriter.Write(d)
   if err != nil {
      return
   }
   rec.body.Write(d)
   return
}

定义好新的类型后我们重新实现了WriteHeaderWrite方法,在向原来的ReponseWriter中写入后也会向ResponseWriteRecoder.statusCode和ResponseWriteRecoder.body写入对应的数据。这样我们就可以在中间件里通过这两个字段访问响应码和响应数据了。

记录访问日志的中间件定义如下:

func AccessLogging (f http.Handler) http.Handler {
    // 创建一个新的handler包装http.HandlerFunc
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        buf := new(bytes.Buffer)
        buf.ReadFrom(r.Body)
        logEntry := vlog.AccessLog.WithFields(logrus.Fields{
            "ip": r.RemoteAddr,
            "method": r.Method,
            "path": r.RequestURI,
            "query": r.URL.RawQuery,
            "request_body": buf.String(),
        })
        wc := &ResponseWithRecorder{
            ResponseWriter: w,
            statusCode: http.StatusOK,
            body: bytes.Buffer{},
        }
        // 调用下一个中间件或者最终的handler处理程序
        f.ServeHTTP(wc, r)
        defer logEntry.WithFields(logrus.Fields{
            "status": wc.statusCode,
            "response_body": wc.body.String(),
        }).Info()
    })
}

Router上应用创建好的AccessLogging中间件后,就可以正常的记录服务器的访问日志了。

// router/router.go
func RegisterRoutes(r *mux.Router) {
    ...
    // apply Logging middleware
    r.Use(middleware.Logging(), middleware.AccessLogging)
    ...
}

不过有两点需要注意一下

  • 这里为了演示获取响应数据记录了response_body字段,如果是接口响应内容记录下还可以,但是如果是HTML还是不记录的为好。
  • 初始化ResponseWithRecorder时默认设置了statusCode是因为,服务器正确返回响应时不会显式调用WriteHeader方法,只有在返回NOT_FOUND之类的错误的时候才会调用WriteHeader方法,针对这种情况需要在初始化的时候把statusCode的默认值设置为200

现在再访问服务器后打开access.log会看到刚刚的访问日志,就能看到刚刚请求的urlmethod,客户端IP等信息了。

{"ip":"......","level":"info","method":"GET","msg":"","path":"/index/","query":"","request_body":"","response_body":"Hello World1","status":200,"time":"2020-03-26T04:21:46Z"}

注意:文章只为说明演示方便,获取IP的方法无法获取代理后的真实IP,请悉知。

以上就是Go Web编程添加服务器错误和访问日志的详细内容,更多关于Go Web服务器错误访问日志的资料请关注脚本之家其它相关文章!

相关文章

  • 在Go语言项目中使用Zap日志库的操作过程

    在Go语言项目中使用Zap日志库的操作过程

    本文将先介绍Go语言原生的日志库的使用,然后详细介绍非常流行的Uber开源的zap日志库,同时会介绍如何搭配·Lumberjack·实现日志的切割和归档,对Go使用Zap日志库相关知识感兴趣的朋友一起看看吧
    2024-03-03
  • 详解Go语言如何判断两个对象是否相等

    详解Go语言如何判断两个对象是否相等

    在编程中,判断两个对象是否相等是一项常见的任务,同时判断对象是否相等在很多情况下都非常重要,所以在接下来的内容中,我们将详细介绍在 Go 语言中如何判断对象是否相等的方法和技巧,需要的可以参考一下
    2023-06-06
  • Go 实现 WebSockets之创建 WebSockets

    Go 实现 WebSockets之创建 WebSockets

    这篇文章主要介绍了Go 实现 WebSockets之创建 WebSockets,文章主要探索 WebSockets,并简要介绍了它们的工作原理,并仔细研究了全双工通信,想了解更多相关内容的小伙伴可以参考一下
    2022-04-04
  • golang实现openssl自签名双向认证的详细步骤

    golang实现openssl自签名双向认证的详细步骤

    这篇文章主要介绍了golang实现openssl自签名双向认证的详细步骤,本文分步骤给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2024-03-03
  • Go语言学习之数组的用法详解

    Go语言学习之数组的用法详解

    数组是相同数据类型的一组数据的集合,数组一旦定义长度不能修改,数组可以通过下标(或者叫索引)来访问元素。本文将通过示例详细讲解Go语言中数组的使用,需要的可以参考一下
    2022-04-04
  • Golang将Map的键值对调的实现示例

    Golang将Map的键值对调的实现示例

    本文主要介绍了Golang将Map的键值对调的实现示例,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-02-02
  • golang中日期操作之日期格式化及日期转换

    golang中日期操作之日期格式化及日期转换

    在编程中,程序员会经常使用到日期相关操作,下面这篇文章主要给大家介绍了关于golang中日期操作之日期格式化及日期转换的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
    2022-11-11
  • Go到底能不能实现安全的双检锁(推荐)

    Go到底能不能实现安全的双检锁(推荐)

    这篇文章主要介绍了Go到底能不能实现安全的双检锁,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-05-05
  • 详解Go语言如何实现二叉树遍历

    详解Go语言如何实现二叉树遍历

    这篇文章主要为大家详解介绍了Go语言中如何实现二叉树遍历,文中的示例代码讲解详细,对我们学习Go语言有一定帮助,需要的可以参考一下
    2022-04-04
  • go浮点数转字符串保留小数点后N位的完美解决方法

    go浮点数转字符串保留小数点后N位的完美解决方法

    这篇文章主要介绍了go浮点数转字符串保留小数点后N位解决办法,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-05-05

最新评论