Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security Policy
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

logger

package module

Go to main page

Versions in this module

v1

v1.0.7

Mar 24, 2024

v1.0.6

Mar 24, 2024

Changes in this version

+ var ErrLogFileClosed = errors.New("error: log file closed")

+ func NewNonColorable(w zapcore.WriteSyncer) io.Writer

+ type AnyType = any

+ type DailyRotateRule struct

+ func (r *DailyRotateRule) BackupFileName() string

+ func (r *DailyRotateRule) MarkRotated()

+ func (r *DailyRotateRule) OutdatedFiles() []string

+ func (r *DailyRotateRule) ShallRotate(_ int64) bool

+ type FileSystem interface

+ Close func(closer io.Closer) error

+ Copy func(writer io.Writer, reader io.Reader) (int64, error)

+ Create func(name string) (*os.File, error)

+ Open func(name string) (*os.File, error)

+ Remove func(name string) error

+ type HourRotateRule struct

+ func NewHourRotateRule(filename, delimiter string, hours int, gzip bool) *HourRotateRule

+ func (r *HourRotateRule) BackupFileName() string

+ func (r *HourRotateRule) MarkRotated()

+ func (r *HourRotateRule) OutdatedFiles() []string

+ func (r *HourRotateRule) ShallRotate(_ int64) bool

+ type NonColorable struct

+ func (w *NonColorable) Sync() error

+ func (w *NonColorable) Write(data []byte) (n int, err error)

type Option

+ func WithKeepDays(keepDays int) Option

+ func WithKeepHours(keepHours int) Option

+ func WithRotation(rotation string) Option

+ type PlaceholderType = struct

+ var Placeholder PlaceholderType

+ type RotateLogger struct

+ func NewRotateLogger(filename string, rule RotateRule, compress bool) (*RotateLogger, error)

+ func (l *RotateLogger) Close() (err error)

+ func (l *RotateLogger) Sync() error

+ func (l *RotateLogger) Write(data []byte) (int, error)

+ type RotateRule interface

+ BackupFileName func() string

+ MarkRotated func()

+ OutdatedFiles func() []string

+ ShallRotate func(size int64) bool

+ func DefaultRotateRule(filename, delimiter string, days int, gzip bool) RotateRule

+ func NewSizeLimitRotateRule(filename, delimiter string, days, maxSize, maxBackups int, gzip bool) RotateRule

+ type SizeLimitRotateRule struct

+ func (r *SizeLimitRotateRule) BackupFileName() string

+ func (r *SizeLimitRotateRule) MarkRotated()

+ func (r *SizeLimitRotateRule) OutdatedFiles() []string

+ func (r *SizeLimitRotateRule) ShallRotate(size int64) bool

+ type StandardFileSystem struct

+ func (fs StandardFileSystem) Close(closer io.Closer) error

+ func (fs StandardFileSystem) Copy(writer io.Writer, reader io.Reader) (int64, error)

+ func (fs StandardFileSystem) Create(name string) (*os.File, error)

+ func (fs StandardFileSystem) Open(name string) (*os.File, error)

+ func (fs StandardFileSystem) Remove(name string) error

v1.0.5

Mar 11, 2024

v1.0.4

Mar 11, 2024

v1.0.3

Oct 10, 2023

Changes in this version

+ const ConsoleMode

+ const FileMode

+ var ErrLogPathNotSet = errors.New("log path must be set")

type Level

+ func ParseLevel(s string) Level

+ func (l Level) Enabled(lvl Level) bool

+ func (l Level) String() string

+ type LevelEnablerFunc func(zapcore.Level) bool

+ func (f LevelEnablerFunc) Enabled(lvl zapcore.Level) bool

type Logging

+ func (l *Logging) LevelEnablerFunc(level zapcore.Level) LevelEnablerFunc

type Option

+ func WithPath(path string) Option

v1.0.2

Oct 9, 2023

v1.0.1

Oct 9, 2023

v1.0.0

Oct 8, 2023

Changes in this version

+ const DailyRolling

+ const HourlyRolling

+ const MinutelyRolling

+ const MonthlyRolling

+ const SecondlyRolling

+ func CopyFields(fields map[string]interface{}) []interface

+ func Debug(args ...interface{})

+ func Debugf(template string, args ...interface{})

+ func Debugw(msg string, keysAndValues ...interface{})

+ func Error(args ...interface{})

+ func Errorf(template string, args ...interface{})

+ func Errorw(msg string, keysAndValues ...interface{})

+ func Fatal(args ...interface{})

+ func Fatalf(template string, args ...interface{})

+ func Fatalw(msg string, keysAndValues ...interface{})

+ func Info(args ...interface{})

+ func Infof(template string, args ...interface{})

+ func Infow(msg string, keysAndValues ...interface{})

+ func SetLevel(lv Level)

+ func SpanID(ctx context.Context) string

+ func Sync() error

