Golang简单高效的层级日志记录插件库glg的使用

glg是一个简单高效的Golang日志库，支持多级别日志记录、自定义日志级别、文件输出、网络日志等功能。

安装

go get github.com/kpango/glg

基本使用示例

package main

import (
	"github.com/kpango/glg"
)

func main() {
	// 基本日志记录
	glg.Info("info")
	glg.Infof("%s : %s", "info", "formatted")
	glg.Log("log")
	glg.Logf("%s : %s", "info", "formatted")
	glg.Debug("debug")
	glg.Debugf("%s : %s", "info", "formatted")
	glg.Warn("warn")
	glg.Warnf("%s : %s", "info", "formatted")
	glg.Error("error")
	glg.Errorf("%s : %s", "info", "formatted")
	glg.Success("ok")
	glg.Successf("%s : %s", "info", "formatted")
	glg.Fail("fail")
	glg.Failf("%s : %s", "info", "formatted")
	glg.Print("Print")
	glg.Println("Println")
	glg.Printf("%s : %s", "printf", "formatted")
}

高级功能示例

1. 设置日志级别

func main() {
	// 设置全局日志级别为ERR
	glg.Info("before setting level to ERR this message will show")
	glg.Get().SetLevel(glg.ERR)
	glg.Info("after setting level to ERR this message will not show")
	glg.Error("this log is ERR level this will show")
	glg.Get().SetLevel(glg.DEBG)
	glg.Info("log level is now DEBG, this INFO level log will show")
}

2. 文件日志输出

func main() {
	// 创建文件写入器
	infolog := glg.FileWriter("/tmp/info.log", 0666)
	errlog := glg.FileWriter("/tmp/error.log", 0666)
	defer infolog.Close()
	defer errlog.Close()

	// 配置日志输出到文件
	glg.Get().
		SetMode(glg.BOTH). // 同时输出到控制台和文件
		AddLevelWriter(glg.INFO, infolog). // INFO级别日志写入info.log
		AddLevelWriter(glg.ERR, errlog)    // ERR级别日志写入error.log

	glg.Info("This will be written to info.log")
	glg.Error("This will be written to error.log")
}

3. 自定义日志级别

func main() {
	customTag := "FINE"
	customErrTag := "CRIT"

	glg.Get().
		AddStdLevel(customTag, glg.STD, false).                    // 添加自定义日志级别
		AddErrLevel(customErrTag, glg.STD, true).                  // 添加自定义错误级别
		SetLevelColor(glg.TagStringToLevel(customTag), glg.Cyan).  // 设置自定义级别颜色
		SetLevelColor(glg.TagStringToLevel(customErrTag), glg.Red) // 设置自定义错误级别颜色

	glg.CustomLog(customTag, "custom logging")
	glg.CustomLog(customErrTag, "custom error logging")
}

4. 时间戳控制

func main() {
	glg.Get().DisableTimestamp()
	glg.Info("timestamp disabled")
	glg.Warn("timestamp disabled")
	glg.Log("timestamp disabled")
	glg.Get().EnableTimestamp()
	glg.Info("timestamp enabled")
	glg.Warn("timestamp enabled")
	glg.Log("timestamp enabled")
}

5. 行号追踪

func main() {
	glg.Info("error log shows none trace by default")
	glg.Get().SetLineTraceMode(glg.TraceLineShort)
	glg.Error("after configure TraceLineShort, error log shows short line trace")
	glg.Info("after configure TraceLineShort, info log shows short line trace")
	glg.Get().SetLineTraceMode(glg.TraceLineLong)
	glg.Error("after configure TraceLineLong, error log shows long line trace")
	glg.Info("after configure TraceLineLong, info log shows long line trace")
	glg.Get().SetLineTraceMode(glg.TraceLineNone)
	glg.Error("after configure TraceLineNone, error log without line trace")
	glg.Info("after configure TraceLineNone, info log without line trace")
}

6. JSON格式日志

func main() {
	glg.Get().EnableJSON()
	err := glg.Warn("kpango's glg", "support", "json", "logging")
	if err != nil {
		glg.Get().DisableJSON()
		glg.Error(err)
		glg.Get().EnableJSON()
	}
	
	err = glg.Info("hello", struct {
		Name   string
		Age    int
		Gender string
	}{
		Name:   "kpango",
		Age:    28,
		Gender: "male",
	}, 2020)
	if err != nil {
		glg.Get().DisableJSON()
		glg.Error(err)
		glg.Get().EnableJSON()
	}
}

7. 网络日志

// NetWorkLogger 网络日志示例
type NetWorkLogger struct{}

func (n NetWorkLogger) Write(b []byte) (int, error) {
	http.Get("http://127.0.0.1:8080/log")
	glg.Success("Requested")
	glg.Infof("RawString is %s", glg.RawString(b))
	return 1, nil
}

func main() {
	glg.Get().AddLevelWriter(glg.DEBG, NetWorkLogger{}) // 添加网络日志目标
}

8. HTTP日志处理器

func main() {
	http.Handle("/glg", glg.HTTPLoggerFunc("glg sample", func(w http.ResponseWriter, r *http.Request) {
		glg.New().
			AddLevelWriter(glg.Info, NetWorkLogger{}).
			AddLevelWriter(glg.Info, w).
			Info("glg HTTP server logger sample")
	}))

	http.ListenAndServe(":8080", nil)
}

日志模式设置

glg支持多种日志输出模式：

glg.Get().
	SetMode(glg.BOTH). // 同时输出到控制台和文件(默认是STD)
	// SetMode(glg.NONE).  // 不输出
	// SetMode(glg.WRITER). // 只输出到writer
	// SetMode(glg.BOTH).  // 同时输出到控制台和writer

glg是一个功能强大但使用简单的日志库，适合各种规模的Golang项目使用。它支持多种日志级别、自定义格式、文件输出等常见日志功能，同时保持了高性能和低内存占用。