Documentation ¶
Overview ¶
包 glog 实现了强大且易于使用的分级日志功能。
Index ¶
- Constants
- func Error(上下文 context.Context, 值 ...interface{})
- func X中间件函数Json(上下文 context.Context, in *HandlerInput)
- func X中间件函数文本结构化输出(上下文 context.Context, in *HandlerInput)
- func X取Writer() io.Writer
- func X取上下文名称() []interface{}
- func X取堆栈信息(偏移量 ...int) string
- func X取文件路径() string
- func X取标识() int
- func X取级别() int
- func X取级别前缀(级别 int) string
- func X设置Writer(writer io.Writer)
- func X设置debug(开启 bool)
- func X设置上下文名称(名称 ...interface{})
- func X设置中间件(处理函数 ...Handler)
- func X设置前缀(前缀 string)
- func X设置堆栈跟踪(开启 bool)
- func X设置异步输出(开启 bool)
- func X设置文件名格式(文件名格式 string)
- func X设置文件是否输出颜色(开启 bool)
- func X设置文件路径(文件路径 string) error
- func X设置文本级别(级别 string) error
- func X设置是否同时输出到终端(开启 bool)
- func X设置是否输出头信息(开启 bool)
- func X设置级别(级别 int)
- func X设置级别前缀(级别 int, 前缀 string)
- func X设置级别前缀Map(前缀Map map[int]string)
- func X设置配置Map(m map[string]interface{}) error
- func X设置配置项(配置项 Config) error
- func X设置额外标识(标识 int)
- func X设置默认中间件(处理函数 Handler)
- func X设置默认日志类(l *Logger)
- func X输出(上下文 context.Context, 值 ...interface{})
- func X输出CRIT(上下文 context.Context, 值 ...interface{})
- func X输出DEBU(上下文 context.Context, 值 ...interface{})
- func X输出FATA(上下文 context.Context, 值 ...interface{})
- func X输出INFO(上下文 context.Context, 值 ...interface{})
- func X输出NOTI(上下文 context.Context, 值 ...interface{})
- func X输出PANI(上下文 context.Context, 值 ...interface{})
- func X输出WARN(上下文 context.Context, 值 ...interface{})
- func X输出堆栈信息(上下文 context.Context, 偏移量 ...int)
- func X输出并格式化(上下文 context.Context, 格式 string, 值 ...interface{})
- func X输出并格式化CRIT(上下文 context.Context, 格式 string, 值 ...interface{})
- func X输出并格式化DEBU(上下文 context.Context, 格式 string, 值 ...interface{})
- func X输出并格式化ERR(上下文 context.Context, 格式 string, 值 ...interface{})
- func X输出并格式化FATA(上下文 context.Context, 格式 string, 值 ...interface{})
- func X输出并格式化INFO(上下文 context.Context, 格式 string, 值 ...interface{})
- func X输出并格式化NOTI(上下文 context.Context, 格式 string, 值 ...interface{})
- func X输出并格式化PANI(上下文 context.Context, 格式 string, 值 ...interface{})
- func X输出并格式化WARN(上下文 context.Context, 格式 string, 值 ...interface{})
- type Config
- type Handler
- type HandlerInput
- type HandlerOutputJson
- type ILogger
- type Logger
- func Expose别名() *Logger
- func X创建() *Logger
- func X创建并按writer(writer io.Writer) *Logger
- func X取单例对象(名称 ...string) *Logger
- func X取默认日志类() *Logger
- func X堆栈偏移量(偏移量 int) *Logger
- func X堆栈过滤(过滤器 string) *Logger
- func X堆栈选项(开启 bool, 偏移量 ...int) *Logger
- func X文件分类(类名称 string) *Logger
- func X文件名格式(文件名格式 string) *Logger
- func X文件路径(文件路径 string) *Logger
- func X文本级别(文本级别 string) *Logger
- func X是否同时输出到终端(开启 ...bool) *Logger
- func X是否异步输出(开启 ...bool) *Logger
- func X是否输出头信息(开启 ...bool) *Logger
- func X是否输出源文件路径与行号(开启 ...bool) *Logger
- func X级别(级别 int) *Logger
- func X重定向输出(writer io.Writer) *Logger
- func (l *Logger) AppendCtxKeys(keys ...interface{})
- func (l *Logger) Error(上下文 context.Context, 值 ...interface{})
- func (l *Logger) PrintStack(ctx context.Context, skip ...int)
- func (l *Logger) Write(p []byte) (n int, err error)
- func (l *Logger) X取Writer() io.Writer
- func (l *Logger) X取上下文名称() []interface{}
- func (l *Logger) X取副本() *Logger
- func (l *Logger) X取堆栈信息(偏移量 ...int) string
- func (l *Logger) X取文件路径() string
- func (l *Logger) X取标识() int
- func (l *Logger) X取级别() int
- func (l *Logger) X取级别前缀(级别 int) string
- func (l *Logger) X取配置项() Config
- func (l *Logger) X堆栈偏移量(偏移量 int) *Logger
- func (l *Logger) X堆栈过滤(过滤器 string) *Logger
- func (l *Logger) X堆栈选项(开启 bool, 偏移量 ...int) *Logger
- func (l *Logger) X文件分类(类名称 string) *Logger
- func (l *Logger) X文件名格式(文件名格式 string) *Logger
- func (l *Logger) X文件路径(文件路径 string) *Logger
- func (l *Logger) X文本级别(文本级别 string) *Logger
- func (l *Logger) X是否同时输出到终端(开启 ...bool) *Logger
- func (l *Logger) X是否异步输出(开启 ...bool) *Logger
- func (l *Logger) X是否输出头信息(开启 ...bool) *Logger
- func (l *Logger) X是否输出源文件路径与行号(开启 ...bool) *Logger
- func (l *Logger) X级别(级别 int) *Logger
- func (l *Logger) X设置Writer(writer io.Writer)
- func (l *Logger) X设置debug(开启 bool)
- func (l *Logger) X设置上下文名称(名称 ...interface{})
- func (l *Logger) X设置中间件(处理函数 ...Handler)
- func (l *Logger) X设置关闭终端颜色输出(关闭 bool)
- func (l *Logger) X设置前缀(前缀 string)
- func (l *Logger) X设置堆栈偏移量(偏移量 int)
- func (l *Logger) X设置堆栈跟踪(开启 bool)
- func (l *Logger) X设置堆栈过滤(过滤器 string)
- func (l *Logger) X设置异步输出(开启 bool)
- func (l *Logger) X设置文件名格式(文件名格式 string)
- func (l *Logger) X设置文件是否输出颜色(开启 bool)
- func (l *Logger) X设置文件路径(文件路径 string) error
- func (l *Logger) X设置文本级别(级别 string) error
- func (l *Logger) X设置时间格式(时间格式 string)
- func (l *Logger) X设置是否同时输出到终端(开启 bool)
- func (l *Logger) X设置是否输出头信息(开启 bool)
- func (l *Logger) X设置是否输出级别(开启 bool)
- func (l *Logger) X设置级别(级别 int)
- func (l *Logger) X设置级别前缀(级别 int, 前缀 string)
- func (l *Logger) X设置级别前缀Map(前缀Map map[int]string)
- func (l *Logger) X设置配置Map(m map[string]interface{}) error
- func (l *Logger) X设置配置项(配置项 Config) error
- func (l *Logger) X设置额外标识(标识 int)
- func (l *Logger) X输出(上下文 context.Context, 值 ...interface{})
- func (l *Logger) X输出CRIT(上下文 context.Context, 值 ...interface{})
- func (l *Logger) X输出DEBU(上下文 context.Context, 值 ...interface{})
- func (l *Logger) X输出FATA(上下文 context.Context, 值 ...interface{})
- func (l *Logger) X输出INFO(上下文 context.Context, 值 ...interface{})
- func (l *Logger) X输出NOTI(上下文 context.Context, 值 ...interface{})
- func (l *Logger) X输出PANI(上下文 context.Context, 值 ...interface{})
- func (l *Logger) X输出WARN(上下文 context.Context, 值 ...interface{})
- func (l *Logger) X输出并格式化(上下文 context.Context, 格式 string, 值 ...interface{})
- func (l *Logger) X输出并格式化CRIT(上下文 context.Context, 格式 string, 值 ...interface{})
- func (l *Logger) X输出并格式化DEBU(上下文 context.Context, 格式 string, 值 ...interface{})
- func (l *Logger) X输出并格式化ERR(上下文 context.Context, 格式 string, 值 ...interface{})
- func (l *Logger) X输出并格式化FATA(上下文 context.Context, 格式 string, 值 ...interface{})
- func (l *Logger) X输出并格式化INFO(上下文 context.Context, 格式 string, 值 ...interface{})
- func (l *Logger) X输出并格式化NOTI(上下文 context.Context, 格式 string, 值 ...interface{})
- func (l *Logger) X输出并格式化PANI(上下文 context.Context, 格式 string, 值 ...interface{})
- func (l *Logger) X输出并格式化WARN(上下文 context.Context, 格式 string, 值 ...interface{})
- func (l *Logger) X重定向输出(writer io.Writer) *Logger
Constants ¶
const ( F_ASYNC = 1 << iota // Print logging content asynchronously。 F_FILE_LONG // 打印完整的文件名和行号:/a/b/c/d.go:23. F_FILE_SHORT // 打印文件名的最后一个元素和行号:d.go:23。该选项覆盖了 F_FILE_LONG。 F_TIME_DATE // 在本地时区打印日期:2009-01-23。 F_TIME_TIME // 在本地时区打印时间:01:23:23 // “`go // 下面是示例代码(假设) // package main // import ( // "fmt" // "time" // ) // func main() { // 获取当前时间 // now := time.Now() // 格式化为 HH:mm:ss 的格式 // formattedTime := now.Format("15:04:05") // 打印在本地时区的时间:01:23:23 // fmt.Println(formattedTime) // } // 这段注释描述的是要在本地时区打印时间的意图,但实际代码需要获取当前时间并进行格式化以匹配指定格式。 F_TIME_MILLI // 在本地时区打印带有毫秒的时间:01:23:23.675。 F_CALLER_FN // 打印调用函数名称和包名:main.main F_TIME_STD = F_TIME_DATE | F_TIME_MILLI )
const ( COLOR_BLACK = 30 + iota COLOR_RED COLOR_GREEN COLOR_YELLOW COLOR_BLUE COLOR_MAGENTA COLOR_CYAN COLOR_WHITE )
const ( COLOR_HI_BLACK = 90 + iota COLOR_HI_RED COLOR_HI_GREEN COLOR_HI_YELLOW COLOR_HI_BLUE COLOR_HI_MAGENTA COLOR_HI_CYAN COLOR_HI_WHITE )
前景高亮度文本颜色
const ( LEVEL_ALL = LEVEL_DEBU | LEVEL_INFO | LEVEL_NOTI | LEVEL_WARN | LEVEL_ERRO | LEVEL_CRIT LEVEL_DEV = LEVEL_ALL LEVEL_PROD = LEVEL_WARN | LEVEL_ERRO | LEVEL_CRIT LEVEL_NONE = 0 LEVEL_DEBU = 1 << iota // 16 LEVEL_INFO // 32 LEVEL_NOTI // 64 LEVEL_WARN // 128 LEVEL_ERRO // 256 LEVEL_CRIT // 512 LEVEL_PANI // 1024 LEVEL_FATA // 2048 )
注意,LEVEL_PANI 和 LEVEL_FATA 级别并不用于日志输出, 而是用于前缀配置。
const (
// DefaultName 是用于实例使用的默认组名。
DefaultName = "default"
)
Variables ¶
This section is empty.
Functions ¶
func X中间件函数Json ¶
func X中间件函数Json(上下文 context.Context, in *HandlerInput)
HandlerJson 是一个处理器,用于将输出的日志内容作为单个 JSON 字符串进行处理。
func X中间件函数文本结构化输出 ¶
func X中间件函数文本结构化输出(上下文 context.Context, in *HandlerInput)
HandlerStructure 是一个处理器,用于将输出的日志内容以结构化字符串形式记录。
func X设置Writer ¶
SetWriter 设置自定义的日志 `writer` 用于日志记录。 `writer` 对象应实现 io.Writer 接口。 开发者可以使用自定义的日志 `writer` 将日志输出重定向到其他服务, 例如:kafka、mysql、mongodb 等等。
func X设置上下文名称 ¶
func X设置上下文名称(名称 ...interface{})
SetCtxKeys 为 defaultLogger 设置上下文键。这些键用于从上下文中检索值并将其打印到日志内容中。
注意,多次调用此函数会覆盖之前设置的上下文键。
func X设置文件名格式 ¶
func X设置文件名格式(文件名格式 string)
SetFile 设置文件日志的文件名`pattern`。 在`pattern`中可以使用日期时间模式,例如:access-{Ymd}.log。 默认的文件名模式是:Y-m-d.log,例如:2018-01-01.log 这段Go语言代码注释翻译成中文为: 设置文件日志的文件名为 `pattern`。 可以在 `pattern` 中使用日期时间格式化字符串,例如:access-{Ymd}.log(表示按年月日生成不同文件)。 默认的文件名格式是:Y-m-d.log,例如:2018-01-01.log
func X设置默认日志类 ¶
func X设置默认日志类(l *Logger)
SetDefaultLogger 为 glog 包设置默认日志器。 注意,如果在不同 goroutine 中调用此函数可能存在并发安全问题。
func X输出并格式化CRIT ¶
Criticalf以[CRIT]头部、自定义格式和换行符打印日志内容。 如果启用了堆栈追踪功能,它还会打印调用者堆栈信息。
func X输出并格式化DEBU ¶
Debugf按照[DEBU]头部,自定义格式及换行打印日志内容。
func X输出并格式化ERR ¶
Errorf 函数以 [ERRO] 标头、自定义格式及换行符打印日志内容。 若启用了堆栈追踪功能,它还会打印调用者堆栈信息。
func X输出并格式化FATA ¶
Fatalf 打印日志内容,其头部为[FATA],采用自定义格式,并在末尾添加换行符,然后退出当前进程。
func X输出并格式化INFO ¶
Infof 格式化并打印日志内容,带有 [INFO] 标头、自定义格式及换行。 ```go Infof 根据提供的格式和参数,以 [INFO] 头部形式输出格式化信息,并在末尾添加换行。 示例用法: log.Infof("用户 %s 登录成功", username)
func X输出并格式化NOTI ¶
Noticef函数以[NOTI]头、自定义格式及换行符打印日志内容。 如果启用了堆栈追踪功能,它还会打印调用堆栈信息。
func X输出并格式化PANI ¶
Panicf 函数会打印带有[PANI]头部、自定义格式以及换行符的日志内容,然后触发 panic。
func X输出并格式化WARN ¶
Warningf函数会打印带有[WARN]头的记录内容,使用自定义格式并添加换行符。 如果启用了堆栈功能,它还会打印调用堆栈信息。
Types ¶
type Config ¶
type Config struct { X中间件 []Handler `json:"-"` // 日志处理器实现类似中间件的功能。 Writer io.Writer `json:"-"` // 自定义 io.Writer。 X日志标识 int `json:"flags"` // 附加日志输出功能的标志。 X时间格式 string `json:"timeFormat"` // 日志时间格式 X文件路径 string `json:"path"` // 日志目录路径。 X文件名格式 string `json:"file"` // 日志文件的格式化模式。 X级别 int `json:"level"` // Output level. X前缀 string `json:"prefix"` // Prefix 字符串,用于作为每条日志内容的前缀。 X堆栈偏移量 int `json:"stSkip"` // 跳过堆栈的计数。 X堆栈状态 int `json:"stStatus"` // 栈状态(1: 启用 - 默认值; 0: 禁用) X堆栈过滤 string `json:"stFilter"` // 字符串过滤栈 X上下文名称 []interface{} `json:"ctxKeys"` // Context keys 用于日志记录,它们被用于从context中检索值。 X是否输出头信息 bool `json:"header"` // 是否打印头部信息(默认为true) X是否同时输出到终端 bool `json:"stdout"` // 是否输出到标准输出(默认为true) X是否输出级别 bool `json:"levelPrint"` // 是否打印级别格式化字符串(默认为true) X日志级别名称映射 map[int]string `json:"levelPrefixes"` // 日志级别到其前缀字符串的映射。 X文件分割大小 int64 `json:"rotateSize"` // 如果日志文件大小 > 0字节,则旋转日志文件。 X文件分割周期 time.Duration `json:"rotateExpire"` // 如果日志文件的修改时间超过这个持续时间,则旋转日志文件。 X文件分割保留数量 int `json:"rotateBackupLimit"` // Max 备份文件数量,默认为0,表示不进行备份。 X文件分割过期时间 time.Duration `json:"rotateBackupExpire"` // Max 为轮转文件设置的过期时间,默认为0,表示永不过期。 X文件压缩级别 int `json:"rotateBackupCompress"` // Compress level for rotated files using gzip algorithm. It's 0 in default, means no compression. X文件分割检查间隔 time.Duration `json:"rotateCheckInterval"` // Asynchronously checks the backups and expiration at intervals. It's 1 hour in default. X关闭终端颜色输出 bool `json:"stdoutColorDisabled"` // 是否(默认为false)在向writer输出时,以颜色前缀形式记录日志级别 X文件是否输出颜色 bool `json:"writerColorEnable"` // 是否(默认为false)在向writer输出时,以颜色前缀形式记录日志级别 // contains filtered or unexported fields }
Config 是 logger 的配置对象。
type HandlerInput ¶
type HandlerInput struct { Logger *Logger // 当前日志器对象。 X缓冲区 *bytes.Buffer // Buffer,用于日志内容输出。 X时间 time.Time // 日志时间,即触发日志记录的时间。 X格式化时间 string // 格式化的时间字符串,如 "2016-01-09 12:00:00"。 X颜色 int // 使用颜色,如COLOR_RED、COLOR_BLUE等。例如:34 X级别 int // 使用级别,如 LEVEL_INFO, LEVEL_ERRO 等。例如:256 X文本级别 string // 格式化的级别字符串,如 "DEBU", "ERRO" 等。例如:ERRO X源文件函数名 string // 如果设置了F_CALLER_FN,该变量记录调用日志函数的源函数名。 X源文件路径与行号 string // 调用日志记录的源文件路径及其行号,仅在设置了 F_FILE_SHORT 或 F_FILE_LONG 时可用。 X上下文值 string // 从context中获取的字符串类型的上下文值,但只有在配置了Config.CtxKeys时才可用。 X链路跟踪ID string // 跟踪ID,仅在启用OpenTelemetry时可用。 X前缀 string // 自定义日志内容前缀字符串。 X日志内容 string // Content 是由 logger 生成的、不包含错误堆栈信息的主要日志内容。 X未格式化数组 []any // 传递给 logger 的未格式化的值数组。 Stack string // Stack 字符串由 logger 生成,仅在配置了 Config.StStatus 时可用。 X是否为异步 bool // IsAsync 标记它处于异步日志记录状态。 // contains filtered or unexported fields }
HandlerInput 是 logging Handler 的输入参数结构体。
func (*HandlerInput) Next ¶
func (in *HandlerInput) Next(ctx context.Context)
Next 以中间件方式调用下一个日志处理程序。
func (*HandlerInput) String ¶
func (in *HandlerInput) String(withColor ...bool) string
String 返回由默认日志处理程序格式化的日志内容。
type HandlerOutputJson ¶
type HandlerOutputJson struct { X时间 string `json:""` // 格式化的时间字符串,如 "2016-01-09 12:00:00"。 X链路跟踪ID string `json:",omitempty"` // 跟踪ID,仅在启用跟踪时可用。 X上下文值 string `json:",omitempty"` // 从context中获取的字符串类型的上下文值,但只有在配置了Config.CtxKeys时才可用。 X级别 string `json:""` // 格式化的级别字符串,如 "DEBU", "ERRO" 等。例如:ERRO X源文件路径与行号 string `json:",omitempty"` // 调用日志记录的源文件路径及其行号,仅在设置了 F_FILE_SHORT 或 F_FILE_LONG 时可用。 X源文件函数名 string `json:",omitempty"` // 如果设置了F_CALLER_FN,该变量记录调用日志函数的源函数名。 X前缀 string `json:",omitempty"` // 自定义日志内容前缀字符串。 Stack string `json:",omitempty"` // Stack 字符串由 logger 生成,仅在配置了 Config.StStatus 时可用。 // contains filtered or unexported fields }
HandlerOutputJson 是一个结构体,用于将日志内容以单个 JSON 的形式输出。
type ILogger ¶
type ILogger interface { X输出(上下文 context.Context, 值 ...interface{}) X输出并格式化(上下文 context.Context, 格式 string, 值 ...interface{}) X输出DEBU(上下文 context.Context, 值 ...interface{}) X输出并格式化DEBU(上下文 context.Context, 格式 string, 值 ...interface{}) X输出INFO(上下文 context.Context, 值 ...interface{}) X输出并格式化INFO(上下文 context.Context, 格式 string, 值 ...interface{}) X输出NOTI(上下文 context.Context, 值 ...interface{}) X输出并格式化NOTI(上下文 context.Context, 格式 string, 值 ...interface{}) X输出WARN(上下文 context.Context, 值 ...interface{}) X输出并格式化WARN(上下文 context.Context, 格式 string, 值 ...interface{}) Error(上下文 context.Context, 值 ...interface{}) X输出并格式化ERR(上下文 context.Context, 格式 string, 值 ...interface{}) X输出CRIT(上下文 context.Context, 值 ...interface{}) X输出并格式化CRIT(上下文 context.Context, 格式 string, 值 ...interface{}) X输出PANI(上下文 context.Context, 值 ...interface{}) X输出并格式化PANI(上下文 context.Context, 格式 string, 值 ...interface{}) X输出FATA(上下文 context.Context, 值 ...interface{}) X输出并格式化FATA(上下文 context.Context, 格式 string, 值 ...interface{}) }
ILogger 是 logger 的 API 接口。
type Logger ¶
type Logger struct {
// contains filtered or unexported fields
}
Logger 是用于日志管理的结构体。
func X创建并按writer ¶
NewWithWriter 通过 io.Writer 创建并返回一个自定义的日志记录器。
func X是否同时输出到终端 ¶
Stdout 是一个链式函数, 用于启用/禁用当前日志内容输出到标准输出(stdout)。 默认情况下它是启用的。
func X是否输出源文件路径与行号 ¶
Line 是一个链式函数, 它用于启用/禁用在输出时附带调用者文件及其行号。 参数 `long` 指定是否打印完整的绝对文件路径,例如:/a/b/c/d.go:23。
func (*Logger) AppendCtxKeys ¶
func (l *Logger) AppendCtxKeys(keys ...interface{})
AppendCtxKeys 向日志器追加额外键。 如果该键之前已向日志器追加过,则忽略此次操作。
func (*Logger) PrintStack ¶
PrintStack 打印调用栈, 可选参数 `skip` 指定了从终点开始需要跳过的堆栈偏移量。
func (*Logger) X文件分类 ¶
Cat 是一个链式函数, 它用于为当前日志内容输出设置类别为 `category`。 参数 `category` 可以是层级式的,例如:module/user。
func (*Logger) X是否同时输出到终端 ¶
Stdout 是一个链式函数, 用于启用/禁用当前日志内容输出到标准输出(stdout)。 默认情况下它是启用的。
func (*Logger) X是否输出源文件路径与行号 ¶
Line 是一个链式函数, 它用于启用/禁用在输出时附带调用者所在的文件路径及行号。 参数 `long` 指定了是否打印完整的绝对文件路径,例如:/a/b/c/d.go:23, 否则只打印简短形式:d.go:23。
func (*Logger) X设置Writer ¶
SetWriter 设置自定义的日志 `writer` 用于日志记录。 `writer` 对象应实现 io.Writer 接口。 开发者可以使用自定义的日志 `writer` 将日志输出重定向到其他服务, 例如:kafka、mysql、mongodb 等。
func (*Logger) X设置上下文名称 ¶
func (l *Logger) X设置上下文名称(名称 ...interface{})
SetCtxKeys 设置日志器的上下文键。这些键用于从上下文中检索值并将其打印到日志内容中。
注意,多次调用此函数将覆盖之前设置的上下文键。
func (*Logger) X设置关闭终端颜色输出 ¶
SetStdoutColorDisabled 禁用 stdout 日志颜色输出。
func (*Logger) X设置文件名格式 ¶
SetFile 设置文件日志的文件名`pattern`。 在`pattern`中可以使用日期时间模式,例如:access-{Ymd}.log。 默认的文件名模式是:Y-m-d.log,例如:2018-01-01.log 这段Go语言代码注释翻译成中文为: 设置文件日志的文件名为 `pattern`。 可以在 `pattern` 中使用日期时间格式化字符串,例如:access-{Ymd}.log(表示按年月日生成不同文件)。 默认的文件名格式是:Y-m-d.log,例如:2018-01-01.log
func (*Logger) X设置文件是否输出颜色 ¶
SetWriterColorEnable 开启文件/写入器日志的彩色输出功能。
func (*Logger) X设置是否同时输出到终端 ¶
SetStdoutPrint 设置是否将日志内容输出到标准输出(stdout),默认为true。
func (*Logger) X设置是否输出头信息 ¶
SetHeaderPrint 设置是否输出日志内容的头部,默认为true。
func (*Logger) X设置级别 ¶
SetLevel 设置日志记录级别。 注意,对于日志内容,级别 `LEVEL_CRIT | LEVEL_PANI | LEVEL_FATA` 不能被移除, 这些级别会自动添加到现有级别中。
func (*Logger) X设置级别前缀Map ¶
SetLevelPrefixes 为日志器设置级别到前缀字符串的映射。
func (*Logger) X输出并格式化CRIT ¶
Criticalf以[CRIT]头部、自定义格式和换行符打印日志内容。 如果启用了堆栈追踪功能,它还会打印调用者堆栈信息。
func (*Logger) X输出并格式化DEBU ¶
Debugf按照[DEBU]头部,自定义格式及换行打印日志内容。
func (*Logger) X输出并格式化ERR ¶
Errorf 函数以 [ERRO] 标头、自定义格式及换行符打印日志内容。 若启用了堆栈追踪功能,它还会打印调用者堆栈信息。
func (*Logger) X输出并格式化FATA ¶
Fatalf 打印日志内容,其头部为[FATA],采用自定义格式,并在末尾添加换行符,然后退出当前进程。
func (*Logger) X输出并格式化INFO ¶
Infof 格式化并打印日志内容,带有 [INFO] 标头、自定义格式及换行。 ```go Infof 根据提供的格式和参数,以 [INFO] 头部形式输出格式化信息,并在末尾添加换行。 示例用法: log.Infof("用户 %s 登录成功", username)
func (*Logger) X输出并格式化NOTI ¶
Noticef函数以[NOTI]头、自定义格式及换行符打印日志内容。 如果启用了堆栈追踪功能,它还会打印调用堆栈信息。
func (*Logger) X输出并格式化PANI ¶
Panicf 函数会打印带有[PANI]头部、自定义格式以及换行符的日志内容,然后触发 panic。
func (*Logger) X输出并格式化WARN ¶
Warningf函数会打印带有[WARN]头的记录内容,使用自定义格式并添加换行符。 如果启用了堆栈功能,它还会打印调用堆栈信息。
Source Files ¶
- glog.go
- glog_api.go
- glog_chaining.go
- glog_config.go
- glog_instance.go
- glog_logger.go
- glog_logger_api.go
- glog_logger_chaining.go
- glog_logger_color.go
- glog_logger_config.go
- glog_logger_handler.go
- glog_logger_handler_json.go
- glog_logger_handler_structure.go
- glog_logger_level.go
- glog_logger_rotate.go
- glog_logger_writer.go