README
¶
Logger
Installation
go get github.com/go-zoox/logger
Usage
logger.Info("hello")
logger.Error("something failed")
Transports
A Logger holds named transports. Each log line is sent to every transport; each transport decides what to do (console, files, etc.).
Console (default)
l := logger.New() // includes console transport
File transport with per-level paths
file.Config.FilePath is the default file. Optional Levels sends specific log levels to other files; all other levels still use FilePath.
import (
"github.com/go-zoox/logger"
"github.com/go-zoox/logger/transport/console"
"github.com/go-zoox/logger/transport/file"
)
l := logger.New(func(opt *logger.Option) {
opt.Transports = map[string]transport.Transport{
"console": console.New(),
"file": file.New(&file.Config{
FilePath: "/var/log/app.log",
Levels: map[string]string{
"error": "/var/log/error.log",
},
}),
}
})
l.Info("→ console + app.log")
l.Error("→ console + error.log")
Omit Levels (or leave it empty) to write every line to FilePath only. Level keys: debug, info, warn, error, fatal.
Multiple transports
Use several entries in opt.Transports (e.g. console + file above). No extra sink/output layer.
License
Documentation
¶
Index ¶
- Variables
- func AppendTransports(transports map[string]cst.Transport) error
- func Debug(format string, args ...interface{})
- func Debugf(format string, args ...interface{})
- func Error(format string, args ...interface{})
- func Errorf(format string, args ...interface{})
- func Fatal(format string, args ...interface{})
- func Fatalf(format string, args ...interface{})
- func GetLevel() string
- func Info(format string, args ...interface{})
- func Infof(format string, args ...interface{})
- func IsDebugLevel() bool
- func IsErrorLevel() bool
- func IsFatalLevel() bool
- func IsInfoLevel() bool
- func IsWarnLevel() bool
- func Now() string
- func SetDefault(l *Logger)
- func SetLevel(level string) (err error)
- func SetTransports(transports map[string]cst.Transport) error
- func Warn(format string, args ...interface{})
- func Warnf(format string, args ...interface{})
- type Logger
- func (l *Logger) AppendTransports(transports map[string]cst.Transport) error
- func (l *Logger) Debug(format string, v ...interface{})
- func (l *Logger) Debugf(format string, v ...interface{})
- func (l *Logger) Error(format string, v ...interface{})
- func (l *Logger) Errorf(format string, v ...interface{})
- func (l *Logger) Fatal(format string, v ...interface{})
- func (l *Logger) Fatalf(format string, v ...interface{})
- func (l *Logger) GetLevel() string
- func (l *Logger) Info(format string, v ...interface{})
- func (l *Logger) Infof(format string, v ...interface{})
- func (l *Logger) IsDebugLevel() bool
- func (l *Logger) IsErrorLevel() bool
- func (l *Logger) IsFatalLevel() bool
- func (l *Logger) IsInfoLevel() bool
- func (l *Logger) IsWarnLevel() bool
- func (l *Logger) Printf(format string, v ...interface{})
- func (l *Logger) SetLevel(level string) error
- func (l *Logger) SetStdout(stdout io.Writer)
- func (l *Logger) SetTimeFormat(format string)
- func (l *Logger) SetTransports(transports map[string]cst.Transport) error
- func (l *Logger) Warn(format string, v ...interface{})
- func (l *Logger) Warnf(format string, v ...interface{})
- func (l *Logger) Write(p []byte) (n int, err error)
- type Option
Constants ¶
This section is empty.
Variables ¶
var ( // LevelDebug is Level Debug LevelDebug = constants.LevelDebug // LevelInfo is Level Info LevelInfo = constants.LevelInfo // LevelWarn is Level Warn LevelWarn = constants.LevelWarn // LevelError is Level Error LevelError = constants.LevelError // LevelFatal is Level Fatal LevelFatal = constants.LevelFatal )
var LogLevelEnv = "LOG_LEVEL"
LogLevelEnv ...
var Version = "1.6.4"
Version returns the current version of the logger.
Functions ¶
func AppendTransports ¶ added in v1.3.3
AppendTransports appends the transports of the logger.
func Debugf ¶ added in v1.1.5
func Debugf(format string, args ...interface{})
Debugf logs a debug message.
func Errorf ¶ added in v1.1.5
func Errorf(format string, args ...interface{})
Errorf logs an error message (routes to sinks with levels: [error], etc.).
func Fatalf ¶ added in v1.1.5
func Fatalf(format string, args ...interface{})
Fatalf logs a fatal message.
func Infof ¶ added in v1.1.5
func Infof(format string, args ...interface{})
Infof logs an info message.
func IsDebugLevel ¶ added in v1.4.6
func IsDebugLevel() bool
IsDebugLevel returns true if the logger level is debug.
func IsErrorLevel ¶ added in v1.4.6
func IsErrorLevel() bool
IsErrorLevel returns true if the logger level is error.
func IsFatalLevel ¶ added in v1.4.6
func IsFatalLevel() bool
IsFatalLevel returns true if the logger level is fatal.
func IsInfoLevel ¶ added in v1.4.6
func IsInfoLevel() bool
IsInfoLevel returns true if the logger level is info.
func IsWarnLevel ¶ added in v1.4.6
func IsWarnLevel() bool
IsWarnLevel returns true if the logger level is warn.
func SetDefault ¶ added in v1.6.4
func SetDefault(l *Logger)
SetDefault replaces the package-level logger (e.g. after configuring outputs).
func SetTransports ¶ added in v1.3.3
SetTransports sets the transports of the logger.
it will overrides system transport, if you only want append transport, just use AppendTransports.
Types ¶
type Logger ¶ added in v1.1.0
type Logger struct {
// contains filtered or unexported fields
}
Logger is the main logger object.
func (*Logger) AppendTransports ¶ added in v1.3.3
AppendTransports appends the transports of the logger.
func (*Logger) IsDebugLevel ¶ added in v1.4.6
IsDebugLevel returns true if the logger level is debug.
func (*Logger) IsErrorLevel ¶ added in v1.4.6
IsErrorLevel returns true if the logger level is error.
func (*Logger) IsFatalLevel ¶ added in v1.4.6
IsFatalLevel returns true if the logger level is fatal.
func (*Logger) IsInfoLevel ¶ added in v1.4.6
IsInfoLevel returns true if the logger level is info.
func (*Logger) IsWarnLevel ¶ added in v1.4.6
IsWarnLevel returns true if the logger level is warn.
func (*Logger) SetTimeFormat ¶ added in v1.1.1
SetTimeFormat sets the time format.
func (*Logger) SetTransports ¶ added in v1.3.3
SetTransports sets the transports of the logger.
it will overrides system transport, if you only want append transport, just use AppendTransports.
Source Files
Directories