log

package module

Go to main page

Versions in this module

v1

v1.0.84

Sep 29, 2025

Changes in this version

+ var DefaultHumanReadableFormatter = &HumanReadableFormatter

+ var DefaultJSONFormatter = &JSONFormatter

type Entry

+ func (e *Entry) ToMap() (map[string]interface{}, error)

+ func (e *Entry) ToMapBeforeMsg() (map[string]interface{}, error)

+ type FormattedMultiLevelWriter struct

+ ConsoleFormatter Formatter

+ ConsoleLevel Level

+ ConsoleWriter Writer

+ ErrorFormatter Formatter

+ ErrorWriter Writer

+ InfoFormatter Formatter

+ InfoWriter Writer

+ WarnFormatter Formatter

+ WarnWriter Writer

+ func (w *FormattedMultiLevelWriter) Close() (err error)

+ func (w *FormattedMultiLevelWriter) SetConsoleFormatter(formatter Formatter)

+ func (w *FormattedMultiLevelWriter) SetErrorFormatter(formatter Formatter)

+ func (w *FormattedMultiLevelWriter) SetInfoFormatter(formatter Formatter)

+ func (w *FormattedMultiLevelWriter) SetWarnFormatter(formatter Formatter)

+ func (w *FormattedMultiLevelWriter) WriteEntry(e *Entry) (n int, err error)

+ type FormattedWriter interface

+ SetFormatter func(formatter Formatter)

+ type Formatter interface

+ Format func(entry *Entry) ([]byte, error)

+ type HumanReadableFormatter struct

+ ShowCaller bool

+ ShowLevel bool

+ ShowTimestamp bool

+ func (f *HumanReadableFormatter) Format(entry *Entry) ([]byte, error)

+ type JSONFormatter struct

+ func (f *JSONFormatter) Format(entry *Entry) ([]byte, error)

+ type TemplateFormatter struct

+ Pattern string

+ func DefaultTemplateFormatter(pattern string) *TemplateFormatter

+ func (f *TemplateFormatter) Format(entry *Entry) ([]byte, error)

v1.0.83

Apr 9, 2025

v1.0.82

Apr 7, 2025

v1.0.81

Apr 7, 2025

v1.0.80

Apr 7, 2025

Changes in this version

+ var ErrAsyncWriterFull = errors.New("async writer is full")

type AsyncWriter

+ DisableWritev bool

+ DiscardOnFull bool

+ func (w *AsyncWriter) Write(p []byte) (n int, err error)

+ type CategorizedLogger struct

+ Category string

+ type Client interface

+ Do func(req *http.Request) (*http.Response, error)

type Entry

+ func (e *Entry) NetIPAddrs(key string, ips []netip.Addr) *Entry

+ func (e *Entry) Objects(key string, objects any) *Entry

type FileWriter — linux/amd64

+ func (w *FileWriter) WriteV(iovs []syscall.Iovec) (n uintptr, err error)

type FormatterArgs

+ CallerFunc string

+ Category string

+ type HTTPWriter struct

+ Client Client

+ Headers map[string]string

+ Method string

+ QueryParams map[string]string

+ URL string

+ func (w HTTPWriter) WriteEntry(e *Entry) (n int, err error)

type Logger

+ func (l *Logger) Categorized(name string) *CategorizedLogger

v1.0.79

May 21, 2024

v1.0.78

May 13, 2024

v1.0.77

May 11, 2024

v1.0.76

May 11, 2024

Changes in this version

type Entry

+ func With(logr *Logger) (e *Entry)

+ func (e *Entry) Copy() Logger

type ID

+ func NewID() ID

v1.0.75

May 8, 2024

Changes in this version

+ const TimeFormatUnix

+ const TimeFormatUnixMs

+ const TimeFormatUnixWithMs

+ var DefaultLogger = Logger

+ var Epoch int64 = 1288834974657

+ var ErrInvalidBase32 = errors.New("invalid base32")

+ var ErrInvalidBase58 = errors.New("invalid base58")

+ var NodeBits uint8 = 10

+ var StepBits uint8 = 12

+ func Fastrandn(x uint32) uint32

+ func Goid() int64

+ func IsTerminal(fd uintptr) bool

+ func Printf(format string, v ...interface{})

+ func SlogNewJSONHandler(writer io.Writer, options *slog.HandlerOptions) slog.Handler

+ type AsyncWriter struct

+ ChannelSize uint

+ Writer Writer

+ func (w *AsyncWriter) Close() (err error)

+ func (w *AsyncWriter) WriteEntry(e *Entry) (int, error)

+ type ConsoleWriter struct

+ ColorOutput bool

+ EndWithMessage bool

