天天看點

Golang學習筆記之日志log、zap

一、log日志包

log支援并發操作。其結構定義如下:

1type Logger struct {
2    mu sync.Mutex     // ensures atomic writes; protects the following fields
3    prefix string     // prefix to write at beginning of each line // ⽇志⾏字首
4    flag int          // properties // ⽇志列印格式标志,⽤于指定每⾏⽇志的列印格式
5    out io.Writer     // destination for output // ⽤于指定⽇志輸出位置,理論上可以是任務地⽅,隻要實作了io.Writer接⼝就⾏
6    buf []byte        // for accumulating text to write // ⽇志内容
7}           

log基本日志格式

1Ldate       = 1 << iota     //  形如  2009/01/23  的⽇期
2Ltime                       //  形如  01:23:23            的時間
3Lmicroseconds               //  形如  01:23:23.123123         的時間
4Llongfile                   //  全路徑⽂件名和⾏号:  /a/b/c/d.go:23  
5Lshortfile                  //  ⽂件名和⾏号: d.go:23 
6LstdFlags   = Ldate | Ltime //  ⽇期和時間           

(1)Golang's log子產品主要提供了3類接口。分别是 “Print 、Panic 、Fatal ”,對每一類接口其提供了3中調用方式,分别是 "Xxxx 、Xxxxln 、Xxxxf",基本和fmt中的相關函數類似。

• log.Print:列印日志,和fmt.包沒什麼差別,隻是加上了上面的日志格式

• log.Fatal :,會先将日志内容列印到标準輸出,接着調用系統的os.exit(1) 接口,退出程式并傳回狀态 1 。但是有一點需要注意,由于是直接調用系統接口退出,defer函數不會被調用。

• log.Panic:該函數把日志内容刷到标準錯誤後調用 panic 函數,

demo

1package main
 2
 3import (
 4    "fmt"
 5    "log"
 6)
 7//fatal
 8func testDeferfatal() {
 9    defer func() {
10        fmt.Println("--first--")
11    }()
12    log.Fatalln("test for defer Fatal")
13}
14//panic
15func testDeferpanic() {
16    defer func() {
17        fmt.Println("--first--")
18        if err := recover(); err != nil {
19            fmt.Println(err)
20        }
21    }()
22    log.Panicln("test for defer Panic")
23    defer func() {
24        fmt.Println("--second--")
25    }()
26}
27func main() {
28    arr := []int{2, 3}
29
30    log.Print("Print array ", arr, "\n")
31    log.Println("Println array", arr)
32    log.Printf("Printf array with item [%d,%d]\n", arr[0], arr[1])
33
34    testDeferpanic()
35
36
37    testDeferfatal()
38}
           

輸出為

2018/12/17 21:28:33 Print array [2 3]

2018/12/17 21:28:33 Println array [2 3]

2018/12/17 21:28:33 Printf array with item [2,3]

2018/12/17 21:28:33 test for defer Panic

--first--

test for defer Panic

2018/12/17 21:28:33 test for defer Fatal

exit status 1

(2)你也可以自定義Logger類型

log.Logger提供了一個New方法用來建立對象

函數原型

func New(out io.Writer, prefix string, flag int) *Logger

①輸出位置out,是一個io.Writer對象,該對象可以是一個檔案也可以是實作了該接口的對象。通常我們可以用這個來指定日志輸出到哪個檔案

②prefix 我們在前面已經看到,就是在日志内容前面的東西。我們可以将其置為 "[Info]" 、 "[Warning]"等來幫助區分日志級别。

③flags 是一個選項,顯示日志開頭的東西,可選的值見前面所述

1func main() {
 2    fileName := "/Users/zt/Desktop/Info_First.log"//路徑+檔案名
 3    logFile, err := os.Create(fileName)
 4    defer logFile.Close()
 5    if err != nil {
 6        log.Fatalln("open file error")
 7    }
 8    debugLog := log.New(logFile, "[Info]", log.Llongfile)
 9    debugLog.Println("A Info message here")
10    debugLog.SetPrefix("[Debug]")
11    debugLog.Println("A Debug Message here ")
12}           

