logger

package

v0.0.3 Latest Latest Go to latest Published: May 27, 2026 License: MIT Imports: 7 Imported by: 0

Details

Package logger configures AGH structured logging.

This section is empty.

This section is empty.

func MirrorToStderrEnabled(getenv func(string) string) bool

MirrorToStderrEnabled reports whether process-local logging should still be mirrored to stderr.

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

New constructs a structured logger and returns a close function for any opened file handle.

func ParseLevel(raw string) (slog.Level, error)

ParseLevel converts the configured string level into slog's level type.

func WithMirrorToStderrEnv(sandbox []string, enabled bool) []string

WithMirrorToStderrEnv sets the detached-process env override controlling stderr mirroring.

type FileRotationConfig struct {
	MaxSizeMB       int
	MaxBackups      int
	MaxAgeDays      int
	CompressBackups bool
}

FileRotationConfig configures the daemon log sink's file rotation policy.

type Option func(*options)

Option customizes logger construction.

func WithFile(path string) Option

WithFile enables JSON log output to the supplied file path.

func WithFileRotation(rotation FileRotationConfig) Option

WithFileRotation enables lumberjack-backed rotation for the structured file sink.

func WithLevel(level string) Option

WithLevel sets the slog level using the project config value.

func WithMirrorToStderr(enabled bool) Option

WithMirrorToStderr mirrors logs to stderr in addition to any file target.