logger

README

logger

Configurable structure levelled logger that is stored in context.

Documentation

Index

• func ContextWithLogger(ctx context.Context, l Logger) context.Context
• func Debug(ctx context.Context, msg string)
• func Error(ctx context.Context, msg string)
• func Fatal(ctx context.Context, msg string)
• func Info(ctx context.Context, msg string)
• func Init(ctx context.Context, p Params)
• func Warn(ctx context.Context, msg string)
• type Fields
• type Logger
  • func FromContext(ctx context.Context) Logger
  • func WithError(ctx context.Context, err error) Logger
  • func WithField(ctx context.Context, key string, value interface{}) Logger
  • func WithFields(ctx context.Context, fields map[string]interface{}) Logger
• type Params
• type SentryParams

Functions

func ContextWithLogger

func ContextWithLogger(ctx context.Context, l Logger) context.Context

ContextWithLogger adds Logger to context and returns new context.

func Debug

func Debug(ctx context.Context, msg string)

Debug prints debug-level log message. Usually very verbose and shown only when debug level is enabled.

func Error

func Error(ctx context.Context, msg string)

Error prints error-level log message.

func Fatal

func Fatal(ctx context.Context, msg string)

Fatal prints fatal-level log message and exit the program with code 1.

func Info

func Info(ctx context.Context, msg string)

Info prints info-level log message.

func Init

func Init(ctx context.Context, p Params)

Init initiates logger and add format options. Should be called only once, on start of app.

func Warn

func Warn(ctx context.Context, msg string)

Warn prints warn-level log message.

Types

type Fields

type Fields map[string]interface{}

Fields type, used to pass to `WithFields`.

type Logger

type Logger interface {
	Debug(msg string)
	Info(msg string)
	Warn(msg string)
	Error(msg string)
	Fatal(msg string)

	WithError(err error) Logger
	WithField(key string, value interface{}) Logger
	WithFields(fields Fields) Logger

	Writer() io.WriteCloser
}

Logger serves as an adapter interface for logger libraries so that we not depend on any of them directly.

func FromContext

func FromContext(ctx context.Context) Logger

FromContext extracts Logger from context. If no instance found - returns Logger from default logInstance.

func WithError

func WithError(ctx context.Context, err error) Logger

WithError adds an error as single field to the Logger Entry.

func WithField

func WithField(ctx context.Context, key string, value interface{}) Logger

WithField adds s single field to the Logger Entry.

func WithFields

func WithFields(ctx context.Context, fields map[string]interface{}) Logger

WithFields adds fields key-value to the Logger Entry.

type Params

type Params struct {
	Level        string
	Format       string
	SentryParams SentryParams
}

Params holds logger specific params.

type SentryParams

type SentryParams struct {
	Enabled      bool
	DSN          string
	TraceEnabled bool
	TraceLevel   string
	Tags         map[string]string
}

SentryParams holds sentry specific params.