hyperlogger

package module

Go to main page

Versions in this module

v0

v0.1.1

Jan 17, 2026

v0.1.0

Jan 16, 2026

v0.0.9

Jan 15, 2026

v0.0.8

Jan 3, 2026

v0.0.7

Dec 27, 2025

v0.0.6

Dec 23, 2025

v0.0.5

Oct 20, 2025

Changes in this version

type Config

+ AsyncDropPayloadHandler DropPayloadHandler

type ConfigBuilder

+ func (b *ConfigBuilder) WithAsyncDropPayloadHandler(handler DropPayloadHandler) *ConfigBuilder

+ type DropPayload interface

+ AppendTo func(dst []byte) []byte

+ Bytes func() []byte

+ Retain func() PayloadLease

+ Size func() int

+ type DropPayloadHandler func(DropPayload)

+ type PayloadLease interface

+ Bytes func() []byte

+ Release func()

v0.0.4

Oct 18, 2025

Changes in this version

+ func ClearAsyncMetricsHandlers()

+ func ClearContextExtractors()

+ func EmitAsyncMetrics(ctx context.Context, metrics AsyncMetrics)

+ func RegisterAsyncMetricsHandler(handler AsyncMetricsHandler)

+ func RegisterContextExtractor(extractor ContextExtractor)

+ type AsyncMetrics struct

+ Bypassed uint64

+ Dropped uint64

+ Enqueued uint64

+ Processed uint64

+ QueueDepth int

+ Retried uint64

+ WriteError uint64

+ type AsyncMetricsExporter struct

+ func NewAsyncMetricsExporter() *AsyncMetricsExporter

+ func (e *AsyncMetricsExporter) Observe(_ context.Context, metrics AsyncMetrics)

+ func (e *AsyncMetricsExporter) ServeHTTP(w http.ResponseWriter, _ *http.Request)

+ type AsyncMetricsHandler func(context.Context, AsyncMetrics)

type AsyncOverflowStrategy

+ const AsyncOverflowHandoff

type Config

+ AsyncMetricsHandler AsyncMetricsHandler

type ConfigBuilder

+ func (b *ConfigBuilder) WithAsyncMetricsHandler(handler AsyncMetricsHandler) *ConfigBuilder

+ func (b *ConfigBuilder) WithSamplingRule(level Level, rule SamplingRule) *ConfigBuilder

+ func (b *ConfigBuilder) WithSamplingRules(rules map[Level]SamplingRule) *ConfigBuilder

type ContextExtractor

+ func GlobalContextExtractors() []ContextExtractor

type Field

+ func ApplyContextExtractors(ctx context.Context, extractors ...ContextExtractor) []Field

type SamplingConfig

+ Rules map[Level]SamplingRule

+ type SamplingRule struct

+ Enabled bool

+ Initial int

+ Thereafter int

v0.0.3

Oct 16, 2025

Changes in this version

type Config

+ FileCompress bool

+ FileMaxSize int64

+ FilePath string

type HookRegistry

+ func (r *HookRegistry) AddFunc(level Level, hookFunc LogHookFunc)

+ func (r *HookRegistry) Dispatch(ctx context.Context, entry *Entry) []error

+ func (r *HookRegistry) RemoveFuncs(level Level)

+ func (r *HookRegistry) ResetFuncs()

v0.0.2

Oct 12, 2025

v0.0.1

Oct 12, 2025

Changes in this version

+ const Black

+ const Blue

+ const BoldBlack

+ const BoldBlue

+ const BoldCyan

+ const BoldGreen

+ const BoldMagenta

+ const BoldRed

+ const BoldWhite

+ const BoldYellow

+ const Cyan

+ const DefaultAsyncBufferSize

+ const DefaultBufferSize

+ const DefaultCompression

+ const DefaultLevel

+ const DefaultMaxFileSizeMB

+ const DefaultSamplingInitial

+ const DefaultSamplingThereafter

+ const DefaultTimeFormat

+ const Green

+ const LogFilePermissions

+ const Magenta

+ const Red

+ const Reset

+ const White

+ const Yellow

+ func DefaultLevelColors() map[Level]string

+ func FireRegisteredHooks(ctx context.Context, entry *Entry) []error

+ func ParseLevel(level string) (string, error)

+ func RegisterGlobalHook(hookFunc LogHookFunc)

+ func RegisterHook(level Level, hookFunc LogHookFunc)

+ func SetOutput(output string) (io.Writer, error)

+ func UnregisterAllHooks()

+ func UnregisterHooks(level Level)

+ type AsyncOverflowStrategy uint8

+ const AsyncOverflowBlock

+ const AsyncOverflowDropNewest