+ Formatter func(w io.Writer, args *FormatterArgs) (n int, err error)

+ QuoteString bool

+ Writer io.Writer

+ func (w *ConsoleWriter) Close() (err error)

+ func (w *ConsoleWriter) WriteEntry(e *Entry) (int, error)

+ func (w *ConsoleWriter) WriteEntry(e *Entry) (n int, err error)

+ type Context []byte

+ type Entry struct

+ Level Level

+ func Debug() (e *Entry)

+ func Error() (e *Entry)

+ func Fatal() (e *Entry)

+ func Info() (e *Entry)

+ func NewContext(dst []byte) (e *Entry)

+ func Panic() (e *Entry)

+ func Trace() (e *Entry)

+ func Warn() (e *Entry)

+ func (e *Entry) AnErr(key string, err error) *Entry

+ func (e *Entry) Any(key string, value interface{}) *Entry

+ func (e *Entry) Bool(key string, b bool) *Entry

+ func (e *Entry) Bools(key string, b []bool) *Entry

+ func (e *Entry) Byte(key string, val byte) *Entry

+ func (e *Entry) Bytes(key string, val []byte) *Entry

+ func (e *Entry) BytesOrNil(key string, val []byte) *Entry

+ func (e *Entry) Caller(depth int) *Entry

+ func (e *Entry) Context(ctx Context) *Entry

+ func (e *Entry) Dict(key string, ctx Context) *Entry

+ func (e *Entry) Discard() *Entry

+ func (e *Entry) Dur(key string, d time.Duration) *Entry

+ func (e *Entry) Durs(key string, d []time.Duration) *Entry

+ func (e *Entry) EmbedObject(obj ObjectMarshaler) *Entry

+ func (e *Entry) Enabled() bool

+ func (e *Entry) Encode(key string, val []byte, enc interface{ ... }) *Entry

+ func (e *Entry) Err(err error) *Entry

+ func (e *Entry) Errs(key string, errs []error) *Entry

+ func (e *Entry) Fields(fields Fields) *Entry

+ func (e *Entry) Float32(key string, f float32) *Entry

+ func (e *Entry) Float64(key string, f float64) *Entry

+ func (e *Entry) Floats32(key string, f []float32) *Entry

+ func (e *Entry) Floats64(key string, f []float64) *Entry

+ func (e *Entry) Func(f func(e *Entry)) *Entry

+ func (e *Entry) GoStringer(key string, val fmt.GoStringer) *Entry

+ func (e *Entry) Hex(key string, val []byte) *Entry

+ func (e *Entry) IPAddr(key string, ip net.IP) *Entry

+ func (e *Entry) IPPrefix(key string, pfx net.IPNet) *Entry

+ func (e *Entry) Int(key string, i int) *Entry

+ func (e *Entry) Int16(key string, i int16) *Entry

+ func (e *Entry) Int32(key string, i int32) *Entry

+ func (e *Entry) Int64(key string, i int64) *Entry

+ func (e *Entry) Int8(key string, i int8) *Entry

+ func (e *Entry) Interface(key string, i interface{}) *Entry

+ func (e *Entry) Ints(key string, a []int) *Entry

+ func (e *Entry) Ints16(key string, a []int16) *Entry

+ func (e *Entry) Ints32(key string, a []int32) *Entry

+ func (e *Entry) Ints64(key string, a []int64) *Entry

+ func (e *Entry) Ints8(key string, a []int8) *Entry

+ func (e *Entry) KeysAndValues(keysAndValues ...interface{}) *Entry

+ func (e *Entry) MACAddr(key string, ha net.HardwareAddr) *Entry

+ func (e *Entry) Map(data any) *Entry

+ func (e *Entry) Msg(msg string)

+ func (e *Entry) Msgf(format string, v ...interface{})

+ func (e *Entry) Msgs(args ...interface{})

+ func (e *Entry) NetIPAddr(key string, ip netip.Addr) *Entry

+ func (e *Entry) NetIPAddrPort(key string, ipPort netip.AddrPort) *Entry

+ func (e *Entry) NetIPPrefix(key string, pfx netip.Prefix) *Entry

+ func (e *Entry) Object(key string, obj ObjectMarshaler) *Entry

+ func (e *Entry) RawJSON(key string, b []byte) *Entry

+ func (e *Entry) RawJSONStr(key string, s string) *Entry

+ func (e *Entry) Stack() *Entry

+ func (e *Entry) Str(key string, val string) *Entry

+ func (e *Entry) StrInt(key string, val int64) *Entry

+ func (e *Entry) Stringer(key string, val fmt.Stringer) *Entry

+ func (e *Entry) Strs(key string, vals []string) *Entry

+ func (e *Entry) Time(key string, t time.Time) *Entry

