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

dlog

package module

Go to main page

Versions in this module

v1

v1.0.1

Mar 5, 2026

Changes in this version

+ type Level int

+ const LevelDebug

+ const LevelError

+ const LevelInfo

+ const LevelWarn

type Option

+ func WithOutputFile(path string) Option

v1.0.0

Mar 2, 2026

retracted

Changes in this version

+ func FilterFields(entry map[string]any, includeFields, excludeFields []string) map[string]any

+ type DebugLogger interface

+ Close func() error

+ Enabled func() bool

+ LogDebug func(ctx context.Context, message string, fieldMap ...FieldMap)

+ LogError func(ctx context.Context, message string, err error, fieldMap ...FieldMap)

+ LogInfo func(ctx context.Context, message string, fieldMap ...FieldMap)

+ LogWarn func(ctx context.Context, message string, fieldMap ...FieldMap)

+ WithFields func(fields FieldMap) DebugLogger

+ WithGroup func(name string) DebugLogger

+ func NewSlogLogger(enabled bool, outputFile string, format Format, opts ...Option) (DebugLogger, error)

+ type FieldMap map[string]any

+ type Format string

+ const FormatJSON

+ const FormatLogfmt

+ const FormatLogstash

+ const FormatText

+ type HandlerOptions struct

+ ExcludeFields []string

+ IncludeFields []string

+ Level slog.Level

+ type LogfmtHandler struct

+ func NewLogfmtHandler(w io.Writer, opts *HandlerOptions) *LogfmtHandler

+ func (h *LogfmtHandler) Enabled(_ context.Context, level slog.Level) bool

+ func (h *LogfmtHandler) Handle(_ context.Context, r slog.Record) error

+ func (h *LogfmtHandler) WithAttrs(attrs []slog.Attr) slog.Handler

+ func (h *LogfmtHandler) WithGroup(name string) slog.Handler

+ type LogstashHandler struct

+ func NewLogstashHandler(w io.Writer, opts *HandlerOptions) *LogstashHandler

+ func (h *LogstashHandler) Enabled(ctx context.Context, level slog.Level) bool

+ func (h *LogstashHandler) Handle(ctx context.Context, r slog.Record) error

+ func (h *LogstashHandler) WithAttrs(attrs []slog.Attr) slog.Handler

+ func (h *LogstashHandler) WithGroup(name string) slog.Handler

+ type MultiWriter struct

+ func NewMultiWriter(outputFile string, syncMode SyncMode, syncInterval time.Duration) (*MultiWriter, error)

+ func (m *MultiWriter) Close() error

+ func (m *MultiWriter) Write(p []byte) (n int, err error)

+ type NoOpLogger struct

+ func NewNoOpLogger() *NoOpLogger

+ func (n *NoOpLogger) Close() error

+ func (n *NoOpLogger) Enabled() bool

+ func (n *NoOpLogger) LogDebug(ctx context.Context, message string, fieldMap ...FieldMap)

+ func (n *NoOpLogger) LogError(_ context.Context, _ string, _ error, _ ...FieldMap)

+ func (n *NoOpLogger) LogInfo(ctx context.Context, message string, fieldMap ...FieldMap)

+ func (n *NoOpLogger) LogWarn(ctx context.Context, message string, fieldMap ...FieldMap)

+ func (n *NoOpLogger) WithFields(_ FieldMap) DebugLogger

+ func (n *NoOpLogger) WithGroup(_ string) DebugLogger

+ type Option func(*config)

+ func WithExcludeFields(fields []string) Option

+ func WithFields(fields FieldMap) Option

+ func WithGroup(name string) Option

+ func WithIncludeFields(fields []string) Option

+ func WithMinLevel(level slog.Level) Option

+ func WithSyncInterval(interval time.Duration) Option

+ func WithSyncMode(mode SyncMode) Option

+ type SlogLogger struct

+ func (s *SlogLogger) Close() error

+ func (s *SlogLogger) Enabled() bool

+ func (s *SlogLogger) LogDebug(ctx context.Context, message string, fieldMap ...FieldMap)

+ func (s *SlogLogger) LogError(ctx context.Context, message string, err error, fieldMap ...FieldMap)

+ func (s *SlogLogger) LogInfo(ctx context.Context, message string, fieldMap ...FieldMap)

+ func (s *SlogLogger) LogWarn(ctx context.Context, message string, fieldMap ...FieldMap)

+ func (s *SlogLogger) WithFields(fields FieldMap) DebugLogger

+ func (s *SlogLogger) WithGroup(name string) DebugLogger

+ type SyncMode int

+ const SyncBuffered

+ const SyncImmediate

+ const SyncPeriodic

+ type TextHandler struct

+ func NewTextHandler(w io.Writer, opts *HandlerOptions) *TextHandler

+ func (h *TextHandler) Enabled(_ context.Context, level slog.Level) bool

+ func (h *TextHandler) Handle(_ context.Context, r slog.Record) error

+ func (h *TextHandler) WithAttrs(attrs []slog.Attr) slog.Handler

+ func (h *TextHandler) WithGroup(name string) slog.Handler