本文内容纲要:

- glog 的使用与特性

- 通用功能

- vmodule 功能

- traceLocation 功能

- 日志格式

- glog 的实现

- 参考

golang/glog 是 C++ 版本 google/glog 的 Go 版本实现,基本实现了原生 glog 的日志格式。在 Kuberntes 中,glog 是默认日志库。

glog 的使用与特性

通用功能

glog 将日志级别分为 4 种,分别是:

os.Exit()

glog 的使用很简单,可参考下面这个例子:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
package main

import (
"flag"

"github.com/golang/glog"
)

func main() {
flag.Parse()
defer glog.Flush()

glog.Info("This is info message")
glog.Infof("This is info message: %v", 12345)
glog.InfoDepth(1, "This is info message", 12345)

glog.Warning("This is warning message")
glog.Warningf("This is warning message: %v", 12345)
glog.WarningDepth(1, "This is warning message", 12345)

glog.Error("This is error message")
glog.Errorf("This is error message: %v", 12345)
glog.ErrorDepth(1, "This is error message", 12345)

glog.Fatal("This is fatal message")
glog.Fatalf("This is fatal message: %v", 12345)
glog.FatalDepth(1, "This is fatal message", 12345)
}

当我们运行:

1
$ mkdir -p log && go run main.go -log_dir=log -alsologtostderr
log/-alsologtostderr
log/
1
2
3
4
5
6
7
8
main.INFO -> main.ut1.test.log.INFO.20180715-130428.27339
main.WARNING -> main.ut1.test.log.WARNING.20180715-130428.27339
main.ERROR -> main.ut1.test.log.ERROR.20180715-130428.27339
main.FATAL -> main.ut1.test.log.FATAL.20180715-130428.27339
main.ut1.test.log.ERROR.20180715-130428.27339
main.ut1.test.log.FATAL.20180715-130428.27339
main.ut1.test.log.INFO.20180715-130428.27339
main.ut1.test.log.WARNING.20180715-130428.27339
main.INFOINFO

vmodule 功能

glog 最常用的就是 V level 的功能,如下所示:

1
2
3
4
5
6
7
8
9
func main() {
flag.Parse()
defer glog.Flush()

glog.V(3).Info("LEVEL 3 message") // 使用日志级别 3
glog.V(4).Info("LEVEL 4 message") // 使用日志级别 4
glog.V(5).Info("LEVEL 5 message") // 使用日志级别 5
glog.V(8).Info("LEVEL 8 message") // 使用日志级别 8
}

当我们重新运行:

1
$ go run main.go -log_dir=log -alsologtostderr
-v
1
$ go run main.go -v=4 -log_dir=log -alsologtostderr

此时,日志级别小于或等于 4 的日志将被打印出来:

1
2
I0715 13:15:41.380611   29471 main.go:13] LEVEL 3 message
I0715 13:15:41.388777 29471 main.go:14] LEVEL 4 message

如果我们想对不同的文件实行不同的日志级别,可以用 vmodule 功能,如下代码:

1
2
3
4
5
6
7
8
9
10
func main() {
flag.Parse()
defer glog.Flush()

bar()
glog.V(3).Info("LEVEL 3 message")
glog.V(4).Info("LEVEL 4 message")
glog.V(5).Info("LEVEL 5 message")
glog.V(8).Info("LEVEL 8 message")
}
bar()bar.go
1
2
3
func bar() {
glog.V(4).Info("LEVEL 4: level 4 message in bar.go")
}

当我们执行:

1
$ go run main.go bar.go -v=3 -log_dir=log -alsologtostderr -vmodule=bar=5
-v=3bar.go-vmodule.go-vmodule=recordio=2,file=1,gfs*=3
1
2
I0715 13:20:28.381611   30447 bar.go:6] LEVEL 4: level 4 message in bar.go
I0715 13:20:28.383866 30447 main.go:14] LEVEL 3 message

通过该功能,可以对指定模块采用不同日志级别的输出,可有效提升调试效率。

traceLocation 功能

-log_backtrace_at=gopherflakes.go:234
1
$ go run main.go bar.go -v=3 -log_dir=log -alsologtostderr -vmodule=bar=5 -log_backtrace_at=bar.go:6

可见如下输出:

1
2
3
I0715 13:28:17.915837   31920 bar.go:6] LEVEL 4: level 4 message in bar.go
... 打印 backtrace,此处省略 ...
I0715 13:28:17.923715 31920 main.go:14] LEVEL 3 message

日志格式

从上面的例子可以看出,glog 打印的日志基本格式为:

1
<header>] <message>
]
1
Lmmdd hh:mm:ss.uuuuuu threadid file:line
L
1
2
3
4
I -> INFO
W -> WARNING
E -> ERROR
F -> FATAL
threadidthreadidos.Getpid()
glog.goformatHeader()

glog 的实现

其实,用 Go 实现一个日志库并不困难,其本质就是:在 buffer 中写入格式化的内容并定期刷入文件中。glog 的基本实现逻辑也是如此。

参考

本文内容总结:glog 的使用与特性,通用功能,vmodule 功能,traceLocation 功能,日志格式,glog 的实现,参考,

原文链接:https://www.cnblogs.com/sunsky303/p/11081165.html