GoFrame 日志组件-基本介绍
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
创建独立的日志对象使用。