lager

README

lager

An opinionated logger for Go.

Documentation

Index

• Constants
• type Data
• type LogFormat
  • func (log LogFormat) ToJSON() []byte
• type LogLevel
• type Logger
  • func NewLogger(component string) Logger
• type Sink
  • func NewWriterSink(writer io.Writer, minLogLevel LogLevel) Sink

Constants

const STACK_TRACE_BUFFER_SIZE = 1024 * 100

Types

type Data

type Data map[string]interface{}

type LogFormat

type LogFormat struct {
	Timestamp string   `json:"timestamp"`
	Source    string   `json:"source"`
	Message   string   `json:"message"`
	LogLevel  LogLevel `json:"log_level"`
	Data      Data     `json:"data"`
}

func (LogFormat) ToJSON

func (log LogFormat) ToJSON() []byte

type LogLevel

type LogLevel int

const (
	DEBUG LogLevel = iota
	INFO
	ERROR
	FATAL
)

type Logger

type Logger interface {
	RegisterSink(Sink)
	Session(task string, data ...Data) Logger
	Debug(action string, data ...Data)
	Info(action string, data ...Data)
	Error(action string, err error, data ...Data)
	Fatal(action string, err error, data ...Data)
}

func NewLogger

func NewLogger(component string) Logger

type Sink

type Sink interface {
	//Log to the sink.  Best effort -- no need to worry about errors.
	Log(level LogLevel, payload []byte)
}

A Sink represents a write destination for a Logger. It provides a thread-safe interface for writing logs

func NewWriterSink

func NewWriterSink(writer io.Writer, minLogLevel LogLevel) Sink