glog
是通用的高性能日志管理模块,实现了强大易用的日志管理功能,是gf
开发框架的核心模块之一。
基本介绍
使用方式:
import "github.com/gogf/gf/os/glog"
接口文档:
http://godoc.org/github.com/gogf/gf/os/glog
简要说明:
glog
模块固定日志文件名称格式为*.log
,即固定使用.log
作为日志文件名后缀。glog
支持文件输出、日志级别、日志分类、调试管理、调用跟踪、链式操作、滚动切分等等丰富特性。- 可以使用
glog.New
方法创建glog.Logger
对象用于自定义日志打印,也可以并推荐使用glog
默认提供的包方法来打印日志。 - 当使用包方法修改模块配置时,注意任何的
glog.Set*
设置方法都将会全局生效。 - 日志内容默认时间格式为
时间 [级别] 内容 换行
,其中时间
精确到毫秒级别,级别
为可选输出,内容
为调用端的参数输入,换行
为可选输出(部分方法自动为日志内容添加换行符号),日志内容示例:2018-10-10 12:00:01.568 [ERRO] 产生错误
。 Print*/Debug*/Info*
方法输出日志内容到标准输出(stdout
),为防止日志的错乱,Notice*/Warning*/Error*/Critical*/Panic*/Fatal*
方法也是将日志内容输出到标准输出(stdout
)。- 其中
Panic*
方法在输出日志信息后会引发panic
错误方法,Fatal*
方法在输出日志信息之后会停止进程运行,并返回进程状态码值为1
(正常程序退出状态码为0
)。
glog.Print
和g.Log().Print
区别
glog
是日志组件的包名,g.Log()
是一个日志组件单例对象。g.Log()
单例对象通过对象管理组件g
包来维护,对象初始化时会自动读取日志配置,使用简便,大多数场景下推荐使用这种方式使用日志组件。glog
通过独立组件的形式使用,默认情况下会直接输出日志到终端。也可以通过配置管理方法设置全局配置,或者通过New
创建独立的日志对象使用。