二、Zap日志包使用

uber開源的高性能日志庫

go get go.uber.org/zap

1func panic() {
 2    if err := recover(); err != nil {
 3        fmt.Println(err)
 4    }
 5}
 6func main() {
 7    url := "Hello"
 8    logger, _ := zap.NewProduction()
 9    //logger, _ := zap.NewDevelopment()
10
11    defer panic()
12    //Sync重新整理任何緩沖的日志條目。
13    defer logger.Sync()
14    logger.Info("failed to fetch URL",
15        // Structured context as strongly typed Field values.
16        zap.String("url", url),
17        zap.Int("attempt", 3),
18        zap.Duration("backoff", time.Second),
19    )
20    logger.Warn("debug log", zap.String("level", url))
21    logger.Error("Error Message", zap.String("error", url))
22    logger.Panic("Panic log", zap.String("level", url))
23}
           

(1)通過HTTP接口動态的改變日志級别

1func main() {
 2    alevel := zap.NewAtomicLevel()
 3    http.HandleFunc("/handle/level", alevel.ServeHTTP)
 4    go func() {
 5        if err := http.ListenAndServe(":9090", nil); err != nil {
 6            panic(err)
 7        }
 8    }()
 9    // 預設是Info級别
10    logcfg := zap.NewProductionConfig()
11    logcfg.Level = alevel
12    logger, err := logcfg.Build()
13    if err != nil {
14        fmt.Println("err", err)
15    }
16    defer logger.Sync()
17    for i := 0; i < 1000; i++ {
18        time.Sleep(1 * time.Second)
19        logger.Debug("debug log", zap.String("level", alevel.String()))
20        logger.Info("Info log", zap.String("level", alevel.String()))
21    }
22}


           

檢視日志級别

curl

http://localhost:9090/handle/level

輸出

Golang學習筆記之日志log、zap

調整日志級别(可選值 “debug” “info” “warn” “error” 等)

curl -XPUT --data '{"level":"debug"}'

Golang學習筆記之日志log、zap

當然也可以使用之前在Gin說過的工具RESTClient來模拟,

Golang學習筆記之日志log、zap

(2)将日志進行序列化檔案:lumberjack

支援檔案按大小或者時間歸檔

GitHub位址:

https://github.com/natefinch/lumberjack

go get github.com/natefinch/lumberjack

1package main
 2
 3import (
 4    "go.uber.org/zap"
 5    "go.uber.org/zap/zapcore"
 6    lumberjack "gopkg.in/natefinch/lumberjack.v2"
 7)
 8func initLogger(logpath string, loglevel string) *zap.Logger {
 9    hook := lumberjack.Logger{
10        Filename:   logpath, // ⽇志⽂件路徑
11        MaxSize:    1024,    // megabytes
12        MaxBackups: 3,       // 最多保留3個備份
13        MaxAge:     7,       //days
14        Compress:   true,    // 是否壓縮 disabled by default
15    }
16    w := zapcore.AddSync(&hook)
17    var level zapcore.Level
18    switch loglevel {
19    case "debug":
20        level = zap.DebugLevel
21    case "info":
22        level = zap.InfoLevel
23    case "error":
24        level = zap.ErrorLevel
25    default:
26        level = zap.InfoLevel
27    }
28    encoderConfig := zap.NewProductionEncoderConfig()
29    encoderConfig.EncodeTime = zapcore.ISO8601TimeEncoder
30    core := zapcore.NewCore(
31        zapcore.NewConsoleEncoder(encoderConfig),
32        w,
33        level,
34    )
35    logger := zap.New(core)
36    logger.Info("DefaultLogger init success")
37    return logger
38}
39func main() {
40    logger := initLogger("all.log", "info")
41    logger.Info("test log", zap.Int("line", 47))
42    logger.Warn("testlog", zap.Int("line", 47))
43}
           

在目前檔案夾下的all.log

Golang學習筆記之日志log、zap

原文釋出時間為:2018-12-22

本文作者: Golang語言社群

本文來自雲栖社群合作夥伴“

Golang語言社群

”,了解相關資訊可以關注“Golangweb”微信公衆号

繼續閱讀