Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  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

Go to main page

Versions in this module

v1

v1.0.2

Dec 24, 2025

v1.0.1-beta.1

Oct 22, 2025

v1.0.0

Jul 25, 2025

Changes in this version

+ var DefaultLogDir = "logs"

+ var DefaultLogFile = "app.log"

+ func CleanupLogFile(filepath string) error

+ func CleanupLogFiles() error

+ func Debug(msg string, fields ...interface{})

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

+ func EnsureLogDir() error

+ func EnsureLogDirForPath(logPath string) error

+ func Error(msg string, fields ...interface{})

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

+ func Fatal(msg string, fields ...interface{})

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

+ func GetDefaultLogDir() string

+ func GetDefaultLogFile() string

+ func GetDefaultLogPath() string

+ func Info(msg string, fields ...interface{})

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

+ func Init(opts Options)

+ func InitWithLogger(logger *Logger)

+ func IsEnabled(level Level) bool

+ func Panic(msg string, fields ...interface{})

+ func Panicf(format string, args ...interface{})

+ func SetContextExtractor(extractor ContextExtractor)

+ func SetDefaultLogDir(dir string)

+ func SetDefaultLogFile(filepath string)

+ func SetDefaultLogger(logger *Logger)

+ func SetLevel(level Level)

+ func SetupDevelopment()

+ func SetupProduction()

+ func SetupWithOptions(opts Options)

+ func Sync() error

+ func Warn(msg string, fields ...interface{})

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

+ type ContextExtractor interface

+ Extract func(ctx context.Context) map[string]interface{}

+ func GetContextExtractor() ContextExtractor

+ type ContextKey string

+ type DefaultContextExtractor struct

+ func (d *DefaultContextExtractor) Extract(ctx context.Context) map[string]interface{}

+ type Format string

+ const FormatConsole

+ const FormatJSON

+ const FormatText

+ func ParseFormat(format string) Format

+ func (f Format) String() string

+ type Hook func(entry zapcore.Entry) error

+ type Level int8

+ const DebugLevel

+ const ErrorLevel

+ const FatalLevel

+ const InfoLevel

+ const WarnLevel

+ func GetLevel() Level

+ func ParseLevel(level string) Level

+ func (l Level) String() string

+ type Logger struct

+ func FromContext(ctx context.Context) *Logger

+ func GetDefaultLogger() *Logger

+ func Named(name string) *Logger

+ func New() *Logger

+ func NewDevelopment() *Logger

+ func NewNop() *Logger

+ func NewProduction() *Logger

+ func NewWithOptions(opts Options) *Logger

+ func With(fields ...interface{}) *Logger

+ func WithContext(ctx context.Context) *Logger

+ func WithError(err error) *Logger

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

+ func (l *Logger) AddHook(hook Hook)

+ func (l *Logger) Clone() *Logger

+ func (l *Logger) Debug(msg string, fields ...interface{})

+ func (l *Logger) Debugf(format string, args ...interface{})

+ func (l *Logger) Error(msg string, fields ...interface{})

+ func (l *Logger) Errorf(format string, args ...interface{})

+ func (l *Logger) Fatal(msg string, fields ...interface{})

+ func (l *Logger) Fatalf(format string, args ...interface{})

+ func (l *Logger) GetLevel() Level

+ func (l *Logger) GetSugar() *zap.SugaredLogger

+ func (l *Logger) GetZap() *zap.Logger

+ func (l *Logger) Info(msg string, fields ...interface{})

+ func (l *Logger) Infof(format string, args ...interface{})

+ func (l *Logger) IsEnabled(level Level) bool

+ func (l *Logger) Named(name string) *Logger

+ func (l *Logger) Panic(msg string, fields ...interface{})

+ func (l *Logger) Panicf(format string, args ...interface{})

+ func (l *Logger) RemoveHooks()

+ func (l *Logger) SetLevel(level Level)

+ func (l *Logger) Sync() error

+ func (l *Logger) Warn(msg string, fields ...interface{})

+ func (l *Logger) Warnf(format string, args ...interface{})

+ func (l *Logger) With(fields ...interface{}) *Logger

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

+ func (l *Logger) WithError(err error) *Logger

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

+ type Options struct

+ Caller bool

+ EnableFileOutput bool

+ Fields map[string]interface{}

+ Format Format

+ Hooks []Hook

+ Level Level

+ Rotate *RotateConfig

+ Sampling *SamplingConfig

+ Stacktrace bool

+ TimeFormat string

+ type RotateConfig struct

+ Compress bool

+ Filename string

+ LocalTime bool

+ MaxAge int

+ MaxBackups int

+ MaxSize int

+ type SamplingConfig struct

+ Initial int

+ Thereafter int

+ Tick time.Duration