+ func (e *Entry) TimeDiff(key string, t time.Time, start time.Time) *Entry

+ func (e *Entry) TimeFormat(key string, timefmt string, t time.Time) *Entry

+ func (e *Entry) Times(key string, a []time.Time) *Entry

+ func (e *Entry) TimesFormat(key string, timefmt string, a []time.Time) *Entry

+ func (e *Entry) Type(key string, v interface{}) *Entry

+ func (e *Entry) Uint(key string, i uint) *Entry

+ func (e *Entry) Uint16(key string, i uint16) *Entry

+ func (e *Entry) Uint32(key string, i uint32) *Entry

+ func (e *Entry) Uint64(key string, i uint64) *Entry

+ func (e *Entry) Uint8(key string, i uint8) *Entry

+ func (e *Entry) Uints(key string, a []uint) *Entry

+ func (e *Entry) Uints16(key string, a []uint16) *Entry

+ func (e *Entry) Uints32(key string, a []uint32) *Entry

+ func (e *Entry) Uints64(key string, a []uint64) *Entry

+ func (e *Entry) Uints8(key string, a []uint8) *Entry

+ func (e *Entry) Value() Context

+ func (e *Entry) WithContext(ctx context.Context) *Entry

+ func (e *Entry) Xid(key string, id int64) *Entry

+ type EventlogWriter struct — windows/amd64

+ Host string

+ ID uintptr

+ Source string

+ func (w *EventlogWriter) Close() (err error)

+ func (w *EventlogWriter) WriteEntry(e *Entry) (n int, err error)

+ type Fields map[string]interface

+ type FileWriter struct

+ Cleaner func(filename string, maxBackups int, matches []os.FileInfo)

+ EnsureFolder bool

+ FileMode os.FileMode

+ Filename string

+ Header func(fileinfo os.FileInfo) []byte

+ HostName bool

+ LocalTime bool

+ MaxBackups int

+ MaxSize int64

+ ProcessID bool

+ TimeFormat string

+ func (w *FileWriter) Close() (err error)

+ func (w *FileWriter) Rotate() (err error)

+ func (w *FileWriter) Write(p []byte) (n int, err error)

+ func (w *FileWriter) WriteEntry(e *Entry) (n int, err error)

+ type FormatterArgs struct

+ Caller string

+ Goid string

+ KeyValues []struct{ ... }

+ Level string

+ Message string

+ Stack string

+ Time string

+ func (args *FormatterArgs) Get(key string) (value string)

+ type ID int64

+ func New() ID

+ func ParseBase2(id string) (ID, error)

+ func ParseBase32(b []byte) (ID, error)

+ func ParseBase36(id string) (ID, error)

+ func ParseBase58(b []byte) (ID, error)

+ func ParseBase64(id string) (ID, error)

+ func ParseBytes(id []byte) (ID, error)

+ func ParseInt64(id int64) ID

+ func ParseIntBytes(id [8]byte) ID

+ func ParseString(id string) (ID, error)

+ func (f *ID) UnmarshalJSON(b []byte) error

+ func (f ID) Base2() string

+ func (f ID) Base32() string

+ func (f ID) Base36() string

+ func (f ID) Base58() string

+ func (f ID) Base64() string

+ func (f ID) Bytes() []byte

+ func (f ID) Int64() int64

+ func (f ID) IntBytes() [8]byte

+ func (f ID) MarshalJSON() ([]byte, error)

+ func (f ID) Node() int64

+ func (f ID) Step() int64

+ func (f ID) String() string

+ func (f ID) Time() int64

+ type IOWriteCloser struct

+ func (w IOWriteCloser) Close() (err error)

+ func (w IOWriteCloser) WriteEntry(e *Entry) (n int, err error)

+ type IOWriter struct

+ func (w IOWriter) WriteEntry(e *Entry) (n int, err error)

+ type JSONSyntaxError struct

+ func (j JSONSyntaxError) Error() string

+ type JournalWriter struct — linux/amd64

+ JournalSocket string

+ func (w *JournalWriter) Close() (err error)

+ func (w *JournalWriter) WriteEntry(e *Entry) (n int, err error)

+ type Level uint32

+ const DebugLevel

+ const ErrorLevel

+ const FatalLevel

+ const InfoLevel

+ const PanicLevel

+ const TraceLevel

+ const WarnLevel

+ func ParseLevel(s string) (level Level)

+ func (l Level) String() (s string)

+ type LogfmtFormatter struct

+ TimeField string

+ func (f LogfmtFormatter) Formatter(out io.Writer, args *FormatterArgs) (n int, err error)

+ type Logger struct

+ Caller int

+ Context Context

+ EnableTracing bool

