Documentation ¶
Overview ¶
Package glog implements powerful and easy-to-use levelled logging functionality.
日志模块, 直接文件/输出操作,没有异步逻辑,没有使用缓存或者通道
Index ¶
- Constants
- func Critical(v ...interface{})
- func Criticalf(format string, v ...interface{})
- func Criticalfln(format string, v ...interface{})
- func Debug(v ...interface{})
- func Debugf(format string, v ...interface{})
- func Debugfln(format string, v ...interface{})
- func Error(v ...interface{})
- func Errorf(format string, v ...interface{})
- func Errorfln(format string, v ...interface{})
- func Fatal(v ...interface{})
- func Fatalf(format string, v ...interface{})
- func Fatalfln(format string, v ...interface{})
- func GetBacktrace(skip ...int) string
- func GetLevel() int
- func GetPath() string
- func GetWriter() io.Writer
- func Info(v ...interface{})
- func Infof(format string, v ...interface{})
- func Infofln(format string, v ...interface{})
- func Notice(v ...interface{})
- func Noticef(format string, v ...interface{})
- func Noticefln(format string, v ...interface{})
- func Panic(v ...interface{})
- func Panicf(format string, v ...interface{})
- func Panicfln(format string, v ...interface{})
- func Print(v ...interface{})
- func PrintBacktrace(skip ...int)
- func Printf(format string, v ...interface{})
- func Printfln(format string, v ...interface{})
- func Println(v ...interface{})
- func SetBacktrace(enabled bool)
- func SetDebug(debug bool)
- func SetFile(pattern string)
- func SetLevel(level int)
- func SetPath(path string)
- func SetStdPrint(open bool)
- func SetWriter(writer io.Writer)
- func Warning(v ...interface{})
- func Warningf(format string, v ...interface{})
- func Warningfln(format string, v ...interface{})
- type Logger
- func (l *Logger) Backtrace(enabled bool, skip ...int) *Logger
- func (l *Logger) Cat(category string) *Logger
- func (l *Logger) Clone() *Logger
- func (l *Logger) Critical(v ...interface{})
- func (l *Logger) Criticalf(format string, v ...interface{})
- func (l *Logger) Criticalfln(format string, v ...interface{})
- func (l *Logger) Debug(v ...interface{})
- func (l *Logger) Debugf(format string, v ...interface{})
- func (l *Logger) Debugfln(format string, v ...interface{})
- func (l *Logger) Error(v ...interface{})
- func (l *Logger) Errorf(format string, v ...interface{})
- func (l *Logger) Errorfln(format string, v ...interface{})
- func (l *Logger) Fatal(v ...interface{})
- func (l *Logger) Fatalf(format string, v ...interface{})
- func (l *Logger) Fatalfln(format string, v ...interface{})
- func (l *Logger) File(file string) *Logger
- func (l *Logger) GetBacktrace(skip ...int) string
- func (l *Logger) GetLevel() int
- func (l *Logger) GetPath() string
- func (l *Logger) GetWriter() io.Writer
- func (l *Logger) Header(enabled bool) *Logger
- func (l *Logger) Info(v ...interface{})
- func (l *Logger) Infof(format string, v ...interface{})
- func (l *Logger) Infofln(format string, v ...interface{})
- func (l *Logger) Level(level int) *Logger
- func (l *Logger) Notice(v ...interface{})
- func (l *Logger) Noticef(format string, v ...interface{})
- func (l *Logger) Noticefln(format string, v ...interface{})
- func (l *Logger) Panic(v ...interface{})
- func (l *Logger) Panicf(format string, v ...interface{})
- func (l *Logger) Panicfln(format string, v ...interface{})
- func (l *Logger) Print(v ...interface{})
- func (l *Logger) PrintBacktrace(skip ...int)
- func (l *Logger) Printf(format string, v ...interface{})
- func (l *Logger) Printfln(format string, v ...interface{})
- func (l *Logger) Println(v ...interface{})
- func (l *Logger) SetBacktrace(enabled bool)
- func (l *Logger) SetBacktraceSkip(skip int)
- func (l *Logger) SetDebug(debug bool)
- func (l *Logger) SetFile(pattern string)
- func (l *Logger) SetLevel(level int)
- func (l *Logger) SetPath(path string) error
- func (l *Logger) SetStdPrint(enabled bool)
- func (l *Logger) SetWriter(writer io.Writer)
- func (l *Logger) StdPrint(enabled bool) *Logger
- func (l *Logger) To(writer io.Writer) *Logger
- func (l *Logger) Warning(v ...interface{})
- func (l *Logger) Warningf(format string, v ...interface{})
- func (l *Logger) Warningfln(format string, v ...interface{})
Constants ¶
const ( LEVEL_ALL = LEVEL_DEBU | LEVEL_INFO | LEVEL_NOTI | LEVEL_WARN | LEVEL_ERRO | LEVEL_CRIT LEVEL_DEBU = 1 << iota LEVEL_INFO LEVEL_NOTI LEVEL_WARN LEVEL_ERRO LEVEL_CRIT )
Variables ¶
This section is empty.
Functions ¶
func Criticalfln ¶
func Criticalfln(format string, v ...interface{})
func Fatal ¶
func Fatal(v ...interface{})
Fatal prints the logging content with [FATA] header and newline, then exit the current process.
func Fatalf ¶
func Fatalf(format string, v ...interface{})
Fatalf prints the logging content with [FATA] header and custom format, then exit the current process.
func Fatalfln ¶
func Fatalfln(format string, v ...interface{})
Fatalf prints the logging content with [FATA] header, custom format and newline, then exit the current process.
func GetBacktrace ¶ added in v1.5.0
GetBacktrace returns the caller backtrace content, the optional parameter <skip> specify the skipped backtraces offset from the end point.
获取文件调用回溯信息.
func GetPath ¶
func GetPath() string
GetPath returns the logging directory path for file logging. It returns empty string if no directory path set.
获取日志目录绝对路径
func GetWriter ¶
GetWriter returns the customed writer object, which implements the io.Writer interface. It returns nil if no customed writer set.
返回自定义的IO,默认为nil.
func PrintBacktrace ¶ added in v1.5.0
func PrintBacktrace(skip ...int)
PrintBacktrace prints the caller backtrace, the optional parameter <skip> specify the skipped backtraces offset from the end point.
打印文件调用回溯信息
func SetBacktrace ¶ added in v1.5.0
func SetBacktrace(enabled bool)
SetBacktrace enables/disables the backtrace feature in failure logging outputs.
是否关闭全局的backtrace信息
func SetDebug ¶
func SetDebug(debug bool)
SetDebug enables/disables the debug level for default logger. The debug level is enbaled in default.
设置是否允许输出DEBUG信息.
func SetFile ¶
func SetFile(pattern string)
SetFile sets the file name <pattern> for file logging. Datetime pattern can be used in <pattern>, eg: access-{Ymd}.log. The default file name pattern is: Y-m-d.log, eg: 2018-01-01.log
日志文件名称.
func SetPath ¶
func SetPath(path string)
SetPath sets the directory path for file logging.
日志日志目录绝对路径.
func SetStdPrint ¶ added in v1.5.0
func SetStdPrint(open bool)
SetStdPrint sets whether ouptput the logging contents to stdout, which is false indefault.
设置写日志的同时开启or关闭控制台打印,默认是关闭的
func SetWriter ¶
SetWriter sets the customed logging <writer> for logging. The <writer> object should implements the io.Writer interface. Developer can use customed logging <writer> to redirect logging output to another service, eg: kafka, mysql, mongodb, etc.
可自定义IO接口,IO可以是文件输出、标准输出、网络输出.
func Warningfln ¶
func Warningfln(format string, v ...interface{})
Types ¶
type Logger ¶
type Logger struct {
// contains filtered or unexported fields
}
func Backtrace ¶ added in v1.5.0
Backtrace is a chaining function, which sets backtrace options for the current logging content output .
设置文件调用回溯信息.
func Cat ¶
Cat is a chaining function, which sets the category to <category> for current logging content output.
设置下一次输出的分类,支持多级分类设置.
func File ¶
File is a chaining function, which sets file name <pattern> for the current logging content output.
设置日志输出文件名称格式
func Header ¶
Header is a chaining function, which enables/disables log header for the current logging content output.
是否打印每行日志头信息(默认开启)
func Level ¶
Level is a chaining function, which sets logging level for the current logging content output.
设置日志打印等级.
func StdPrint ¶ added in v1.5.0
StdPrint is a chaining function, which enables/disables stdout for the current logging content output.
是否允许在设置输出文件时同时也输出到终端
func To ¶
To is a chaining function, which redirects current logging content output to the sepecified <writer>.
链式操作,设置下一次写入日志内容的Writer
func (*Logger) Backtrace ¶ added in v1.5.0
Backtrace is a chaining function, which sets backtrace options for the current logging content output .
设置文件调用回溯信息
func (*Logger) Cat ¶
Cat is a chaining function, which sets the category to <category> for current logging content output.
链式操作,设置下一次输出的日志分类(可以按照文件目录层级设置),在当前logpath或者当前工作目录下创建category目录, 这是一个链式操作,可以设置多个分类,将会创建层级的日志分类目录。
func (*Logger) Criticalfln ¶
func (*Logger) Fatal ¶
func (l *Logger) Fatal(v ...interface{})
Fatal prints the logging content with [FATA] header and newline, then exit the current process.
func (*Logger) Fatalf ¶
Fatalf prints the logging content with [FATA] header and custom format, then exit the current process.
func (*Logger) Fatalfln ¶
Fatalf prints the logging content with [FATA] header, custom format and newline, then exit the current process.
func (*Logger) File ¶
File is a chaining function, which sets file name <pattern> for the current logging content output.
日志文件格式
func (*Logger) GetBacktrace ¶ added in v1.5.0
GetBacktrace returns the caller backtrace content, the optional parameter <skip> specify the skipped backtraces offset from the end point.
获取文件调用回溯字符串,参数skip表示调用端往上多少级开始回溯
func (*Logger) GetPath ¶
GetPath returns the logging directory path for file logging. It returns empty string if no directory path set.
获取设置的日志目录路径
func (*Logger) GetWriter ¶
GetWriter returns the customed writer object, which implements the io.Writer interface. It returns nil if no customed writer set.
返回自定义的IO,默认为nil
func (*Logger) Header ¶
Header is a chaining function, which enables/disables log header for the current logging content output.
是否打印每行日志头信息(默认开启)
func (*Logger) Level ¶
Level is a chaining function, which sets logging level for the current logging content output.
设置日志打印等级
func (*Logger) PrintBacktrace ¶ added in v1.5.0
PrintBacktrace prints the caller backtrace, the optional parameter <skip> specify the skipped backtraces offset from the end point.
直接打印回溯信息,参数skip表示调用端往上多少级开始回溯
func (*Logger) SetBacktrace ¶ added in v1.5.0
SetBacktrace enables/disables the backtrace feature in failure logging outputs.
func (*Logger) SetBacktraceSkip ¶ added in v1.5.0
SetBacktraceSkip sets the backtrace offset from the end point.
func (*Logger) SetDebug ¶
SetDebug enables/disables the debug level for logger. The debug level is enbaled in default.
快捷方法,打开或关闭DEBU日志信息
func (*Logger) SetFile ¶
SetFile sets the file name <pattern> for file logging. Datetime pattern can be used in <pattern>, eg: access-{Ymd}.log. The default file name pattern is: Y-m-d.log, eg: 2018-01-01.log
设置日志文件名称格式.
func (*Logger) SetStdPrint ¶ added in v1.5.0
SetStdPrint sets whether ouptput the logging contents to stdout, which is false indefault.
设置写日志时开启or关闭控制台打印,默认是关闭的
func (*Logger) SetWriter ¶
SetWriter sets the customed logging <writer> for logging. The <writer> object should implements the io.Writer interface. Developer can use customed logging <writer> to redirect logging output to another service, eg: kafka, mysql, mongodb, etc.
可自定义IO接口,IO可以是文件输出、标准输出、网络输出
func (*Logger) StdPrint ¶
StdPrint is a chaining function, which enables/disables stdout for the current logging content output.
是否允许在设置输出文件时同时也输出到终端
func (*Logger) To ¶
To is a chaining function, which redirects current logging content output to the sepecified <writer>.
链式操作,设置下一次写入日志内容的Writer