1、log简介
golang内置了log
包,实现简单的日志服务。通过调用log
包的函数,可以实现简单的日志打印功能。
2、log使用
log
包中有3个系列的日志打印函数,分别print
系列、panic
系列、fatal
系列。
函数系列 | 作用 |
---|---|
单纯打印日志 | |
panic | 打印日志,抛出panic异常 |
fatal | 打印日志,强制结束程序(os.Exit(1)),defer 函数不会执行 |
2.1 简单示例
func main() {
defer fmt.Println("panic退出前处理")
log.Println("println日志")
log.Panic("panic日志")
log.Fatal("程序退出日志")
}
结果示例(实际结果不是这样的哦,因为panic,fatal会影响程序的执行):
2020/06/02 11:04:17 println日志
2020/06/02 11:04:17 panic日志
2020/06/02 11:04:17 panic退出前处理
2020/06/02 11:04:17 程序退出日志
3、log配置
3.1 标准log配置
默认情况下log只会打印出时间,但是实际情况下我们可能还需要获取文件名,行号等信息,log
包提供给我们定制的接口。
log
包提供两个标准log配置的相关方法:
func Flags() int // 返回标准log输出配置
func SetFlags(flag int) // 设置标准log输出配置
flag参数
const (
// 控制输出日志信息的细节,不能控制输出的顺序和格式。
// 输出的日志在每一项后会有一个冒号分隔:例如2009/01/23 01:23:23.123123 /a/b/c/d.go:23: message
Ldate = 1 << iota // 日期:2009/01/23
Ltime // 时间:01:23:23
Lmicroseconds // 微秒级别的时间:01:23:23.123123(用于增强Ltime位)
Llongfile // 文件全路径名+行号: /a/b/c/d.go:23
Lshortfile // 文件名+行号:d.go:23(会覆盖掉Llongfile)
LUTC // 使用UTC时间
LstdFlags = Ldate | Ltime // 标准logger的初始值
)
标准日志配置示例
func init() {
log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile)
}
func main() {
log.Println("println日志")
}
输出结果:
3.2 日志前缀配置
log
包提供两个日志前缀配置的相关函数:
func Prefix() string // 返回日志的前缀配置
func SetPrefix(prefix string) // 设置日志前缀
日志前缀配置实例
func init() {
log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile)
log.SetPrefix("success")
}
func main() {
log.Println("println日志")
}
输出结果:
3.3 日志输出位置配置
前面介绍的都是将日志输出到控制台上,golang的log
包还支持将日志输出到文件中。log
包提供了func SetOutput(w io.Writer)
函数,将日志输出到文件中。
日志输出位置配置
func init() {
log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile)
logFile, err := os.OpenFile("./c.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
if err != nil {
log.Panic("打开日志文件异常")
}
log.SetOutput(logFile)
}
func main() {
log.Println("println日志")
}
结果:日志输出到当前目录下c.log文件中
4、自定义logger
log
包为我们提供了内置函数,让我们能自定义logger。从效果上来看,就是将标题3中的标准日志配置、日志前缀配置、日志输出位置配置整合到一个函数中,使日志配置不在那么繁琐。
log
包中提供了func New(out io.Writer, prefix string, flag int) *Logger
函数来实现自定义logger。
示例
var logger *log.Logger
func init() {
logFile, err := os.OpenFile("./c.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
if err != nil {
log.Panic("打开日志文件异常")
}
logger = log.New(logFile, "success", log.Ldate | log.Ltime | log.Lshortfile)
}
func main() {
logger.Println("自定义logger")
}