+ Level Level

+ LogNode bool

+ TimeField string

+ TimeFormat string

+ TimeLocation *time.Location

+ TraceIDField string

+ Writer Writer

+ func (l *Logger) Debug() (e *Entry)

+ func (l *Logger) Err(err error) (e *Entry)

+ func (l *Logger) Error() (e *Entry)

+ func (l *Logger) Fatal() (e *Entry)

+ func (l *Logger) Info() (e *Entry)

+ func (l *Logger) Log() (e *Entry)

+ func (l *Logger) Panic() (e *Entry)

+ func (l *Logger) Printf(format string, v ...interface{})

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

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

+ func (l *Logger) Std(prefix string, flag int) *stdLog.Logger

+ func (l *Logger) Trace() (e *Entry)

+ func (l *Logger) Warn() (e *Entry)

+ func (l *Logger) WithLevel(level Level) (e *Entry)

+ type MultiEntryWriter []Writer

+ func (w *MultiEntryWriter) Close() (err error)

+ func (w *MultiEntryWriter) WriteEntry(e *Entry) (n int, err error)

+ type MultiIOWriter []io.Writer

+ func (w *MultiIOWriter) Close() (err error)

+ func (w *MultiIOWriter) WriteEntry(e *Entry) (n int, err error)

+ type MultiLevelWriter struct

+ ConsoleLevel Level

+ ConsoleWriter Writer

+ ErrorWriter Writer

+ InfoWriter Writer

+ WarnWriter Writer

+ func (w *MultiLevelWriter) Close() (err error)

+ func (w *MultiLevelWriter) WriteEntry(e *Entry) (n int, err error)

+ type MultiWriter = MultiLevelWriter

+ type Node struct

+ func NewNode(node int64) (*Node, error)

+ func (n *Node) New() ID

+ type ObjectMarshaler interface

+ MarshalObject func(e *Entry)

+ type SyslogWriter struct

+ Address string

+ Dial func(network, addr string) (net.Conn, error)

+ Hostname string

+ Marker string

+ Network string

+ Tag string

+ func (w *SyslogWriter) Close() (err error)

+ func (w *SyslogWriter) WriteEntry(e *Entry) (n int, err error)

+ type TSVEntry struct

+ func (e *TSVEntry) Bool(b bool) *TSVEntry

+ func (e *TSVEntry) BoolString(b bool) *TSVEntry

+ func (e *TSVEntry) Byte(b byte) *TSVEntry

+ func (e *TSVEntry) Bytes(val []byte) *TSVEntry

+ func (e *TSVEntry) Caller(depth int) *TSVEntry

+ func (e *TSVEntry) Encode(key string, val []byte, enc interface{ ... }) *TSVEntry

+ func (e *TSVEntry) Float32(f float32) *TSVEntry

+ func (e *TSVEntry) Float64(f float64) *TSVEntry

+ func (e *TSVEntry) IPAddr(ip net.IP) *TSVEntry

+ func (e *TSVEntry) Int(i int) *TSVEntry

+ func (e *TSVEntry) Int16(i int16) *TSVEntry

+ func (e *TSVEntry) Int32(i int32) *TSVEntry

+ func (e *TSVEntry) Int64(i int64) *TSVEntry

+ func (e *TSVEntry) Int8(i int8) *TSVEntry

+ func (e *TSVEntry) Msg()

+ func (e *TSVEntry) NetIPAddr(ip netip.Addr) *TSVEntry

+ func (e *TSVEntry) NetIPAddrPort(ipPort netip.AddrPort) *TSVEntry

+ func (e *TSVEntry) NetIPPrefix(pfx netip.Prefix) *TSVEntry

+ func (e *TSVEntry) Str(val string) *TSVEntry

+ func (e *TSVEntry) Timestamp() *TSVEntry

+ func (e *TSVEntry) TimestampMS() *TSVEntry

+ func (e *TSVEntry) Uint(i uint) *TSVEntry

+ func (e *TSVEntry) Uint16(i uint16) *TSVEntry

+ func (e *TSVEntry) Uint32(i uint32) *TSVEntry

+ func (e *TSVEntry) Uint64(i uint64) *TSVEntry

+ func (e *TSVEntry) Uint8(i uint8) *TSVEntry

+ type TSVLogger struct

+ Separator byte

+ Writer io.Writer

+ func (l *TSVLogger) New() (e *TSVEntry)

+ type Writer interface

+ WriteEntry func(*Entry) (int, error)

+ type WriterFunc func(*Entry) (int, error)

+ func (f WriterFunc) WriteEntry(e *Entry) (int, error)

v1.0.74

Aug 18, 2023

v1.0.73

Mar 17, 2023

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL