glog是通用的高性能日志管理模块,实现了强大易用的日志管理功能,是goframe开发框架的核心组件之一。

基本介绍

使用方式

  1. import "github.com/gogf/gf/os/glog"

接口文档

http://godoc.org/github.com/gogf/gf/os/glog

简要说明:

  1. glog模块固定日志文件名称格式为*.log,即固定使用.log作为日志文件名后缀。
  2. glog支持文件输出、日志级别、日志分类、调试管理、调用跟踪、链式操作、滚动切分等等丰富特性。
  3. 可以使用glog.New方法创建glog.Logger对象用于自定义日志打印,也可以并推荐使用glog默认提供的包方法来打印日志。
  4. 当使用包方法修改模块配置时,注意任何的glog.Set*设置方法都将会全局生效
  5. 日志内容默认时间格式为 时间 [级别] 内容 换行,其中时间精确到毫秒级别,级别为可选输出,内容为调用端的参数输入,换行为可选输出(部分方法自动为日志内容添加换行符号),日志内容示例:2018-10-10 12:00:01.568 [ERRO] 产生错误
  6. Print*/Debug*/Info*方法输出日志内容到标准输出(stdout),为防止日志的错乱,Notice*/Warning*/Error*/Critical*/Panic*/Fatal*方法也是将日志内容输出到标准输出(stdout)。
  7. 其中Panic*方法在输出日志信息后会引发panic错误方法,Fatal*方法在输出日志信息之后会停止进程运行,并返回进程状态码值为1(正常程序退出状态码为0)。

单例对象

goframe v1.9版本开始,提供了g.Log()单例对象,开发者可以通过给定不同的单例名称管理不同的日志单例对象。单例对象在第一次使用时会执行初始化,初始化时会自动读取配置文件中的相关日志配置。因此,如果使用单例对象,开发者都不需要自行管理日志对象的配置,一切通过配置文件管理即可,极大提高组件的维护效率。

glog.Printg.Log().Print区别

  • glog是日志组件的包名,g.Log()是一个日志组件单例对象。
  • g.Log()单例对象通过对象管理组件g包来维护,对象初始化时会自动读取日志配置,使用简便,大多数场景下推荐使用这种方式使用日志组件。
  • glog通过独立组件的形式使用,默认情况下会直接输出日志到终端。也可以通过配置管理方法设置全局配置,或者通过New创建独立的日志对象使用。

Content Menu