+ func TraceID(ctx context.Context) string

+ func Warn(args ...interface{})

+ func Warnf(template string, args ...interface{})

+ func Warnw(msg string, keysAndValues ...interface{})

+ type Encoder string

+ const ConsoleEncoder

+ const JsonEncoder

+ func (e Encoder) IsConsole() bool

+ func (e Encoder) IsJson() bool

+ func (e Encoder) String() string

+ type Level zapcore.Level

+ const DPanicLevel

+ const DebugLevel

+ const ErrorLevel

+ const FatalLevel

+ const InfoLevel

+ const InvalidLevel

+ const PanicLevel

+ const WarnLevel

+ func (l Level) Level() zapcore.Level

+ type Logger interface

+ Debug func(args ...interface{})

+ Debugf func(template string, args ...interface{})

+ Debugw func(msg string, keysAndValues ...interface{})

+ Error func(args ...interface{})

+ Errorf func(template string, args ...interface{})

+ Errorw func(msg string, keysAndValues ...interface{})

+ Fatal func(args ...interface{})

+ Fatalf func(template string, args ...interface{})

+ Fatalw func(msg string, keysAndValues ...interface{})

+ Info func(args ...interface{})

+ Infof func(template string, args ...interface{})

+ Infow func(msg string, keysAndValues ...interface{})

+ SetLevel func(lv Level)

+ Sync func() error

+ Warn func(args ...interface{})

+ Warnf func(template string, args ...interface{})

+ Warnw func(msg string, keysAndValues ...interface{})

+ WithCallDepth func(callDepth int) Logger

+ WithContext func(ctx context.Context) Logger

+ WithFields func(fields map[string]any) Logger

+ var DefaultLogger Logger = New()

+ func WithCallDepth(callDepth int) Logger

+ func WithContext(ctx context.Context) Logger

+ func WithFields(fields map[string]interface{}) Logger

+ type Logging struct

+ func New(opts ...Option) *Logging

+ func (l *Logging) Clone() *Logging

+ func (l *Logging) Debug(args ...interface{})

+ func (l *Logging) Debugf(template string, args ...interface{})

+ func (l *Logging) Debugw(msg string, keysAndValues ...interface{})

+ func (l *Logging) Error(args ...interface{})

+ func (l *Logging) Errorf(template string, args ...interface{})

+ func (l *Logging) Errorw(msg string, keysAndValues ...interface{})

+ func (l *Logging) Fatal(args ...interface{})

+ func (l *Logging) Fatalf(template string, args ...interface{})

+ func (l *Logging) Fatalw(msg string, keysAndValues ...interface{})

+ func (l *Logging) Info(args ...interface{})

+ func (l *Logging) Infof(template string, args ...interface{})

+ func (l *Logging) Infow(msg string, keysAndValues ...interface{})

+ func (l *Logging) Options() Options

+ func (l *Logging) SetLevel(lv Level)

+ func (l *Logging) Sync() error

+ func (l *Logging) Warn(args ...interface{})

+ func (l *Logging) Warnf(template string, args ...interface{})

+ func (l *Logging) Warnw(msg string, keysAndValues ...interface{})

+ func (l *Logging) WithCallDepth(callDepth int) Logger

+ func (l *Logging) WithContext(ctx context.Context) Logger

+ func (l *Logging) WithFields(fields map[string]any) Logger

+ type Option func(o *Options)

+ func Fields(fields map[string]any) Option

+ func WithCallerSkip(callerSkip int) Option

+ func WithCompress(compress bool) Option

+ func WithEncoder(encoder Encoder) Option

+ func WithEncoderConfig(encoderConfig zapcore.EncoderConfig) Option

+ func WithFilename(filename string) Option

+ func WithLevel(level Level) Option

+ func WithLocalTime(localTime bool) Option

+ func WithMaxAge(maxAge int) Option

+ func WithMaxBackups(maxBackups int) Option

+ func WithMaxSize(maxSize int) Option

+ func WithMode(mode string) Option

+ func WithNamespace(namespace string) Option

+ func WithRoll(roll RollingFormat) Option

+ func WithWriter(w io.Writer) Option

+ type Options struct

+ type RollingFile struct

+ Compress bool

+ Filename string

+ LocalTime bool

+ MaxAge int

+ MaxBackups int

+ MaxSize int

+ Rolling RollingFormat

+ func NewRollingFile(filename string, rolling RollingFormat, maxSize int, maxAge int, ...) *RollingFile

+ func (l *RollingFile) Close() error

+ func (l *RollingFile) Rotate() error

+ func (l *RollingFile) Sync() error

+ func (l *RollingFile) Write(p []byte) (n int, err error)

+ type RollingFormat string

+ type WrappedWriteSyncer struct

+ func (mws WrappedWriteSyncer) Sync() error

+ func (mws WrappedWriteSyncer) Write(p []byte) (n int, err error)