k3log
一款开箱即用且高效,快捷,安全的golang日志,基于uber zap
实现日志切割,日志过期时间,动态改变日志的打印级别
导航
介绍
取名Three King Log
- 由uber zap 日志扩展而来
- 实现分隔,异步,动态级别打印,json/txt
- 以key-value形式打印日志,适合项目里使用
- 加入Dump打印数据详细类型结构,融入go-spew调度利器
文档参考
安装
go get -u github.com/ThreeKing2018/k3log
日志级别
Debug调度使用, 程序继续运行Info提示使用, 程序继续运行Warn警告使用, 程序继续运行Error错误使用, 程序继续运行Panic恐慌的,退出函数,不会退出应用唾弃,会执行deferFatal致命的,退出应用程序,不会执行defer,因为底层多一个os.ExitDump打印数据类型,方便调度,级别为:Debug
设置参数
WithFilename日志保存路径WithLogLevel日志记录级别WithMaxSize日志分割的尺寸 MBWithMaxAge分割日志保存的时间 dayWithStacktrace记录堆栈的级别WithIsStdOut是否标准输出console输出WithProjectName项目名称WithLogType日志类型,普通 或 json
使用方法
- 简单使用
Debug("debug日志", 1)
Info("info日志", 2)
Warn("warn日志", 3)
Error("error日志", 4)
Panic("panic", 5)
Fatal("fatal", 6)
Dump("dump", 7)- 开发使用
NewDevelopment("dev", "log.txt")
defer Sync()
Info("Info", "dev")
- 开发使用2
SetLogger(conf.WithIsStdOut(true),
conf.WithLogType(conf.LogJsontype))
Debug("self test", 100)- 开发使用3
SetLogger(conf.WithLogType(conf.LogJsontype), //打印json格式
conf.WithProjectName("Zelog日志"), //设置项目名称
conf.WithFilename("log.txt"), //设置输出文件名,或输出的路径
Debug("debug日志", 1)
Info("info日志", 2)
Warn("warn日志", 3)
Error("error日志", 4)
Panic("panic", 5)
Fatal("fatal", 6)- 生产使用
NewProducttion("pro", "log.txt")
defer Sync()
Error("pro", "ok")- 生产使用2
SetLogger(conf.WithLogType(conf.LogJsontype), //打印json格式
conf.WithProjectName("Zelog日志"), //设置项目名称
conf.WithFilename("log.txt"), //设置输出文件名,或输出的路径
conf.WithLogLevel(conf.InfoLevel), //设置日志级别,默认debug
conf.WithMaxAge(30), //日志保存天数,默认30天
conf.WithMaxSize(512), //多少M进行分隔日志,默认100M
conf.WithIsStdOut(false)) //是否同时输出控制台
defer Sync()
Debug("debug日志", 1)
Info("info日志", 2)
Warn("warn日志", 3)
Error("error日志", 4)
Panic("panic", 5)
Fatal("fatal", 6)动态改变日志的打印级别
Info("aa", 11)
SetLogLevel(conf.InfoLevel)
Info("info", 100)
Warn("warn", 200)
SetLogLevel(conf.ErrorLevel)
Info("info-100", 300) //这个无法输出,因为上面设置日志级别为:error
Error("err", 400)效率
runtime.GOMAXPROCS(runtime.NumCPU())
BenchmarkInfo-4 100000 10776 ns/op
BenchmarkInfo-4 200000 12442 ns/opDump的使用
- 级别为:debug
type s struct {
Name string
Age int
}
SetLogger(conf.WithIsStdOut(true))
Dump("name", "dump", "s", s{Name:"k3", Age: 2})
//{"name": "(string) (len=4) \"dump\"", "s": "(k3log.s) { Name: (string) (len=2) \"k3\", Age: (int) 2}"}