+ const AsyncOverflowDropOldest

+ func (s AsyncOverflowStrategy) IsValid() bool

+ type ColorConfig struct

+ Enable bool

+ ForceTTY bool

+ LevelColors map[Level]string

+ func DefaultColorConfig() ColorConfig

+ type Config struct

+ AdditionalFields []Field

+ AsyncBufferSize int

+ AsyncDropHandler func([]byte)

+ AsyncOverflowStrategy AsyncOverflowStrategy

+ BufferSize int

+ Color ColorConfig

+ ContextExtractors []ContextExtractor

+ DisableTimestamp bool

+ EnableAsync bool

+ EnableCaller bool

+ EnableJSON bool

+ EnableStackTrace bool

+ Encoder Encoder

+ EncoderName string

+ EncoderRegistry *EncoderRegistry

+ File FileConfig

+ Hooks []HookConfig

+ Level Level

+ Output io.Writer

+ Sampling SamplingConfig

+ TimeFormat string

+ func DefaultConfig() Config

+ func DevelopmentConfig() Config

+ func ProductionConfig() Config

+ type ConfigBuilder struct

+ func NewConfigBuilder() *ConfigBuilder

+ func (b *ConfigBuilder) Build() *Config

+ func (b *ConfigBuilder) WithAsyncBufferSize(size int) *ConfigBuilder

+ func (b *ConfigBuilder) WithAsyncDropHandler(handler func([]byte)) *ConfigBuilder

+ func (b *ConfigBuilder) WithAsyncOverflowStrategy(strategy AsyncOverflowStrategy) *ConfigBuilder

+ func (b *ConfigBuilder) WithCaller(enable bool) *ConfigBuilder

+ func (b *ConfigBuilder) WithColors(enable bool) *ConfigBuilder

+ func (b *ConfigBuilder) WithConsoleOutput() *ConfigBuilder

+ func (b *ConfigBuilder) WithContextExtractor(extractor ContextExtractor) *ConfigBuilder

+ func (b *ConfigBuilder) WithContextExtractors(extractors ...ContextExtractor) *ConfigBuilder

+ func (b *ConfigBuilder) WithDebugLevel() *ConfigBuilder

+ func (b *ConfigBuilder) WithDevelopmentDefaults() *ConfigBuilder

+ func (b *ConfigBuilder) WithEnableAsync(enabled bool) *ConfigBuilder

+ func (b *ConfigBuilder) WithEncoder(encoder Encoder) *ConfigBuilder

+ func (b *ConfigBuilder) WithEncoderName(name string) *ConfigBuilder

+ func (b *ConfigBuilder) WithEncoderRegistry(registry *EncoderRegistry) *ConfigBuilder

+ func (b *ConfigBuilder) WithField(key string, value any) *ConfigBuilder

+ func (b *ConfigBuilder) WithFields(fields []Field) *ConfigBuilder

+ func (b *ConfigBuilder) WithFileCompression(level int) *ConfigBuilder

+ func (b *ConfigBuilder) WithFileOutput(path string) *ConfigBuilder

+ func (b *ConfigBuilder) WithFileRetention(maxAgeDays, maxFiles int) *ConfigBuilder

+ func (b *ConfigBuilder) WithFileRotation(maxSizeBytes int64, compress bool) *ConfigBuilder

+ func (b *ConfigBuilder) WithForceColors(force bool) *ConfigBuilder

+ func (b *ConfigBuilder) WithHook(name string, hook Hook) *ConfigBuilder

+ func (b *ConfigBuilder) WithInfoLevel() *ConfigBuilder

+ func (b *ConfigBuilder) WithJSONFormat(enable bool) *ConfigBuilder

+ func (b *ConfigBuilder) WithLevel(level Level) *ConfigBuilder

+ func (b *ConfigBuilder) WithLocalDefaults() *ConfigBuilder

+ func (b *ConfigBuilder) WithNoTimestamp() *ConfigBuilder

+ func (b *ConfigBuilder) WithOutput(output io.Writer) *ConfigBuilder

+ func (b *ConfigBuilder) WithProductionDefaults() *ConfigBuilder

+ func (b *ConfigBuilder) WithSampling(enabled bool, initial, thereafter int, perLevel bool) *ConfigBuilder

+ func (b *ConfigBuilder) WithStackTrace(enable bool) *ConfigBuilder

+ func (b *ConfigBuilder) WithTimeFormat(format string) *ConfigBuilder

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

+ type Encoder interface

+ Encode func(entry *Entry, cfg *Config, buf *bytes.Buffer) ([]byte, error)

+ EstimateSize func(entry *Entry) int

+ type EncoderRegistry struct

