Versions in this module Expand all Collapse all v0 v0.5.8 Mar 26, 2024 v0.5.7 Mar 26, 2024 Changes in this version + const CallerFlagFcLine + const CallerFlagFcName + const CallerFlagFnLine + const CallerFlagFnlFcn + const CallerFlagFpLine + const CallerFlagFull + const CallerFlagFunc + const CallerFlagPkg + const CallerFlagPkgFnl + const DefaultTemplate + const NamedTemplate + var AllLevels = Levels + var ColorTheme = map[Level]color.Color + var DangerLevels = Levels + var DefaultChannelName = "application" + var DefaultClockFn = ClockFn(func() time.Time { ... }) + var DefaultFields = []string + var DefaultPanicFn = func(v any) + var DefaultTimeFormat = "2006/01/02T15:04:05.000" + var DoNothingOnExit = func(code int) + var DoNothingOnPanic = func(v any) + var FieldKeyCaller = "caller" + var FieldKeyChannel = "channel" + var FieldKeyData = "data" + var FieldKeyDate = "date" + var FieldKeyDatetime = "datetime" + var FieldKeyError = "error" + var FieldKeyExtra = "extra" + var FieldKeyLevel = "level" + var FieldKeyMessage = "message" + var FieldKeyTime = "time" + var FieldKeyTimestamp = "timestamp" + var LevelNames = map[Level]string + var NoTimeFields = []string + var NormalLevels = Levels + var PrintLevel = InfoLevel + func AddHandler(h Handler) + func AddHandlers(hs ...Handler) + func AddProcessor(p Processor) + func AddProcessors(ps ...Processor) + func Close() error + func Configure(fn func(l *SugaredLogger)) + func Debug(args ...any) + func Debugf(format string, args ...any) + func EncodeToString(v any) string + func Error(args ...any) + func ErrorT(err error) + func Errorf(format string, args ...any) + func Exit(code int) + func ExitHandlers() []func() + func Fatal(args ...any) + func FatalErr(err error) + func Fatalf(format string, args ...any) + func Flush() error + func FlushDaemon(onStops ...func()) + func FlushTimeout(timeout time.Duration) + func Info(args ...any) + func Infof(format string, args ...any) + func LevelName(l Level) string + func MustClose() + func MustFlush() + func Notice(args ...any) + func Noticef(format string, args ...any) + func Panic(args ...any) + func PanicErr(err error) + func Panicf(format string, args ...any) + func PrependExitHandler(handler func()) + func Print(args ...any) + func Printf(format string, args ...any) + func Println(args ...any) + func PushHandler(h Handler) + func PushHandlers(hs ...Handler) + func RegisterExitHandler(handler func()) + func Reset() + func ResetExitHandlers(applyToStd bool) + func SetExitFunc(fn func(code int)) + func SetFormatter(f Formatter) + func SetLogLevel(l Level) + func StopDaemon() + func Trace(args ...any) + func Tracef(format string, args ...any) + func Warn(args ...any) + func Warnf(format string, args ...any) + type CallerFormatFn func(rf *runtime.Frame) (cs string) + type ClockFn func() time.Time + func (fn ClockFn) Now() time.Time + type Formattable interface + Formatter func() Formatter + SetFormatter func(Formatter) + type FormattableHandler interface + type FormattableTrait = FormatterWrapper + type Formatter interface + Format func(record *Record) ([]byte, error) + func GetFormatter() Formatter + type FormatterFunc func(r *Record) ([]byte, error) + func (fn FormatterFunc) Format(r *Record) ([]byte, error) + type FormatterWrapper struct + func (f *FormatterWrapper) Format(record *Record) ([]byte, error) + func (f *FormatterWrapper) Formatter() Formatter + func (f *FormatterWrapper) SetFormatter(formatter Formatter) + type Handler interface + Flush func() error + Handle func(*Record) error + IsHandling func(level Level) bool + type JSONFormatter struct + Aliases StringMap + CallerFormatFunc CallerFormatFn + Fields []string + PrettyPrint bool + TimeFormat string + func AsJSONFormatter(f Formatter) *JSONFormatter + func NewJSONFormatter(fn ...func(f *JSONFormatter)) *JSONFormatter + func (f *JSONFormatter) AddField(name string) *JSONFormatter + func (f *JSONFormatter) Configure(fn func(*JSONFormatter)) *JSONFormatter + func (f *JSONFormatter) Format(r *Record) ([]byte, error) + type Level uint32 + const DebugLevel + const ErrorLevel + const FatalLevel + const InfoLevel + const NoticeLevel + const PanicLevel + const TraceLevel + const WarnLevel + func LevelByName(ln string) Level + func Name2Level(ln string) (Level, error) + func (l Level) LowerName() string + func (l Level) Name() string + func (l Level) ShouldHandling(curLevel Level) bool + func (l Level) String() string + type LevelFormattable interface + IsHandling func(level Level) bool + type LevelFormatting struct + func NewLevelsFormatting(levels []Level) *LevelFormatting + func NewMaxLevelFormatting(maxLevel Level) *LevelFormatting + type LevelHandling struct + func (h *LevelHandling) IsHandling(level Level) bool + func (h *LevelHandling) SetLimitLevels(levels []Level) + func (h *LevelHandling) SetMaxLevel(maxLv Level) + type LevelMode uint8 + const LevelModeList + const LevelModeMax + func (m LevelMode) String() string + type LevelWithFormatter struct + Level Level + func NewLvFormatter(maxLv Level) *LevelWithFormatter + func (h *LevelWithFormatter) IsHandling(level Level) bool + func (h *LevelWithFormatter) SetMaxLevel(maxLv Level) + type Levels []Level + func (ls Levels) Contains(level Level) bool + type LevelsWithFormatter struct + Levels []Level + func NewLvsFormatter(levels []Level) *LevelsWithFormatter + func (h *LevelsWithFormatter) IsHandling(level Level) bool + func (h *LevelsWithFormatter) SetLimitLevels(levels []Level) + type Logger struct + BackupArgs bool + CallerFlag uint8 + CallerSkip int + ChannelName string + ExitFunc func(code int) + FlushInterval time.Duration + LowerLevelName bool + PanicFunc func(v any) + ReportCaller bool + TimeClock ClockFn + func New(fns ...LoggerFn) *Logger + func NewWithConfig(fns ...LoggerFn) *Logger + func NewWithHandlers(hs ...Handler) *Logger + func NewWithName(name string, fns ...LoggerFn) *Logger + func (l *Logger) AddHandler(h Handler) + func (l *Logger) AddHandlers(hs ...Handler) + func (l *Logger) AddProcessor(p Processor) + func (l *Logger) AddProcessors(ps ...Processor) + func (l *Logger) Close() error + func (l *Logger) Config(fns ...LoggerFn) *Logger + func (l *Logger) Configure(fn LoggerFn) *Logger + func (l *Logger) Debug(args ...any) + func (l *Logger) Debugf(format string, args ...any) + func (l *Logger) DoNothingOnPanicFatal() + func (l *Logger) Error(args ...any) + func (l *Logger) ErrorT(err error) + func (l *Logger) Errorf(format string, args ...any) + func (l *Logger) Exit(code int) + func (l *Logger) ExitHandlers() []func() + func (l *Logger) Fatal(args ...any) + func (l *Logger) Fatalf(format string, args ...any) + func (l *Logger) Fatalln(args ...any) + func (l *Logger) Flush() error + func (l *Logger) FlushAll() error + func (l *Logger) FlushDaemon(onStops ...func()) + func (l *Logger) FlushTimeout(timeout time.Duration) + func (l *Logger) HandlersNum() int + func (l *Logger) Info(args ...any) + func (l *Logger) Infof(format string, args ...any) + func (l *Logger) LastErr() error + func (l *Logger) Log(level Level, args ...any) + func (l *Logger) Logf(level Level, format string, args ...any) + func (l *Logger) MustClose() + func (l *Logger) MustFlush() + func (l *Logger) Name() string + func (l *Logger) Notice(args ...any) + func (l *Logger) Noticef(format string, args ...any) + func (l *Logger) Panic(args ...any) + func (l *Logger) Panicf(format string, args ...any) + func (l *Logger) Panicln(args ...any) + func (l *Logger) PrependExitHandler(handler func()) + func (l *Logger) Print(args ...any) + func (l *Logger) Printf(format string, args ...any) + func (l *Logger) Println(args ...any) + func (l *Logger) PushHandler(h Handler) + func (l *Logger) PushHandlers(hs ...Handler) + func (l *Logger) PushProcessor(p Processor) + func (l *Logger) Record() *Record + func (l *Logger) RegisterExitHandler(handler func()) + func (l *Logger) Reset() + func (l *Logger) ResetExitHandlers() + func (l *Logger) ResetHandlers() + func (l *Logger) ResetProcessors() + func (l *Logger) Reused() *Record + func (l *Logger) SetHandlers(hs []Handler) + func (l *Logger) SetName(name string) + func (l *Logger) SetProcessors(ps []Processor) + func (l *Logger) StopDaemon() + func (l *Logger) Sync() error + func (l *Logger) Trace(args ...any) + func (l *Logger) Tracef(format string, args ...any) + func (l *Logger) VisitAll(fn func(handler Handler) error) error + func (l *Logger) Warn(args ...any) + func (l *Logger) Warnf(format string, args ...any) + func (l *Logger) Warning(args ...any) + func (l *Logger) WithContext(ctx context.Context) *Record + func (l *Logger) WithCtx(ctx context.Context) *Record + func (l *Logger) WithData(data M) *Record + func (l *Logger) WithExtra(ext M) *Record + func (l *Logger) WithField(name string, value any) *Record + func (l *Logger) WithFields(fields M) *Record + func (l *Logger) WithTime(t time.Time) *Record + func (l *Logger) WithValue(key string, value any) *Record + type LoggerFn func(l *Logger) + type M map[string]any + func (m M) String() string + type Processable struct + func (p *Processable) AddProcessor(processor Processor) + func (p *Processable) ProcessRecord(r *Record) + type ProcessableHandler interface + AddProcessor func(Processor) + ProcessRecord func(record *Record) + type Processor interface + Process func(record *Record) + func AddHostname() Processor + func AddUniqueID(fieldName string) Processor + func AppendCtxKeys(keys ...string) Processor + type ProcessorFunc func(record *Record) + var MemoryUsage ProcessorFunc = func(record *Record) { ... } + func (fn ProcessorFunc) Process(record *Record) + type Record struct + Args []any + Caller *runtime.Frame + CallerFlag uint8 + CallerSkip int + Channel string + Ctx context.Context + Data M + EnableStack bool + Extra M + Fields M + Fmt string + Level Level + Message string + Time time.Time + func WithContext(ctx context.Context) *Record + func WithData(data M) *Record + func WithExtra(ext M) *Record + func WithField(name string, value any) *Record + func WithFields(fields M) *Record + func WithValue(key string, value any) *Record + func (r *Record) AddData(data M) *Record + func (r *Record) AddExtra(data M) *Record + func (r *Record) AddField(name string, val any) *Record + func (r *Record) AddFields(fields M) *Record + func (r *Record) AddValue(key string, value any) *Record + func (r *Record) Copy() *Record + func (r *Record) Debug(args ...any) + func (r *Record) Debugf(format string, args ...any) + func (r *Record) Error(args ...any) + func (r *Record) Errorf(format string, args ...any) + func (r *Record) Fatal(args ...any) + func (r *Record) Fatalf(format string, args ...any) + func (r *Record) Fatalln(args ...any) + func (r *Record) Field(key string) any + func (r *Record) GoString() string + func (r *Record) Info(args ...any) + func (r *Record) Infof(format string, args ...any) + func (r *Record) Init(lowerLevelName bool) + func (r *Record) LevelName() string + func (r *Record) Log(level Level, args ...any) + func (r *Record) Logf(level Level, format string, args ...any) + func (r *Record) Notice(args ...any) + func (r *Record) Noticef(format string, args ...any) + func (r *Record) Panic(args ...any) + func (r *Record) Panicf(format string, args ...any) + func (r *Record) Panicln(args ...any) + func (r *Record) Print(args ...any) + func (r *Record) Printf(format string, args ...any) + func (r *Record) Println(args ...any) + func (r *Record) Release() + func (r *Record) Reused() *Record + func (r *Record) SetContext(ctx context.Context) *Record + func (r *Record) SetCtx(ctx context.Context) *Record + func (r *Record) SetData(data M) *Record + func (r *Record) SetExtra(data M) *Record + func (r *Record) SetExtraValue(k string, v any) + func (r *Record) SetFields(fields M) *Record + func (r *Record) SetTime(t time.Time) *Record + func (r *Record) Trace(args ...any) + func (r *Record) Tracef(format string, args ...any) + func (r *Record) Value(key string) any + func (r *Record) Warn(args ...any) + func (r *Record) Warnf(format string, args ...any) + func (r *Record) WithContext(ctx context.Context) *Record + func (r *Record) WithCtx(ctx context.Context) *Record + func (r *Record) WithData(data M) *Record + func (r *Record) WithError(err error) *Record + func (r *Record) WithField(name string, val any) *Record + func (r *Record) WithFields(fields M) *Record + func (r *Record) WithTime(t time.Time) *Record + type SLogger interface + Log func(level Level, v ...any) + Logf func(level Level, format string, v ...any) + type StringMap = map[string]string + type SugaredLogger struct + Formatter Formatter + Level Level + Output io.Writer + func NewJSONSugared(out io.Writer, level Level, fns ...SugaredLoggerFn) *SugaredLogger + func NewStd(fns ...SugaredLoggerFn) *SugaredLogger + func NewStdLogger(fns ...SugaredLoggerFn) *SugaredLogger + func NewSugared(out io.Writer, level Level, fns ...SugaredLoggerFn) *SugaredLogger + func NewSugaredLogger(output io.Writer, level Level, fns ...SugaredLoggerFn) *SugaredLogger + func Std() *SugaredLogger + func (sl *SugaredLogger) Close() error + func (sl *SugaredLogger) Config(fns ...SugaredLoggerFn) *SugaredLogger + func (sl *SugaredLogger) Flush() error + func (sl *SugaredLogger) FlushAll() error + func (sl *SugaredLogger) Handle(record *Record) error + func (sl *SugaredLogger) IsHandling(level Level) bool + func (sl *SugaredLogger) Reset() + type SugaredLoggerFn func(sl *SugaredLogger) + type TextFormatter struct + CallerFormatFunc CallerFormatFn + ColorTheme map[Level]color.Color + EnableColor bool + EncodeFunc func(v any) string + FullDisplay bool + TimeFormat string + func AsTextFormatter(f Formatter) *TextFormatter + func NewTextFormatter(template ...string) *TextFormatter + func (f *TextFormatter) Configure(fn func(*TextFormatter)) *TextFormatter + func (f *TextFormatter) Fields() []string + func (f *TextFormatter) Format(r *Record) ([]byte, error) + func (f *TextFormatter) SetTemplate(fmtTpl string) + func (f *TextFormatter) Template() string + func (f *TextFormatter) WithEnableColor(enable bool) *TextFormatter