go語言日志實現詳解(打印日志、日志寫入文件和日志切割)

Posted on by

Go語言內置的log包實現瞭簡單的日志服務

log包定義瞭Logger類型，該類型提供瞭一些格式化輸出的方法。本包也提供瞭一個預定義的“標準”logger，可以通過調用函數Print系列(Print|Printf|Println）、Fatal系列（Fatal|Fatalf|Fatalln）、和Panic系列（Panic|Panicf|Panicln）來使用，比自行創建一個logger對象更容易使用。

Logger

package main

import (
	"log"
)

func main() {
	log.Println("這是一條測試的日志。")
	v := "很普通的"
	log.Printf("這是一條%s日志。\n", v)
	log.Fatalln("這是一條會觸發fatal的日志。")
	log.Panicln("這是一條會觸發panic的日志。")
}

標準logger的配置

SetFlags函數用來設置標準logger的輸出配置。

const (
    // 控制輸出日志信息的細節，不能控制輸出的順序和格式。
    // 輸出的日志在每一項後會有一個冒號分隔：例如2009/01/23 01:23:23.123123 /a/b/c/d.go:23: message
    Ldate         = 1 << iota     // 日期：2009/01/23
    Ltime                         // 時間：01:23:23
    Lmicroseconds                 // 微秒級別的時間：01:23:23.123123（用於增強Ltime位）
    Llongfile                     // 文件全路徑名+行號： /a/b/c/d.go:23
    Lshortfile                    // 文件名+行號：d.go:23（會覆蓋掉Llongfile）
    LUTC                          // 使用UTC時間
    LstdFlags     = Ldate | Ltime // 標準logger的初始值
)

func main() {
	log.SetFlags(log.Llongfile | log.Lmicroseconds | log.Ldate)
	log.Println("這是一條很普通的日志。")
}

配置日志前綴（SetPrefix）

func main() {
	log.SetFlags(log.Llongfile | log.Lmicroseconds | log.Ldate)
	log.Println("這是一條很普通的日志。")
	log.SetPrefix("[哈哈哈]")
	log.Println("這是一條很普通的日志。")
}

配置日志輸出位置

SetOutput函數用來設置標準logger的輸出目的地，默認是標準錯誤輸出。

func init() {
	logFile, err := os.OpenFile("./xx.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
	if err != nil {
		fmt.Println("open log file failed, err:", err)
		return
	}
	log.SetOutput(logFile)
	log.SetFlags(log.Llongfile | log.Lmicroseconds | log.Ldate)
}

創建新logger對象

log標準庫中還提供瞭一個創建新logger對象的構造函數–New，支持我們創建自己的logger示例。New函數的簽名如下：

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

New創建一個Logger對象。其中，參數out設置日志信息寫入的目的地。參數prefix會添加到生成的每一條日志前面。參數flag定義日志的屬性（時間、文件等等）。

舉個例子：

func main() {
	logger := log.New(os.Stdout, "<New>", log.Lshortfile|log.Ldate|log.Ltime)
	logger.Println("這是自定義的logger記錄的日志。")
}
//<New>2017/06/19 14:06:51 main.go:34: 這是自定義的logger記錄的日志。

補充：Go內置的log庫功能有限，例如無法滿足記錄不同級別日志的情況，需要選擇使用第三方的日志庫，如logrus、zap等。

日志庫級別

package log

import (
	"errors"
	"fmt"
	"strings"
	"time"
)

type LogLevel uint16

//日志常量
const (
	UNKNOW LogLevel = iota
	DEBUG 
	TRACE
	INFO
	WARNIG
	ERROR
	FATAL

)
//解析日志級別
func paraLogLevel(s string) (LogLevel,error) {
	s = strings.ToLower(s)
	switch s {

	case "debug":
		return DEBUG,nil

	case "tarce":
		return TRACE,nil
	case "info":
		return INFO,nil
	case "warnig":
		return WARNIG,nil
	case "error":
		return ERROR,nil
	case "fatal":
		return FATAL,nil
	default:
		err:= errors.New("無效的日志級別")
		return UNKNOW,err
	}
}
//定義日志級別機構提
type Logger  struct{
	Level LogLevel
}
//構造器
func NewLog(levelLog string) Logger  {
	level, err := paraLogLevel(levelLog)
	if err !=nil{
		panic(err)
	}
	return Logger{
		Level: level,
	}
}
//是否能夠打印某個級別的日志
func (l Logger)  enable(logLevel LogLevel) bool {
		return l.Level >logLevel
}

func (l Logger) Debug(msg string) {
	if l.enable(DEBUG){
		now := time.Now()
		fmt.Printf("[%s] [Debug] %s",now.Format("2006-01-02 15:04:05"),msg);
	}

}

func (l Logger) Info(msg string) {
	if l.enable(INFO){
		now := time.Now()
		fmt.Printf("[%s] [Info] %s",now.Format("2006-01-02 15:04:05"),msg);
	}

}

func (l Logger) Warning(msg string) {
	if l.enable(WARNIG){
		now := time.Now()
		fmt.Printf("[%s] [Warning] %s",now.Format("2006-01-02 15:04:05"),msg);
	}

}

func (l Logger) Error(msg string) {
	if l.enable(ERROR){
		now := time.Now()
		fmt.Printf("[%s] [Error] %s",now.Format("2006-01-02 15:04:05"),msg);
	}

}

func (l Logger) Fatal(msg string) {
	if l.enable(FATAL){
		now := time.Now()
		fmt.Printf("[%s] [Fatal] %s",now.Format("2006-01-02 15:04:05"),msg);
	}

}

import "gostudy/log"

func main()  {

	newLog := log.NewLog("warnig")
	newLog.Debug("這是debug日志")
	newLog.Info("這是info日志")
	newLog.Warning("這是Warning日志")
	newLog.Error("這是ERROR日志")
	newLog.Fatal("這是FATAL日志")
}

打印結果：[2022-08-04 10:41:56] [Debug] 這是debug日志[2022-08-04 10:41:56] [Info] 這是info日志

runtime.Caller

能夠拿到文件名函數名和行號

可變參數的日志

//......interface{}表示可變的任意參數，可不傳也可傳任意長度
func (l Logger) Debug(msg string, a ...interface{}) {
	msg = fmt.Sprint(msg,a)
	if l.enable(DEBUG){
		now := time.Now()
		fmt.Printf("[%s] [Debug] %s",now.Format("2006-01-02 15:04:05"),msg);
	}

}

實現往文件裡面寫日志

1.新建fileloger.go文件，用來提供寫入日志的功能

package log

import (
	"errors"
	"fmt"
	"os"
	"path"
	"strings"
	"time"
)

type LogLevel uint16
//日志級別
const (
	UNKNOW LogLevel = iota
	DEBUG 
	TRACE
	INFO
	WARNIG
	ERROR
	FATAL

)
//解析日志
func paraLogLevel(s string) (LogLevel,error) {
	s = strings.ToLower(s)
	switch s {

	case "debug":
		return DEBUG,nil

	case "tarce":
		return TRACE,nil
	case "info":
		return INFO,nil
	case "warnig":
		return WARNIG,nil
	case "error":
		return ERROR,nil
	case "fatal":
		return FATAL,nil
	default:
		err:= errors.New("無效的日志級別")
		return UNKNOW,err
	}
}

//獲取日志的字符串格式
func getLogStr (level LogLevel) string {

	switch level {

	case DEBUG:
		return "debug"

	case TRACE:
		return "tarce"
	case INFO:
		return "info"
	case WARNIG:
		return "warnig"
	case ERROR:
		return "error"
	case FATAL:
		return "fatal"
	default:
		return "unknow"
	}
}

//定義日志的結構體
type FileLogger  struct{
	Level LogLevel
	filePath string
	fileName string
	//要打開和寫入的文件，一個日志文件一個錯誤日志文件
	fileObj *os.File
	errfileObj *os.File
	maxFileSize int64
}

//構造函數
func NewFlieLogger(LeveStr ,fp,fn string,size int64)  *FileLogger{

	level, err := paraLogLevel(LeveStr)
	if err != nil {
		panic(err)
	}
	f1 := &FileLogger{
		Level: level,
		filePath: fp,
		fileName: fn,
		maxFileSize: size,
	}
	err= f1.initFile()
	if err != nil {
		panic(err)
	}
	return f1
}

//初始化要打開和寫入的日志文件的操作
func (f *FileLogger) initFile() (error) {
	join := path.Join(f.filePath, f.fileName)
	fileObj, err := os.OpenFile(join, os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
	if err != nil {
		fmt.Printf("open log fail ,err: %v\n",err)
		return err
	}

	errFileObj, err := os.OpenFile(join+".err", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
	if err != nil {
		fmt.Printf("open log fail ,err: %v\n",err)
		return err
	}
	//日志文件都打開
	f.fileObj = fileObj;
	f.errfileObj = errFileObj;
	return  nil

}
//判斷級別
func (l FileLogger)  enable(logLevel LogLevel) bool {
		return l.Level >logLevel
}
//打印日志操作
func (f *FileLogger) Log(leve LogLevel,msg string)  {
	now := time.Now()
	if f.enable(leve){

		fmt.Fprintf(f.fileObj,"[%s] [%s] %s",now.Format("2006-01-02 15:04:05"),getLogStr(leve),msg);
	}

	if leve >ERROR{

		fmt.Fprintf(f.errfileObj,"[%s] [%s] %s",now.Format("2006-01-02 15:04:05"),getLogStr(leve),msg);
	}
}

func (l FileLogger) Debug(msg string, a ...interface{}) {
	msg = fmt.Sprint(msg,a)
	if l.enable(DEBUG){
		l.Log(DEBUG,msg)
	}

}

func (l FileLogger) Info(msg string, a ...interface{}) {
	msg = fmt.Sprint(msg,a)
	if l.enable(WARNIG){
		l.Log(WARNIG,msg)
	}

}


func (l FileLogger) Warning(msg string, a ...interface{}) {
	msg = fmt.Sprint(msg,a)
	if l.enable(WARNIG){
		l.Log(WARNIG,msg)
	}

}

func (l FileLogger) Error(msg string, a ...interface{}) {
	msg = fmt.Sprint(msg,a)
	if l.enable(ERROR){
		l.Log(ERROR,msg)
	}

}

func (l FileLogger) Fatal(msg string, a ...interface{}) {
	msg = fmt.Sprint(msg,a)
	if l.enable(FATAL){
		l.Log(FATAL,msg)
	}

}

func (f *FileLogger) Colse()  {
	f.fileObj.Close()
	f.errfileObj.Close()
}

2.測試：

func main()  {

	newLog := log.NewFlieLogger("warnig","./","now.log",100*1024*1024)
	newLog.Debug("這是debug日志")
	newLog.Info("這是info日志")
	newLog.Warning("這是Warning日志")
	newLog.Error("這是ERROR日志")
	newLog.Fatal("這是FATAL日志")
	newLog.Colse()

}

//運行兩次後，打印結果：

日志切割（按文件大小切割、按日期切割）

其實就是每次記錄文件的大小，超過瞭就重新寫一個文件。

通過Stat()函數拿到文件的一些信息

	open, _:= os.Open("文件名")
	stat, _， := open.Stat()
	stat.Size()//拿到文件大小

日期切割：

拿到文件的名稱或者檢查下有沒有當天的日志文件，沒有就創建新增。

總結

到此這篇關於go語言日志實現(打印日志、日志寫入文件和日志切割)的文章就介紹到這瞭,更多相關go語言打印日志和日志切割內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！

推薦閱讀：