log

Documentation

Overview

Package log defines standardized ways to initialize Go kit loggers. It should typically only ever be imported by main packages.

Index

• func Debug(logger log.Logger) log.Logger
• func Error(logger log.Logger) log.Logger
• func Info(logger log.Logger) log.Logger
• func New(config *Config) log.Logger
• func Warn(logger log.Logger) log.Logger
• type AllowedFormat
  • func (f *AllowedFormat) Set(s string) error
  • func (f *AllowedFormat) String() string
• type AllowedLevel
  • func (l *AllowedLevel) Set(s string) error
  • func (l *AllowedLevel) String() string
  • func (l *AllowedLevel) UnmarshalYAML(unmarshal func(interface{}) error) error
• type Config
• type Logger
  • func NewDynamic(config *Config) *Logger
  • func (l *Logger) Log(keyvals ...interface{}) error
  • func (l *Logger) SetLevel(lvl *AllowedLevel)

Functions

func Debug

func Debug(logger log.Logger) log.Logger

Debug returns a logger that includes a Key/DebugValue pair.

func Error

func Error(logger log.Logger) log.Logger

Error returns a logger that includes a Key/ErrorValue pair.

func Info

func Info(logger log.Logger) log.Logger

Info returns a logger that includes a Key/InfoValue pair.

func New

func New(config *Config) log.Logger

New returns a new leveled logger. Each logged line will be annotated with a timestamp. The output always goes to stderr.

func Warn

func Warn(logger log.Logger) log.Logger

Warn returns a logger that includes a Key/WarnValue pair.

Types

type AllowedFormat

type AllowedFormat struct {
	// contains filtered or unexported fields
}

AllowedFormat is a settable identifier for the output format that the logger can have.

func (*AllowedFormat) Set

func (f *AllowedFormat) Set(s string) error

Set updates the value of the allowed format.

func (*AllowedFormat) String

func (f *AllowedFormat) String() string

type AllowedLevel

type AllowedLevel struct {
	// contains filtered or unexported fields
}

AllowedLevel is a settable identifier for the minimum level a log entry must be have.

func (*AllowedLevel) Set

func (l *AllowedLevel) Set(s string) error

Set updates the value of the allowed level.

func (*AllowedLevel) String

func (l *AllowedLevel) String() string

func (*AllowedLevel) UnmarshalYAML

func (l *AllowedLevel) UnmarshalYAML(unmarshal func(interface{}) error) error

type Config

type Config struct {
	Level  *AllowedLevel
	Format *AllowedFormat
}

Config is a struct containing configurable settings for the logger.

type Logger

type Logger struct {
	Base         log.Logger
	Leveled      log.Logger
	CurrentLevel *AllowedLevel
	// contains filtered or unexported fields
}

func NewDynamic

func NewDynamic(config *Config) *Logger

NewDynamic returns a new leveled logger. Each logged line will be annotated with a timestamp. The output always goes to stderr. Some properties can be changed, like the level.

func (*Logger) Log

func (l *Logger) Log(keyvals ...interface{}) error

Log implements logger.Log.

func (*Logger) SetLevel

func (l *Logger) SetLevel(lvl *AllowedLevel)

SetLevel changes the log level.