Versions in this module Expand all Collapse all v2 v2.0.16 Dec 21, 2021 Changes in this version + const DefMetricsUpdateFreqMillis + const DefTimestampFormat + const DefaultEnqueueTimeout + const DefaultFlushTimeout + const DefaultMaxPooledBuffer + const DefaultMaxQueueSize + const DefaultMaxStackFrames + const DefaultShutdownTimeout + const MaxLevelID + const TimestampMillisFormat + var AnsiColorPrefix = []byte("\u001b[") + var AnsiColorSuffix = []byte("m") + var Colon = []byte + var Comma = []byte + var Debug = Level + var Equals = []byte + var Error = Level + var Fatal = Level + var Info = Level + var Newline = []byte + var Panic = Level + var Quote = []byte + var Space = []byte + var Trace = Level + var Warn = Level + func GetLogrPackageName() string + func GetPackageName(callingFuncName string) string + func IsTimeoutError(err error) bool + func NewStdLogger(level Level, logger Logger) *log.Logger + func ResolvePackageName(f string) string + func WriteFields(w io.Writer, fields []Field, separator []byte, color Color) error + func WriteStacktrace(w io.Writer, frames []runtime.Frame) error + func WriteWithColor(w io.Writer, s string, color Color) error + type Buffer struct + func (b *Buffer) Read(p []byte) (n int, err error) + func (b *Buffer) String() string + func (b *Buffer) Write(p []byte) (n int, err error) + type Color uint8 + const Blue + const Cyan + const Green + const Magenta + const NoColor + const Red + const White + const Yellow + type Counter interface + Add func(float64) + Inc func() + type CustomFilter struct + func NewCustomFilter(levels ...Level) *CustomFilter + func (cf *CustomFilter) Add(levels ...Level) + func (cf *CustomFilter) GetEnabledLevel(level Level) (Level, bool) + type DefaultFormatter struct + func (p *DefaultFormatter) Format(rec *LogRec, level Level, buf *bytes.Buffer) (*bytes.Buffer, error) + func (p *DefaultFormatter) IsStacktraceNeeded() bool + type Field struct + Float float64 + Integer int64 + Interface interface{} + Key string + String string + Type FieldType + func Any(key string, val interface{}) Field + func Array(key string, val interface{}) Field + func Bool(key string, val bool) Field + func Duration(key string, val time.Duration) Field + func Err(err error) Field + func Float32(key string, val float32) Field + func Float64(key string, val float64) Field + func Int(key string, val int) Field + func Int32(key string, val int32) Field + func Int64(key string, val int64) Field + func Map(key string, val interface{}) Field + func Millis(key string, val int64) Field + func NamedErr(key string, err error) Field + func String(key string, val string) Field + func Stringer(key string, val fmt.Stringer) Field + func Time(key string, val time.Time) Field + func Uint(key string, val uint) Field + func Uint32(key string, val uint32) Field + func Uint64(key string, val uint64) Field + func (f Field) ValueString(w io.Writer, shouldQuote func(s string) bool) error + type FieldSorter []Field + func (fs FieldSorter) Len() int + func (fs FieldSorter) Less(i, j int) bool + func (fs FieldSorter) Swap(i, j int) + type FieldType uint8 + const ArrayType + const BinaryType + const BoolType + const DurationType + const ErrorType + const Float32Type + const Float64Type + const Int32Type + const Int64Type + const IntType + const MapType + const StringType + const StringerType + const StructType + const TimeType + const TimestampMillisType + const Uint32Type + const Uint64Type + const UintType + const UnknownType + type Filter interface + GetEnabledLevel func(level Level) (Level, bool) + type Formatter interface + Format func(rec *LogRec, level Level, buf *bytes.Buffer) (*bytes.Buffer, error) + IsStacktraceNeeded func() bool + type Gauge interface + Add func(float64) + Set func(float64) + Sub func(float64) + type Level struct + Color Color + ID LevelID + Name string + Stacktrace bool + func (level Level) String() string + type LevelID uint + type LevelStatus struct + Enabled bool + Stacktrace bool + type LogCloner interface + LogClone func() interface{} + type LogRec struct + func NewLogRec(lvl Level, logger Logger, msg string, fields []Field, incStacktrace bool) *LogRec + func (rec *LogRec) Caller() string + func (rec *LogRec) Fields() []Field + func (rec *LogRec) Level() Level + func (rec *LogRec) Logger() Logger + func (rec *LogRec) Msg() string + func (rec *LogRec) StackFrames() []runtime.Frame + func (rec *LogRec) String() string + func (rec *LogRec) Time() time.Time + func (rec *LogRec) WithTime(time time.Time) *LogRec + type LogWriter interface + LogWrite func(w io.Writer) error + type Logger struct + func (logger Logger) Debug(msg string, fields ...Field) + func (logger Logger) Error(msg string, fields ...Field) + func (logger Logger) Fatal(msg string, fields ...Field) + func (logger Logger) Info(msg string, fields ...Field) + func (logger Logger) IsLevelEnabled(level Level) bool + func (logger Logger) Log(lvl Level, msg string, fields ...Field) + func (logger Logger) LogM(levels []Level, msg string, fields ...Field) + func (logger Logger) Logr() *Logr + func (logger Logger) Panic(msg string, fields ...Field) + func (logger Logger) StdLogger(level Level) *log.Logger + func (logger Logger) Sugar(fields ...Field) Sugar + func (logger Logger) Trace(msg string, fields ...Field) + func (logger Logger) Warn(msg string, fields ...Field) + func (logger Logger) With(fields ...Field) Logger + type Logr struct + func New(opts ...Option) (*Logr, error) + func (lgr *Logr) AddTarget(target Target, name string, filter Filter, formatter Formatter, ...) error + func (lgr *Logr) BorrowBuffer() *bytes.Buffer + func (lgr *Logr) Flush() error + func (lgr *Logr) FlushWithTimeout(ctx context.Context) error + func (lgr *Logr) HasTargets() bool + func (lgr *Logr) IsLevelEnabled(lvl Level) LevelStatus + func (lgr *Logr) IsShutdown() bool + func (lgr *Logr) NewLogger() Logger + func (lgr *Logr) RedirectStdLog(level Level, fields ...Field) func() + func (lgr *Logr) ReleaseBuffer(buf *bytes.Buffer) + func (lgr *Logr) RemoveTargets(cxt context.Context, f func(ti TargetInfo) bool) error + func (lgr *Logr) ReportError(err interface{}) + func (lgr *Logr) ResetLevelCache() + func (lgr *Logr) SetMetricsCollector(collector MetricsCollector, updateFreqMillis int64) + func (lgr *Logr) Shutdown() error + func (lgr *Logr) ShutdownWithTimeout(ctx context.Context) error + func (lgr *Logr) TargetInfos() []TargetInfo + type MetricsCollector interface + BlockedCounter func(target string) (Counter, error) + DroppedCounter func(target string) (Counter, error) + ErrorCounter func(target string) (Counter, error) + LoggedCounter func(target string) (Counter, error) + QueueSizeGauge func(target string) (Gauge, error) + type Option func(*Logr) error + func DisableBufferPool(disable bool) Option + func EnqueueTimeout(dur time.Duration) Option + func FlushTimeout(dur time.Duration) Option + func MaxPooledBufferSize(size int) Option + func MaxQueueSize(size int) Option + func OnExit(f func(code int)) Option + func OnLoggerError(f func(error)) Option + func OnPanic(f func(err interface{})) Option + func OnQueueFull(f func(rec *LogRec, maxQueueSize int) bool) Option + func OnTargetQueueFull(f func(target Target, rec *LogRec, maxQueueSize int) bool) Option + func SetMetricsCollector(collector MetricsCollector, updateFreqMillis int64) Option + func ShutdownTimeout(dur time.Duration) Option + func StackFilter(pkg ...string) Option + func UseSyncMapLevelCache(use bool) Option + type StdFilter struct + Lvl Level + Stacktrace Level + func (lt StdFilter) GetEnabledLevel(level Level) (Level, bool) + func (lt StdFilter) IsEnabled(level Level) bool + func (lt StdFilter) IsStacktraceEnabled(level Level) bool + type Sugar struct + func (s Sugar) Debug(msg string, args ...interface{}) + func (s Sugar) Debugf(format string, args ...interface{}) + func (s Sugar) Debugw(msg string, keyValuePairs ...interface{}) + func (s Sugar) Error(msg string, args ...interface{}) + func (s Sugar) Errorf(format string, args ...interface{}) + func (s Sugar) Errorw(msg string, keyValuePairs ...interface{}) + func (s Sugar) Fatal(msg string, args ...interface{}) + func (s Sugar) Fatalf(format string, args ...interface{}) + func (s Sugar) Fatalw(msg string, keyValuePairs ...interface{}) + func (s Sugar) Info(msg string, args ...interface{}) + func (s Sugar) Infof(format string, args ...interface{}) + func (s Sugar) Infow(msg string, keyValuePairs ...interface{}) + func (s Sugar) Logf(lvl Level, format string, args ...interface{}) + func (s Sugar) Panic(msg string, args ...interface{}) + func (s Sugar) Panicf(format string, args ...interface{}) + func (s Sugar) Panicw(msg string, keyValuePairs ...interface{}) + func (s Sugar) Print(msg string, args ...interface{}) + func (s Sugar) Printf(format string, args ...interface{}) + func (s Sugar) Trace(msg string, args ...interface{}) + func (s Sugar) Tracef(format string, args ...interface{}) + func (s Sugar) Tracew(msg string, keyValuePairs ...interface{}) + func (s Sugar) Warn(msg string, args ...interface{}) + func (s Sugar) Warnf(format string, args ...interface{}) + func (s Sugar) Warnw(msg string, keyValuePairs ...interface{}) + func (s Sugar) With(keyValuePairs ...interface{}) Sugar + type Target interface + Init func() error + Shutdown func() error + Write func(p []byte, rec *LogRec) (int, error) + type TargetHost struct + func (h *TargetHost) IsLevelEnabled(lvl Level) (enabled bool, level Level) + func (h *TargetHost) Log(rec *LogRec) + func (h *TargetHost) Shutdown(ctx context.Context) error + func (h *TargetHost) String() string + type TargetInfo struct + Name string + Type string + type TargetWithMetrics interface + EnableMetrics func(collector MetricsCollector, updateFreqMillis int64) error + type Writer struct + func (w Writer) Writes(elems ...[]byte) (int, error)