# README
Logger
Usage
Structured logging
logger := log.NewStdLogger(os.Stdout)
// fields & valuer
logger = log.With(logger,
"service.name", "hellworld",
"service.version", "v1.0.0",
"ts", log.DefaultTimestamp,
"caller", log.DefaultCaller,
)
logger.Log(log.LevelInfo, "key", "value")
// helper
helper := log.NewHelper(logger)
helper.Log(log.LevelInfo, "key", "value")
helper.Info("info message")
helper.Infof("info %s", "message")
helper.Infow("key", "value")
// filter
log := log.NewHelper(log.NewFilter(logger,
log.FilterLevel(log.LevelInfo),
log.FilterKey("foo"),
log.FilterValue("bar"),
log.FilterFunc(customFilter),
))
log.Debug("debug log")
log.Info("info log")
log.Warn("warn log")
log.Error("warn log")
Third party log library
zap
go get -u github.com/go-kratos/kratos/contrib/log/zap/v2
logrus
go get -u github.com/go-kratos/kratos/contrib/log/logrus/v2
fluent
go get -u github.com/go-kratos/kratos/contrib/log/fluent/v2
aliyun
go get -u github.com/go-kratos/kratos/contrib/log/aliyun/v2
# Functions
Caller returns a Valuer that returns a pkg/file:line description of the caller.
Context with context logger.
Debug logs a message at debug level.
Debugf logs a message at debug level.
Debugw logs a message at debug level.
Error logs a message at error level.
Errorf logs a message at error level.
Errorw logs a message at error level.
Fatal logs a message at fatal level.
Fatalf logs a message at fatal level.
Fatalw logs a message at fatal level.
FilterFunc with filter func.
FilterKey with filter key.
FilterLevel with filter level.
FilterValue with filter value.
GetLogger returns global logger appliance as logger in current process.
Info logs a message at info level.
Infof logs a message at info level.
Infow logs a message at info level.
Log Print log by level and keyvals.
NewDefaultJsonLogger 配置zap日志,将zap日志库引入.
NewFilter new a logger filter.
NewHelper new a logger helper.
NewStdLogger new a logger with writer.
No description provided by the author
NewWriter return a writer wrapper.
NewZapLogger return a zap logger.
ParseLevel parses a level string into a logger Level value.
No description provided by the author
No description provided by the author
SetLogger should be called before any other log call.
No description provided by the author
No description provided by the author
Timestamp returns a timestamp Valuer with a custom time format.
No description provided by the author
No description provided by the author
Value return the function value.
Warn logs a message at warn level.
Warnf logs a message at warnf level.
Warnw logs a message at warnf level.
With with logger fields.
WithContext returns a shallow copy of l with its context changed to ctx.
WithMessageKey with message key.
WithWriteMessageKey set writerWrapper helper message key.
WithWriterLevel set writerWrapper level.
# Constants
LevelDebug is logger debug level.
LevelError is logger error level.
LevelFatal is logger fatal level.
LevelInfo is logger info level.
LevelKey is logger level key.
LevelWarn is logger warn level.
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
No description provided by the author
# Variables
DefaultCaller is a Valuer that returns the file and line.
DefaultLogger is default logger.
DefaultMessageKey default message key.
DefaultTimestamp is a Valuer that returns the current wallclock time.
# Interfaces
Logger is a logger interface.
# Type aliases
FilterOption is filter option.
Level is a logger level.
Option is Helper option.
Valuer is returns a log value.
No description provided by the author