README
¶
slog
Structured logging.
slog is a library for capturing structured log information. In contrast to "traditional" logging libraries, slog:
- captures a Context for each logging event
- captures arbitrary key-value metadata on each log event
Currently, slog forwards messages to seelog by default. However, it is easy to write customised outputs which make use of the context and metadata.
At Mondo, slog captures events both on a per-service and a per-request basis (using the context information). This lets us view all the logs for a given request across all the micro-services it touches.
Documentation
¶
Index ¶
- func Critical(ctx context.Context, msg string, params ...interface{})
- func Debug(ctx context.Context, msg string, params ...interface{})
- func Error(ctx context.Context, msg string, params ...interface{})
- func Info(ctx context.Context, msg string, params ...interface{})
- func Log(evs ...Event)
- func SetDefaultLogger(l Logger)
- func Trace(ctx context.Context, msg string, params ...interface{})
- func Warn(ctx context.Context, msg string, params ...interface{})
- type Event
- type EventSet
- type Logger
- type MultiLogger
- type Severity
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Critical ¶
Critical constructs a logging event with critical severity, and sends it via the default Logger
func Debug ¶
Debug constructs a logging event with debug severity, and sends it via the default Logger
func Error ¶
Critical constructs a logging event with error severity, and sends it via the default Logger
func SetDefaultLogger ¶
func SetDefaultLogger(l Logger)
Types ¶
type Event ¶
type Event struct {
Context context.Context `json:"-"`
Id string `json:"id"`
Timestamp time.Time `json:"timestamp"`
Severity Severity `json:"severity"`
Message string `json:"message"`
// Metadata are structured key-value pairs which describe the event.
Metadata map[string]string `json:"meta,omitempty"`
// Labels, like Metadata, are key-value pairs which describe the event. Unlike Metadata, these are intended to be
// indexed.
Labels map[string]string `json:"labels,omitempty"`
}
An Event is a discrete logging event
type Logger ¶
A Logger is a way of outputting events.
func DefaultLogger ¶
func DefaultLogger() Logger
func SeelogLogger ¶
func SeelogLogger() Logger
type MultiLogger ¶
type MultiLogger []Logger
A MultiLogger sends invocations to multiple Loggers.
func (MultiLogger) Flush ¶
func (ls MultiLogger) Flush() error
func (MultiLogger) Log ¶
func (ls MultiLogger) Log(evs ...Event)
Source Files