对于日志输出即时性要求不高的内容,可以通过异步的方式输出日志,异步输出使得日志打印调用可立即返回,因此效率较高。 glog 当然支持异步输出特性,并且内部使用了 goroutine 池来管理异步日志打印任务,可以充分的降低对资源的占用率。

异步输出可以通过日志对象的 SetAsync/ SetFlags 方法,或者通过链式操作 Async 方法实现。但是需要注意的是,如果通过对象设置方法设置异步输出,那么后续所有的日志输出都将是异步的;如果是通过链式操作输出,那么仅对当前日志输出为异步。

日志组件-异步输出 - 图1注意

如果对于同一个文件日志输出既采用了同步打印,也采用了异步打印,注意日志文件的内容可能会出现乱序问题,这种情况应当尽量避免。

SetAsync

我们来看一个使用 SetAsync 方法实现异步打印的示例。

  1. package main
  2. import (
  3. "context"
  4. "time"
  5. "github.com/gogf/gf/v2/frame/g"
  6. )
  7. func main() {
  8. ctx := context.TODO()
  9. g.Log().SetAsync(true)
  10. for i := 0; i < 10; i++ {
  11. g.Log().Print(ctx, "async log", i)
  12. }
  13. }

执行后,可以发现终端什么内容也没有输出,因为日志输出的异步的,该示例在日志内容还没有输出之前就退出了。因此,我们可以稍做改进如下:

  1. package main
  2. import (
  3. "context"
  4. "time"
  5. "github.com/gogf/gf/v2/frame/g"
  6. )
  7. func main() {
  8. ctx := context.TODO()
  9. g.Log().SetAsync(true)
  10. for i := 0; i < 10; i++ {
  11. g.Log().Print(ctx, "async log", i)
  12. }
  13. time.Sleep(time.Second)
  14. }

执行后,终端输出结果为:

  1. 2019-06-02 15:44:21.399 async log 0
  2. 2019-06-02 15:44:21.399 async log 1
  3. 2019-06-02 15:44:21.399 async log 2
  4. 2019-06-02 15:44:21.399 async log 3
  5. 2019-06-02 15:44:21.399 async log 4
  6. 2019-06-02 15:44:21.399 async log 5
  7. 2019-06-02 15:44:21.399 async log 6
  8. 2019-06-02 15:44:21.399 async log 7
  9. 2019-06-02 15:44:21.399 async log 8
  10. 2019-06-02 15:44:21.399 async log 9

Async 链式操作

使用链式操作比较简单。

  1. package main
  2. import (
  3. "context"
  4. "time"
  5. "github.com/gogf/gf/v2/frame/g"
  6. )
  7. func main() {
  8. ctx := context.TODO()
  9. for i := 0; i < 10; i++ {
  10. g.Log().Async().Print(ctx, "async log", i)
  11. }
  12. g.Log().Print(ctx, "normal log")
  13. g.Log().Print(ctx, "normal log")
  14. g.Log().Print(ctx, "normal log")
  15. time.Sleep(time.Second)
  16. }

执行后,终端输出结果为:

  1. 2022-01-05 15:00:44.101 normal log
  2. 2022-01-05 15:00:44.101 async log 0
  3. 2022-01-05 15:00:44.101 async log 1
  4. 2022-01-05 15:00:44.101 async log 2
  5. 2022-01-05 15:00:44.101 async log 3
  6. 2022-01-05 15:00:44.101 async log 4
  7. 2022-01-05 15:00:44.101 async log 5
  8. 2022-01-05 15:00:44.101 async log 6
  9. 2022-01-05 15:00:44.101 async log 7
  10. 2022-01-05 15:00:44.101 async log 8
  11. 2022-01-05 15:00:44.101 async log 9
  12. 2022-01-05 15:00:44.101 normal log
  13. 2022-01-05 15:00:44.103 normal log