logging

type ArgsUpdater ¶ added in v0.5.2

type ArgsUpdater interface {
	UpdateArgs(args ...any) []any
}

ArgsUpdater updates a log message's arguments.

type Attr ¶

type Attr struct {
	ID    resource.MonotonicID
	Key   string
	Value string
}

func (a Attr) GetID() resource.ID

type Getter ¶ added in v0.5.2

type Getter[T any] interface {
	Get(resource.ID) (T, error)
}

type Interface ¶

type Interface interface {
	Debug(msg string, args ...any)
	Info(msg string, args ...any)
	Warn(msg string, args ...any)
	Error(msg string, args ...any)
	AddArgsUpdater(enricher ArgsUpdater)
}

var Discard Interface = &noop{}

type Logger ¶

type Logger struct {
	*pubsub.Broker[Message]
	// contains filtered or unexported fields
}

Logger wraps slog, providing further functionality such as emitting log records as pug events, and enriching records with further attributes.

func NewLogger(opts Options) *Logger

func (e Logger) AddArgsUpdater(updater ArgsUpdater)

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

func (l *Logger) Error(msg string, args ...any)

func (l *Logger) Get(id resource.ID) (Message, error)

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

func (l *Logger) List() []Message

func (l *Logger) Warn(msg string, args ...any)

type Message ¶

type Message struct {
	ID         resource.MonotonicID
	Time       time.Time
	Level      string
	Message    string `json:"msg"`
	Attributes []Attr
}

Message is the event payload for a log message

func (m Message) GetID() resource.ID

type Options ¶

type Options struct {
	// The log level of the logger
	Level string
	// Any additional writers the log handler should write to.
	AdditionalWriters []io.Writer
}

type ReferenceUpdater ¶ added in v0.5.2

type ReferenceUpdater[T any] struct {
	Getter[T]

	Name  string
	Field string
}

ReferenceUpdater checks log arguments for references to T via its ID, either directly or via a struct field, and updates or adds T to the log arguments accordingly.

func (e *ReferenceUpdater[T]) UpdateArgs(args ...any) []any