内容简介:日志中打印源码文件名和行号,是非常实用的功能,尤其是开发阶段的debug日志,可以快速通过日志找到对应的源码位置。Go标准库中的标准库中所有的日志打印最后都要调用
日志中打印源码文件名和行号,是非常实用的功能,尤其是开发阶段的debug日志,可以快速通过日志找到对应的源码位置。
Go标准库中的 package log
也支持打印源码文件名和行号,打开方式是设置以下两个标志中的任意一个:
Llongfile // full file name and line number: /a/b/c/d.go:23 Lshortfile // final file name element and line number: d.go:23. overrides Llongfile
标准库中所有的日志打印最后都要调用 Output
函数,再在里面调用 runtime.Caller
获取源码文件名和行号:
// package log func (l *Logger) Output(calldepth int, s string) error // package runtime func Caller(skip int) (pc uintptr, file string, line int, ok bool)
runtime.Caller
获取源码文件名和行号的方式,是通过查询调用堆栈的信息得到的,这也是为什么调用方需要传入获取栈的层数,也即 skip
参数。
而 Go 中的调用栈,和runtime协程管理栈帧相关。我没有系统学习过这部分内容,所以就不展开分析了,我们直接benchmark数据说话。
先直接对 runtime.Caller
做benchmark:
//BenchmarkRuntimeCaller-4 2417739 488 ns/op 216 B/op 2 allocs/op func BenchmarkRuntimeCaller(b *testing.B) { for n := 0; n < b.N; n++ { runtime.Caller(0) } }
单次大概是500纳秒左右的耗时。我们将 skip
参数从0增大到2:
//BenchmarkRuntimeCaller2-4 1213971 983 ns/op 216 B/op 2 allocs/op func BenchmarkRuntimeCaller2(b *testing.B) { for n := 0; n < b.N; n++ { runtime.Caller(2) } }
可以看到耗时增加到接近1微妙。
我们分别对打印源码文件名,和不打印源码文件名的标准库做benchmark对比:
//BenchmarkLog-4 754929 1672 ns/op 0 B/op 0 allocs/op func BenchmarkLog(b *testing.B) { fp, _ := os.Create("/dev/null") log.SetOutput(fp) log.SetFlags(0) b.ResetTimer() for n := 0; n < b.N; n++ { log.Printf("a") } } //BenchmarkLogWith-4 344067 3403 ns/op 216 B/op 2 allocs/op func BenchmarkLogWith(b *testing.B) { fp, _ := os.Create("/dev/null") log.SetOutput(fp) log.SetFlags(log.Lshortfile) b.ResetTimer() for n := 0; n < b.N; n++ { log.Printf("a") } }
可以看到耗时增加了一倍。benchmark的源码: https://github.com/q191201771/naza/blob/master/playground/p12/p12_test.go
有意思的是,标准库中可能也觉得获取源码文件名的操作太耗时了,所以在调用 runtime.Caller
前会先释放锁,等调用结束后,再把锁加回来。这么做锁的粒度是小了点,但是锁的操作变多了。个人觉得还不如把 runtime.Caller
的调用移到头次加锁的前面,这样既减少锁粒度,又不增加拿锁的次数。
另外,标准库中,将获取日志时间的 time.Now
调用放在了加锁之前,这么做锁的粒度是小了,但是极端情况下,可能先调用 time.Now
的协程后获取到锁,也即日志中可能出现后面的日志比前面的日志时间还要早的情况。
另外,标准库中把源码文件名和行号打印在行首,我个人不太喜欢,因为文件名和行号不是定长的,这将导致业务上的日志的起始位置不是固定的,看起来很别扭,我更习惯将文件名和行号打印到行尾。
另外,聊一下 c/c++
,它们通过 __FILE__, __LINE__, __func__,
这三个宏来获取源码文件名、行号、函数,这些宏会在编译的时候替换为所在源码位置中的文件名等信息。开销比Go要小很多。
最后,我根据自己日常的使用习惯,也写了一个日志库,供参考。github地址: https://github.com/q191201771/naza
本文完,作者 yoko ,尊重劳动人民成果,转载请注明原文出处: https://pengrl.com/p/20050/
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持 码农网
猜你喜欢:- 获取python文件扩展名和文件名方法
- IIS短文件名泄露漏洞
- Linux查找处理文件名后包含空格的文件(两种方法)
- [译] 深度:Linux kernel 支持 UTF-8 文件名
- Linux 5.10.3 发布,修复加密文件名重复的问题
- 如何在Linux/Unix上使用awk打印文件名
本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们。