golang 日志log与logrus示例详解_Golang

一、go 标准库 log 详解

1. 功能特点

log 是 go 语言标准库中一个简单的日志库，主要功能包括：

写入日志到指定位置（默认为标准错误）
支持_fatal 和 _error 等级别的日志
支持格式化日志输出

2. 常用函数

log 包中常用的函数如下：

函数名	功能
log.print	输出日志
log.printf	格式化输出日志
log.println	输出日志，自动换行
log.fatal	输出日志并调用 os.exit(1)
log.fatalf	格式化输出日志并退出
log.panic	输出日志并引发 panic
log.panicln	格式化输出日志并引发 panic
log.setflags	设置日志格式（日期、时间等）
log.setoutput	设置日志输出目标

3. 示例代码

package main  
import (  
    "log"  
    "os"  
)  
func main() {  
    // 1. 默认输出到标准错误  
    log.println("这是一条普通日志")  
    // 2. 格式化输出  
    name := "alice"  
    age := 30  
    log.printf("用户 %s 已经 %d 岁了\n", name, age)  
    // 3. 设置日志输出目标为文件  
    file, err := os.openfile("log.txt", os.o_wronly|os.o_create|os.o_append, 0644)  
    if err != nil {  
        log.fatal(err)  
    }  
    log.setoutput(file)  
    log.println("日志已切换到文件输出")  
    // 4. 设置日志格式（默认包含时间信息）  
    log.setflags(log.lstdflags)  
    //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                          // 如果设置了ldate或ltime，则使用utc而不是本地时区
	//lmsgprefix                    // 将“前缀”从行首移动到消息之前
	//lstdflags     = ldate | ltime // 标准logger的初始值，包含日期和时间
    log.println("这是一条包含时间的日志")  
    log.panic("panic\n")
	//log.fatal("fatal\n")
}

4. 优势和局限

优势：

内置库，使用简单，不需要额外依赖。
支持基本的日志输出和格式化。

局限：

功能较简单，不支持多日志级别（如 debug、info、warning 等）。
不支持 json 格式化输出。
不支持日志轮转（logrotate）。

二、第三方库 logrus 详解

1. 功能特点

logrus 是 go 语言中一个功能强大的日志库，主要特点如下：

支持多种日志级别：debug、info、warning、error、fatal、panic
支持两种输出格式：text 和 json
支持日志轮转（结合 lumberjack 包）
支持钩子（hooks）机制，扩展日志处理逻辑
支持多种输出目标（文件、网络、console 等）

2. 核心功能

以下是 logrus 的核心功能：

1 .多日志级别

logger.debug("调试日志")  
logger.info("信息日志")  
logger.warn("警告日志")  
logger.error("错误日志")  
logger.fatal("致命错误")  
logger.panic("panic 日志")

2. 格式化输出

logger.withfields(logrus.fields{  
    "username": "alice",  
    "age":       30,  
}).info("用户信息")

3. 切换输出格式

// 切换到 json 格式  
logger.setformatter(&logrus.jsonformatter{})  
// 配置日志格式为 text（默认）
//logger.setformatter(&logrus.textformatter{})

4.设置日志输出目标

logger.setoutput(os.stdout) // 输出到标准输出

5. 日志轮转（结合 lumberjack）

// 须import(
    lumberjack "gopkg.in/natefinch/lumberjack.v2"
)
writer := &lumberjack.logger{  
    filename:   "logs/app.log",  
    maxsize:     500, // mb  
    maxbackups:  3,  
    maxage:      28, // days  
    compress:   true,  
}  
logger.setoutput(writer)

3. 示例代码

以下是一个完整的 logrus 示例代码，包含日志级别、格式化、文件轮转和钩子功能：

package main  
import (  
    "log"  
    "os"  
    "os/signal"  
    "syscall"  
    "time"  
    lumberjack "gopkg.in/natefinch/lumberjack.v2" 
    "github.com/sirupsen/logrus"  
)  
func main() {  
    // 1. 创建 logger 实例  
    logger := logrus.new()  
    // 2. 配置日志级别  
    logger.setlevel(logrus.infolevel)  
    // 3. 配置日志格式为 json  
    logger.setformatter(&logrus.jsonformatter{})  
    // 4. 配置日志轮转  
    writer := &lumberjack.logger{  
        filename:   "logs/app.log",  
        maxsize:     500, // mb  
        maxbackups:  3,  
        maxage:      28, // days  
        compress:   true,  
    }  
    logger.setoutput(writer)  
    // 5. 添加钩子（hook）  
    logger.addhook(&myhook{})  
    // 6. 写入日志  
    logger.info("这是一个 info 级别的日志")  
    // 7. 带字段的日志  
    logger.withfields(logrus.fields{  
        "username": "bob",  
        "age":      25,  
    }).error("用户未找到")  
    // 8. 处理信号  
    signalchan := make(chan os.signal, 1)  
    signal.notify(signalchan, syscall.sigint, syscall.sigterm)  
    go func() {  
        <-signalchan  
        logger.info("程序已优雅退出")  
        os.exit(0)  
    }()  
}  
// 自定义钩子示例  
type myhook struct{}  
func (*myhook) levels() []logrus.level {  
    return []logrus.level{  
        logrus.infolevel,  
        logrus.errorlevel,  
    }  
}  
func (*myhook) fire(entry *logrus.entry) error {  
    // 钩子逻辑：例如发送日志到远程服务器  
    log.printf("钩子处理：%+v\n", entry)  
    return nil  
}

4. 优势和扩展性

优势：
- 功能强大，支持多日志级别和格式化。
- 高度可定制，支持钩子机制和多种输出目标。
- 社区生态丰富，广泛应用于生产环境。
扩展性：
- 支持第三方库扩展（如日志轮转、网络输出等）。

三、总结

1. 何时选择 log？

当项目的日志需求简单（只需要基本的日志输出）。
项目不希望引入额外的依赖。

2. 何时选择 logrus？

项目需要多日志级别和格式化输出。
需要更高的可定制性和扩展性。
需要支持日志轮转和钩子机制。

3. 对比总结

特性	log	logrus
日志级别	有限（fatal、error）	多级别（debug~panic）
格式化输出	支持	支持（text/json）
日志轮转	不支持	支持（需配合 lumberjack）
钩子机制	不支持	支持
输出目标	标准输出/文件	多种（文件、网络等）
社区和扩展性	内置库	第三方库，社区丰富