glog
是通用的高性能日志管理模块,实现了强大易用的日志管理功能,是GoFrame
开发框架的核心组件之一。
使用方式:
import "github.com/gogf/gf/v2/os/glog" |
接口文档:
https://pkg.go.dev/github.com/gogf/gf/v2/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
组件具有以下显著特性:
Writer
输出接口Handler
处理CtxKeys
键值JSON
格式打印Flags
特性Rotate
滚动切分特性日志组件支持单例模式,使用g.Log(单例名称)
获取不同的单例日志管理对象。提供单例对象的目的在于针对不同业务场景可以使用不同配置的日志管理对象。我们推荐使用g.Log()
方法获取单例对象来进行日志操作,该方法内部会自动读取配置文件并初始化单例对象,该初始化操作仅会执行一次。
glog.Print
和g.Log().Print
区别glog
是日志组件的包名,g.Log()
是一个日志组件单例对象。g.Log()
单例对象通过对象管理组件g
包来维护,对象初始化时会自动读取日志配置,使用简便,大多数场景下推荐使用这种方式使用日志组件。glog
通过独立组件的形式使用,默认情况下会直接输出日志到终端。也可以通过配置管理方法设置全局配置,或者通过New
创建独立的日志对象使用。网友:为什么会有两种日志打印方式?我应该用哪种方式呢? 回答: 由于框架的每个组件都是解耦化设计的,框架是可以作为独立的工具库使用的。比如项目只需要使用日志组件,那么可以直接使用 |