tracelog

Documentation

Index

• Variables
• func EventAdder(logger *slog.Logger, prefix string, ...) func(Context, *event.Event, error)
• func EventAttrs(ctx Context, ev *event.Event, err error) []slog.Attr
• func EventRecord(ctx Context, level slog.Level, msg string, ev *event.Event, err error) slog.Record
• func HTTPSpanStarter(logger *slog.Logger, prefix string) func(*http.Request, string, ...*trace.Link) (Context, func(Context))
• func Source(s source.Source, logger *slog.Logger) source.Source
• func SpanStarter(logger *slog.Logger, prefix string) func(Context, api.Op, ...*trace.Link) (Context, func(Context))
• type EventLevels
  • func (ls *EventLevels) Level(ev *event.Event, err error) slog.Level

Variables

var DefaultEventLevels = EventLevels{
	FailInternal: slog.LevelError,
	Fail:         slog.LevelInfo,
	Error:        slog.LevelInfo,
	Other:        slog.LevelInfo,
}

Functions

func EventAdder

func EventAdder(logger *slog.Logger, prefix string, levels func(*event.Event, error) slog.Level) func(Context, *event.Event, error)

EventAdder returns a function which can be used as AddEvent callback. Internal errors are logged at error level, and other events at info level. If logger is nil, current default logger is used for each log record. If levels is nil, defaults are used.

func EventAttrs

func EventAttrs(ctx Context, ev *event.Event, err error) []slog.Attr

EventAttrs converts an event into log attributes.

func EventRecord

func EventRecord(ctx Context, level slog.Level, msg string, ev *event.Event, err error) slog.Record

EventRecord creates a loggable representation of a server event.

func HTTPSpanStarter

func HTTPSpanStarter(logger *slog.Logger, prefix string) func(*http.Request, string, ...*trace.Link) (Context, func(Context))

HTTPSpanStarter returns a function which can be used as webserver.Config.StartSpan callback.

func Source

func Source(s source.Source, logger *slog.Logger) source.Source

Source wraps a source with a trace span with logging.

func SpanStarter

func SpanStarter(logger *slog.Logger, prefix string) func(Context, api.Op, ...*trace.Link) (Context, func(Context))

SpanStarter returns a function which can be used as server.Config.StartSpan callback.

Types

type EventLevels

type EventLevels struct {
	FailInternal slog.Level // Internal failure.
	Fail         slog.Level // Other failure.
	Error        slog.Level // Non-failure, but with associated error information.
	Other        slog.Level // No failure or error.
}

EventLevels maps server event categories to log levels.

func (*EventLevels) Level

func (ls *EventLevels) Level(ev *event.Event, err error) slog.Level

Level maps server event type to log level. Presence of error value may affect the level.