+ func NewEncoderRegistry() *EncoderRegistry

+ func (r *EncoderRegistry) Get(name string) (Encoder, bool)

+ func (r *EncoderRegistry) MustRegister(name string, encoder Encoder)

+ func (r *EncoderRegistry) Register(name string, encoder Encoder) error

+ type Entry struct

+ Fields []Field

+ Level Level

+ Message string

+ Raw any

+ type Field struct

+ Key string

+ Value any

+ func Any(key string, value any) Field

+ func Bool(key string, value bool) Field

+ func Duration(key string, value time.Duration) Field

+ func Error(key string, err error) Field

+ func Float64(key string, value float64) Field

+ func Int(key string, value int) Field

+ func Int64(key string, value int64) Field

+ func Str(key string, value string) Field

+ func Time(key string, value time.Time) Field

+ func Uint64(key string, value uint64) Field

+ type FileConfig struct

+ Compress bool

+ CompressionLevel int

+ FileMode os.FileMode

+ LocalTime bool

+ MaxAge int

+ MaxBackups int

+ MaxSizeBytes int64

+ Path string

+ type FormattedLogger interface

+ Debugf func(format string, args ...any)

+ Errorf func(format string, args ...any)

+ Fatalf func(format string, args ...any)

+ Infof func(format string, args ...any)

+ Tracef func(format string, args ...any)

+ Warnf func(format string, args ...any)

+ type Hook interface

+ Levels func() []Level

+ OnLog func(entry *Entry) error

+ type HookConfig struct

+ Hook Hook

+ Levels []Level

+ Name string

+ type HookRegistry struct

+ Hooks map[string]Hook

+ func NewHookRegistry() *HookRegistry

+ func (r *HookRegistry) AddHook(name string, hook Hook) error

+ func (r *HookRegistry) FireHooks(entry *Entry) []error

+ func (r *HookRegistry) GetHook(name string) (Hook, bool)

+ func (r *HookRegistry) GetHooksForLevel(level Level) []Hook

+ func (r *HookRegistry) RemoveHook(name string) bool

+ type Level uint8

+ const DebugLevel

+ const ErrorLevel

+ const FatalLevel

+ const InfoLevel

+ const TraceLevel

+ const WarnLevel

+ func (l Level) IsValid() bool

+ func (l Level) String() string

+ type LogHook struct

+ Func LogHookFunc

+ Level Level

+ Name string

+ type LogHookFunc func(ctx context.Context, entry *Entry) error

+ type Logger interface

+ Debug func(msg string)

+ Error func(msg string)

+ Fatal func(msg string)

+ Info func(msg string)

+ Trace func(msg string)

+ Warn func(msg string)

+ func NewNoop() Logger

+ type Methods interface

+ GetConfig func() *Config

+ GetLevel func() Level

+ SetLevel func(level Level)

+ Sync func() error

+ WithContext func(ctx context.Context) Logger

+ WithError func(err error) Logger

+ WithField func(key string, value any) Logger

+ WithFields func(fields ...Field) Logger

+ type NoopLogger struct

+ func (*NoopLogger) Debug(_ string)

+ func (*NoopLogger) Debugf(_ string, _ ...any)

+ func (*NoopLogger) Error(_ string)

+ func (*NoopLogger) Errorf(_ string, _ ...any)

+ func (*NoopLogger) Fatal(_ string)

+ func (*NoopLogger) Fatalf(_ string, _ ...any)

+ func (*NoopLogger) Info(_ string)

+ func (*NoopLogger) Infof(_ string, _ ...any)

+ func (*NoopLogger) Sync() error

+ func (*NoopLogger) Trace(_ string)

+ func (*NoopLogger) Tracef(_ string, _ ...any)

+ func (*NoopLogger) Warn(_ string)

+ func (*NoopLogger) Warnf(_ string, _ ...any)

+ func (l *NoopLogger) GetConfig() *Config

+ func (l *NoopLogger) GetLevel() Level

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

+ func (l *NoopLogger) WithContext(_ context.Context) Logger

+ func (l *NoopLogger) WithError(_ error) Logger

+ func (l *NoopLogger) WithField(_ string, _ any) Logger

+ func (l *NoopLogger) WithFields(_ ...Field) Logger

+ type SamplingConfig struct

+ Enabled bool

+ Initial int

+ PerLevelThreshold bool

+ Thereafter int

+ type StandardHook struct

+ LevelList []Level

+ LogHandler func(entry *Entry) error

+ func NewStandardHook(levels []Level, handler func(entry *Entry) error) *StandardHook

+ func (h *StandardHook) Levels() []Level

+ func (h *StandardHook) OnLog(entry *Entry) error

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