golang日志框架zap簡(jiǎn)潔配置

$ 前言

• zap是uber開源的一款高性能日志組件框架

$ 配置目標(biāo)

• 錯(cuò)誤信息獨(dú)立的文件記錄
• 日志按天分割,一天一個(gè)文件
• 只保留近七天的日志
• 錯(cuò)誤日志輸出堆棧

$ 參考項(xiàng)目地址

http://www.itdecent.cn/p/ed748eae96c9

源碼

package base

import (
    "fmt"
    rotatelogs "github.com/lestrrat-go/file-rotatelogs"
    "go.uber.org/zap"
    "go.uber.org/zap/zapcore"
    "io"
    "os"
    "time"
)

var Log *zap.SugaredLogger

const (
    output_dir = "./logs/"
    out_path   = "foot.log"
    err_path   = "foot.err"
)

func init() {
    _, err := os.Stat(output_dir)
    if err != nil {
        if os.IsNotExist(err) {
            err := os.Mkdir(output_dir, os.ModePerm)
            if err != nil {
                fmt.Printf("mkdir failed![%v]\n", err)
            }
        }
    }

    // 設(shè)置一些基本日志格式 具體含義還比較好理解，直接看zap源碼也不難懂
    encoder := zapcore.NewConsoleEncoder(zapcore.EncoderConfig{
        MessageKey: "msg",
        LevelKey:   "level",
        TimeKey:    "ts",
        //CallerKey:      "file",
        CallerKey:     "caller",
        StacktraceKey: "trace",
        LineEnding:    zapcore.DefaultLineEnding,
        EncodeLevel:   zapcore.LowercaseLevelEncoder,
        //EncodeLevel:    zapcore.CapitalLevelEncoder,
        EncodeCaller: zapcore.ShortCallerEncoder,
        EncodeTime: func(t time.Time, enc zapcore.PrimitiveArrayEncoder) {
            enc.AppendString(t.Format("2006-01-02 15:04:05"))
        },
        //EncodeDuration: zapcore.SecondsDurationEncoder,
        EncodeDuration: func(d time.Duration, enc zapcore.PrimitiveArrayEncoder) {
            enc.AppendInt64(int64(d) / 1000000)
        },
    })

    // 實(shí)現(xiàn)兩個(gè)判斷日志等級(jí)的interface
    infoLevel := zap.LevelEnablerFunc(func(lvl zapcore.Level) bool {
        return true
    })

    warnLevel := zap.LevelEnablerFunc(func(lvl zapcore.Level) bool {
        return lvl >= zapcore.WarnLevel
    })

    // 獲取 info、warn日志文件的io.Writer 抽象 getWriter() 在下方實(shí)現(xiàn)
    infoHook_1 := os.Stdout
    infoHook_2 := getWriter(out_path)
    errorHook := getWriter(err_path)

    // 最后創(chuàng)建具體的Logger
    core := zapcore.NewTee(
        zapcore.NewCore(encoder, zapcore.AddSync(infoHook_1), infoLevel),
        zapcore.NewCore(encoder, zapcore.AddSync(infoHook_2), infoLevel),
        zapcore.NewCore(encoder, zapcore.AddSync(errorHook), warnLevel),
    )

    // 需要傳入 zap.AddCaller() 才會(huì)顯示打日志點(diǎn)的文件名和行數(shù), 有點(diǎn)小坑
    logger := zap.New(core, zap.AddCaller(), zap.AddStacktrace(zap.ErrorLevel))
    Log = logger.Sugar()
    defer logger.Sync()
}

func getWriter(filename string) io.Writer {
    // 生成rotatelogs的Logger 實(shí)際生成的文件名 demo.log.YYmmddHH
    // demo.log是指向最新日志的鏈接
    // 保存7天內(nèi)的日志，每1小時(shí)(整點(diǎn))分割一次日志
    hook, err := rotatelogs.New(
        // 沒有使用go風(fēng)格反人類的format格式
        output_dir+filename+".%Y%m%d",
        rotatelogs.WithLinkName(filename),
        rotatelogs.WithMaxAge(time.Hour*24*7),
        rotatelogs.WithRotationTime(time.Hour*24),
    )
    if err != nil {
        panic(err)
    }
    return hook
}

使用

package main

import "tesou.io/platform/foot-parent/foot-api/common/base"

func main() {
    base.Log.Info("日志1")
    base.Log.Info("日志2")
    base.Log.Error("錯(cuò)誤的日志")
    base.Log.Info("日志3")

}