golang 日志log与logrus示例详解

 更新时间:2025年03月31日 12:00:56   作者:草海桐  
log是Go语言标准库中一个简单的日志库,本文给大家介绍golang 日志log与logrus示例详解,感兴趣的朋友一起看看吧

一、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 语言中一个功能强大的日志库,主要特点如下:

  • 支持多种日志级别:DebugInfoWarningErrorFatalPanic
  • 支持两种输出格式: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. 对比总结

特性loglogrus
日志级别有限(Fatal、Error)多级别(Debug~Panic)
格式化输出支持支持(Text/JSON)
日志轮转不支持支持(需配合 lumberjack)
钩子机制不支持支持
输出目标标准输出/文件多种(文件、网络等)
社区和扩展性内置库第三方库,社区丰富

到此这篇关于golang 日志log与logrus的文章就介绍到这了,更多相关golang 日志log与logrus内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 深入解析Go语言编程中slice切片结构

    深入解析Go语言编程中slice切片结构

    这篇文章主要介绍了Go语言编程中slice切片结构,其中Append方法的用法介绍较为详细,需要的朋友可以参考下
    2015-10-10
  • 使用Go语言中的Context取消协程执行的操作代码

    使用Go语言中的Context取消协程执行的操作代码

    在 Go 语言中,协程(goroutine)是一种轻量级的线程,非常适合处理并发任务,然而,如何优雅地取消正在运行的协程是一个常见的问题,本文将通过一个具体的例子来展示如何使用 context 包来取消协程的执行,需要的朋友可以参考下
    2024-11-11
  • Golang中Gin框架的使用入门教程

    Golang中Gin框架的使用入门教程

    这篇文章主要为大家详细介绍了Golang中Gin框架的使用教程,文中通过简单的示例为大家讲解了Gin框架的安装与使用,感兴趣的小伙伴开业跟随小编一起学习一下
    2022-10-10
  • golang网络通信超时设置方式

    golang网络通信超时设置方式

    这篇文章主要介绍了golang网络通信超时设置方式,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-12-12
  • 一文深入探索Go语言中的循环结构

    一文深入探索Go语言中的循环结构

    在编程中,循环结构扮演着重要的角色,它使我们能够有效地重复执行特定的代码块,以实现各种任务和逻辑,在Go语言中,for 是 Go 中唯一的循环结构,本文将深入探讨Go语言中的for循环类型以及它们的用法
    2023-08-08
  • Go语言实现优雅关机和重启的示例详解

    Go语言实现优雅关机和重启的示例详解

    优雅的关机是指在关闭服务之前,先让服务处理完当前正在处理的请求,然后再关闭服务,本文主要为大家详细介绍了如何使用Go语言实现优雅关机和重启,感兴趣的小伙伴可以参考一下
    2025-04-04
  • Golang 中反射的应用实例详解

    Golang 中反射的应用实例详解

    这篇文章主要为大家介绍了Golang 中反射的应用实例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-08-08
  • 一文搞懂Golang中的内存逃逸

    一文搞懂Golang中的内存逃逸

    内存逃逸是 Go 语言中一个重要的概念,涉及到程序的性能优化和内存管理,了解内存逃逸可以帮助我们编写更高效的代码,本文将从基本概念入手,深入讲解 Go 语言中的内存逃逸现象,以及如何避免,需要的朋友可以参考下
    2023-12-12
  • go语言中函数的用法示例详解

    go语言中函数的用法示例详解

    Go语言中函数是基本的代码组织单元,用于封装一段代码,使代码结构更清晰、可复用,本文详细讲解了基本函数定义、参数传递、返回值、多返回值、匿名函数、递归和defer语句的使用,感兴趣的朋友一起看看吧
    2024-10-10
  • golang如何使用struct的tag属性的详细介绍

    golang如何使用struct的tag属性的详细介绍

    这篇文章主要介绍了golang如何使用struct的tag属性的详细介绍,从例子说起,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-11-11

最新评论