srog

package module

Go to main page

Versions in this module

v1

v1.2.0

Jul 19, 2026

Changes in this version

type Format

+ const FormatTemplate

type SinkOption

+ func AsTemplate(tmpl string) SinkOption

type SinkSpec

+ Template string

v1.1.1

Jul 14, 2026

v1.1.0

Jul 14, 2026

Changes in this version

+ func RegisterSinkType(name string, factory SinkFactory)

type Format

+ const FormatOTel

+ type SinkFactory func(cfg Config, spec SinkSpec) (w io.Writer, format Format, err error)

type SinkOption

+ func AsOTel() SinkOption

type SinkSpec

+ Options map[string]any

+ func (s SinkSpec) DecodeOptions(v any) error

v1.0.0

Jul 4, 2026

Changes in this version

+ const StackFieldName

+ const TimeDateOnly

+ const TimeDateTime

+ const TimeKitchen

+ const TimeOnly

+ const TimeRFC3339

+ const TimeRFC3339Nano

+ const TimeUnix

+ const TimeUnixMicro

+ const TimeUnixMs

+ const TimeUnixNano

+ func AddContextField(fn ContextFieldFunc)

+ func Debug(tmpl string, args ...any)

+ func DebugCtx(ctx context.Context, tmpl string, args ...any)

+ func Error(err error, tmpl string, args ...any)

+ func ErrorCtx(ctx context.Context, err error, tmpl string, args ...any)

+ func Fatal(err error, tmpl string, args ...any)

+ func FatalCtx(ctx context.Context, err error, tmpl string, args ...any)

+ func Info(tmpl string, args ...any)

+ func InfoCtx(ctx context.Context, tmpl string, args ...any)

+ func Information(tmpl string, args ...any)

+ func InformationCtx(ctx context.Context, tmpl string, args ...any)

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

+ func NewID() string

+ func SetDefault(l *Logger)

+ func Verbose(tmpl string, args ...any)

+ func VerboseCtx(ctx context.Context, tmpl string, args ...any)

+ func Warning(tmpl string, args ...any)

+ func WarningCtx(ctx context.Context, tmpl string, args ...any)

+ type Config struct

+ Caller bool

+ Level string

+ Render *bool

+ Sinks []SinkSpec

+ StackTrace bool

+ TimeFormat string

+ Timestamp *bool

+ func LoadConfig(r io.Reader) (Config, error)

+ func LoadConfigFile(path string) (Config, error)

+ func (c Config) Build() (*Logger, error)

+ func (c Config) Options() ([]Option, error)

+ type ContextFieldFunc func(ctx context.Context) []Field

+ type Field struct

+ Name string

+ Value any

+ type Format uint8

+ const FormatConsole

+ const FormatECS

+ const FormatJSON

+ type Interval uint8

+ const Daily

+ const Hourly

+ const NoInterval

+ type Level int8

+ const DebugLevel

+ const ErrorLevel

+ const FatalLevel

+ const InformationLevel

+ const VerboseLevel

+ const WarningLevel

+ func ParseLevel(s string) (Level, error)

+ type Logger struct

+ func Ctx(ctx context.Context) *Logger

+ func Default() *Logger

+ func ForContext(name string, value any) *Logger

+ func FromContext(ctx context.Context) *Logger

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

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

+ func NewConsole() *Logger

+ func NewFromConfig(c Config) (*Logger, error)

+ func NewFromConfigFile(path string) (*Logger, error)

+ func (l *Logger) Close() error

+ func (l *Logger) Debug(tmpl string, args ...any)

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

+ func (l *Logger) Error(err error, tmpl string, args ...any)

+ func (l *Logger) Fatal(err error, tmpl string, args ...any)

+ func (l *Logger) ForContext(name string, value any) *Logger

+ func (l *Logger) ForContextValues(fields map[string]any) *Logger

+ func (l *Logger) Info(tmpl string, args ...any)

+ func (l *Logger) Information(tmpl string, args ...any)

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

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

+ func (l *Logger) Verbose(tmpl string, args ...any)

+ func (l *Logger) Warning(tmpl string, args ...any)

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

+ func (l *Logger) WithStackTrace(on bool) *Logger

+ type Option func(*config)

+ func WithCaller(on bool) Option

+ func WithConsole(opts ...SinkOption) Option

+ func WithErrorHandler(fn func(error)) Option

+ func WithFile(path string, opts ...SinkOption) Option

+ func WithLevel(l Level) Option

+ func WithRenderedMessage(on bool) Option

+ func WithSampling(s Sampler) Option

+ func WithStackTrace(on bool) Option

+ func WithTimeFormat(layout string) Option

+ func WithTimestamp(on bool) Option

+ func WithWriter(w io.Writer, opts ...SinkOption) Option

+ type Rotation struct

+ Compress bool

+ Every Interval

+ LocalTime bool

+ MaxAgeDays int

+ MaxBackups int

+ MaxSizeMB int

+ type RotationSpec struct

+ Compress bool

+ Every string

+ LocalTime bool

+ MaxAgeDays int

+ MaxBackups int

+ MaxSizeMB int

+ type Sampler = zerolog.Sampler

+ func BurstLimit(burst uint32, period time.Duration, next Sampler) Sampler

+ func EveryN(n uint32) Sampler

+ type SinkOption func(*sinkConfig)

+ func AsConsole() SinkOption

+ func AsECS() SinkOption

+ func AsJSON() SinkOption

+ func Async(bufferSize int) SinkOption

+ func MinLevel(l Level) SinkOption

+ func NoColor() SinkOption

+ func Rotate(r Rotation) SinkOption

+ type SinkSpec struct

+ Format string

+ Level string

+ NoColor bool

+ Path string

+ Rotation *RotationSpec

+ Target string

+ Type string

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