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

log

package

Go to main page

Versions in this module

v1

v1.0.4

Sep 26, 2025

Changes in this version

+ const LevelCrit

+ const LevelDebug

+ const LevelError

+ const LevelInfo

+ const LevelTrace

+ const LevelWarn

+ func FormatSlogValue(v slog.Value, tmp []byte) (result []byte)

+ func FromLegacyLevel(lvl int) slog.Level

+ func JSONHandler(wr io.Writer) slog.Handler

+ func JSONHandlerWithLevel(wr io.Writer, level slog.Level) slog.Handler

+ func LevelAlignedString(l slog.Level) string

+ func LevelFromString(lvlString string) (slog.Level, error)

+ func LevelString(l slog.Level) string

+ func LogfmtHandler(wr io.Writer) slog.Handler

+ func LogfmtHandlerWithLevel(wr io.Writer, level slog.Level) slog.Handler

+ func SetDefault(l Logger)

+ func SetTermTimeFormat(format string)

+ func SetTimeFormat(format string)

type GlogHandler

+ func (h *GlogHandler) Enabled(ctx context.Context, lvl slog.Level) bool

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

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

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

type Logger

+ func NewLogger(h slog.Handler) Logger

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

+ Handler func() slog.Handler

+ Log func(level slog.Level, msg string, ctx ...interface{})

+ With func(ctx ...interface{}) Logger

+ Write func(level slog.Level, msg string, attrs ...any)

+ type TerminalHandler struct

+ func NewTerminalHandler(wr io.Writer, useColor bool) *TerminalHandler

+ func NewTerminalHandlerWithLevel(wr io.Writer, lvl slog.Level, useColor bool) *TerminalHandler

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

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

+ func (h *TerminalHandler) ResetFieldPadding()

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

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

+ type TimeTicker struct

+ C <-chan time.Time

+ func NewTimeTicker(rotateHours uint) *TimeTicker

+ func (tt *TimeTicker) Stop()

v1.0.3

Aug 5, 2025

v1.0.2

Apr 9, 2025

Changes in this version

+ var Must muster

+ var StderrHandler = StreamHandler(os.Stderr, LogfmtFormat())

+ var StdoutHandler = StreamHandler(os.Stdout, LogfmtFormat())

+ func Crit(msg string, ctx ...interface{})

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

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

+ func FormatLogfmtInt64(n int64) string

+ func FormatLogfmtUint64(n uint64) string

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

+ func Output(msg string, lvl Lvl, calldepth int, ctx ...interface{})

+ func PrintOrigins(print bool)

+ func Trace(msg string, ctx ...interface{})

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

+ type AsyncFileWriter struct

+ func NewAsyncFileWriter(filePath string, bufSize int64) *AsyncFileWriter

+ func (w *AsyncFileWriter) Flush() error

+ func (w *AsyncFileWriter) Start() error

+ func (w *AsyncFileWriter) Stop()

+ func (w *AsyncFileWriter) SyncWrite(msg []byte)

+ func (w *AsyncFileWriter) Write(msg []byte) (n int, err error)

+ type Ctx map[string]interface

+ type Format interface

+ Format func(r *Record) []byte

+ func FormatFunc(f func(*Record) []byte) Format

+ func JSONFormat() Format

+ func JSONFormatEx(pretty, lineSeparated bool) Format

+ func JSONFormatOrderedEx(pretty, lineSeparated bool) Format

+ func LogfmtFormat() Format

+ func TerminalFormat(usecolor bool) Format

+ type GlogHandler struct

+ func NewGlogHandler(h Handler) *GlogHandler

+ func (h *GlogHandler) BacktraceAt(location string) error

+ func (h *GlogHandler) Log(r *Record) error

+ func (h *GlogHandler) SetHandler(nh Handler)

+ func (h *GlogHandler) Verbosity(level Lvl)

+ func (h *GlogHandler) Vmodule(ruleset string) error

+ type Handler interface

+ Log func(r *Record) error

+ func BufferedHandler(bufSize int, h Handler) Handler

+ func CallerFileHandler(h Handler) Handler

+ func CallerFuncHandler(h Handler) Handler

+ func CallerStackHandler(format string, h Handler) Handler

+ func ChannelHandler(recs chan<- *Record) Handler

+ func DiscardHandler() Handler

+ func FailoverHandler(hs ...Handler) Handler

+ func FileHandler(path string, fmtr Format) (Handler, error)

+ func FilterHandler(fn func(r *Record) bool, h Handler) Handler

+ func FuncHandler(fn func(r *Record) error) Handler

+ func LazyHandler(h Handler) Handler

+ func LvlFilterHandler(maxLvl Lvl, h Handler) Handler

+ func MatchFilterHandler(key string, value interface{}, h Handler) Handler

+ func MultiHandler(hs ...Handler) Handler

+ func NetHandler(network, addr string, fmtr Format) (Handler, error)

+ func NewFileLvlHandler(logPath string, maxBytesSize uint, level string) Handler

+ func RotatingFileHandler(filePath string, limit uint, formatter Format) (Handler, error)

+ func StreamHandler(wr io.Writer, fmtr Format) Handler

+ func SyncHandler(h Handler) Handler

+ func SyslogHandler(priority syslog.Priority, tag string, fmtr Format) (Handler, error)

+ func SyslogNetHandler(net, addr string, priority syslog.Priority, tag string, fmtr Format) (Handler, error)

+ type HourTicker struct

+ C <-chan time.Time

+ func NewHourTicker() *HourTicker

+ func (ht *HourTicker) Stop()

+ func (ht *HourTicker) Ticker() <-chan time.Time

+ type Lazy struct

+ Fn interface{}

+ type Logger interface

+ Crit func(msg string, ctx ...interface{})

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

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

+ GetHandler func() Handler

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

+ New func(ctx ...interface{}) Logger

+ SetHandler func(h Handler)

+ Trace func(msg string, ctx ...interface{})

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

+ func New(ctx ...interface{}) Logger

+ func Root() Logger

+ type Lvl int

+ const LvlCrit

+ const LvlDebug

+ const LvlError

+ const LvlInfo

+ const LvlTrace

+ const LvlWarn

+ func LvlFromString(lvlString string) (Lvl, error)

+ func (l Lvl) AlignedString() string

+ func (l Lvl) String() string

+ type Record struct

+ Call stack.Call

+ Ctx []interface{}

+ KeyNames RecordKeyNames

+ Lvl Lvl

+ Msg string

+ Time time.Time

+ type RecordKeyNames struct

+ Ctx string

+ Lvl string

+ Msg string

+ Time string

+ type TerminalStringer interface

+ TerminalString func() string