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
- API
  
  Reference documentation for the pkg.go.dev API
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.5

Oct 29, 2026

v1.0.4

Oct 28, 2026

v1.0.3

Oct 28, 2026

Changes in this version

type Logger

+ func (l *Logger) Stats() []SinkStats

v1.0.2

Oct 28, 2026

Changes in this version

+ type DeliveryConfig struct

+ BatchSize int

+ BufferSize int

+ FlushInterval time.Duration

+ MaxRetries int

+ RetryInitialWait time.Duration

+ RetryMaxWait time.Duration

+ ShutdownTimeout time.Duration

type Logger

+ func (l *Logger) Close(ctx context.Context) error

+ func (l *Logger) Shutdown() error

+ type LokiConfig struct

+ Delivery DeliveryConfig

+ Labels []string

+ StaticLabels map[string]string

+ URL string

type Option

+ func WithConsoleLevel(level slog.Level) Option

+ func WithConsoleLevelString(level string) Option

+ func WithJSONLevel(level slog.Level) Option

+ func WithJSONLevelString(level string) Option

+ func WithLoki(lokiCfg LokiConfig) Option

+ func WithVictoriaLogs(vlCfg VictoriaLogsConfig) Option

+ func WithoutConsole() Option

+ type SinkStats struct

+ DroppedOverflow uint64

+ DroppedRetriesExhausted uint64

+ SendErrors uint64

+ type VictoriaLogsConfig struct

+ Delivery DeliveryConfig

+ StaticLabels map[string]string

+ StreamFields []string

+ URL string

v1.0.1

Sep 27, 2026

v1.0.0

Aug 20, 2026

Changes in this version

+ var Any = slog.Any

+ var Bool = slog.Bool

+ var Duration = slog.Duration

+ var Float64 = slog.Float64

+ var Int = slog.Int

+ var Int64 = slog.Int64

+ var String = slog.String

+ var Time = slog.Time

+ func Debug(msg string, attrs ...Attr)

+ func DebugContext(ctx context.Context, msg string, attrs ...Attr)

+ func Error(msg string, attrs ...Attr)

+ func ErrorContext(ctx context.Context, msg string, attrs ...Attr)

+ func Fatal(msg string, attrs ...Attr)

+ func FatalContext(ctx context.Context, msg string, attrs ...Attr)

+ func GetLogLevel() string

+ func Info(msg string, attrs ...Attr)

+ func InfoContext(ctx context.Context, msg string, attrs ...Attr)

+ func Init(opts ...Option)

+ func NewContext(ctx context.Context, l *Logger) context.Context

+ func SetDefault(l *Logger)

+ func SetLogLevel(level string)

+ func Trace(msg string, attrs ...Attr)

+ func TraceContext(ctx context.Context, msg string, attrs ...Attr)

+ func Warn(msg string, attrs ...Attr)

+ func WarnContext(ctx context.Context, msg string, attrs ...Attr)

+ type Attr = slog.Attr

+ func Err(err error) Attr

+ type Logger struct

+ func Default() *Logger

+ func FromContext(ctx context.Context) *Logger

+ func Named(component string) *Logger

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

+ func With(attrs ...Attr) *Logger

+ func (l *Logger) Debug(msg string, attrs ...Attr)

+ func (l *Logger) DebugContext(ctx context.Context, msg string, attrs ...Attr)

+ func (l *Logger) Enabled(ctx context.Context, level slog.Level) bool

+ func (l *Logger) Error(msg string, attrs ...Attr)

+ func (l *Logger) ErrorContext(ctx context.Context, msg string, attrs ...Attr)

+ func (l *Logger) Fatal(msg string, attrs ...Attr)

+ func (l *Logger) FatalContext(ctx context.Context, msg string, attrs ...Attr)

+ func (l *Logger) GetLogLevel() string

+ func (l *Logger) Handler() slog.Handler

+ func (l *Logger) Info(msg string, attrs ...Attr)

+ func (l *Logger) InfoContext(ctx context.Context, msg string, attrs ...Attr)

+ func (l *Logger) Level() slog.Level

+ func (l *Logger) Log(ctx context.Context, level slog.Level, msg string, attrs ...Attr)

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

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

+ func (l *Logger) SetLogLevel(level string)

+ func (l *Logger) Slog() *slog.Logger

+ func (l *Logger) Trace(msg string, attrs ...Attr)

+ func (l *Logger) TraceContext(ctx context.Context, msg string, attrs ...Attr)

+ func (l *Logger) Warn(msg string, attrs ...Attr)

+ func (l *Logger) WarnContext(ctx context.Context, msg string, attrs ...Attr)

+ func (l *Logger) With(attrs ...Attr) *Logger

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

+ type Option func(*config)

+ func WithComponent(component string) Option

+ func WithExit(exit func(int)) Option

+ func WithFile(path string) Option

+ func WithJSONOutput(w io.Writer) Option

+ func WithLevel(level slog.Level) Option

+ func WithLevelString(level string) Option

+ func WithNoColor(noColor bool) Option

+ func WithOutput(w io.Writer) Option

+ func WithTimeFormat(format string) Option

+ func WithoutFile() Option

+ type SlogLogger = Logger