logger

Documentation

Index

• Constants
• Variables
• func InContext(ctx context.Context, log Logger) context.Context
• func SetDefault(fn func() Logger)
• type Helper
  • func FromContextAsHelper(ctx context.Context) *Helper
  • func NewHelper(logger Logger, opts ...Option) *Helper
  • func (h *Helper) Debug(msg string, keyvals ...interface{})
  • func (h *Helper) Debugf(format string, a ...interface{})
  • func (h *Helper) Error(msg string, keyvals ...interface{})
  • func (h *Helper) Errorf(format string, a ...interface{})
  • func (h *Helper) Fatal(msg string, keyvals ...interface{})
  • func (h *Helper) Fatalf(format string, a ...interface{})
  • func (h *Helper) Info(msg string, keyvals ...interface{})
  • func (h *Helper) Infof(format string, a ...interface{})
  • func (h *Helper) Log(level Level, keyvals ...interface{})
  • func (h *Helper) Panic(msg string, keyvals ...interface{})
  • func (h *Helper) Panicf(format string, a ...interface{})
  • func (h *Helper) Warn(msg string, keyvals ...interface{})
  • func (h *Helper) Warnf(format string, a ...interface{})
  • func (h *Helper) WithContext(ctx context.Context) *Helper
• type Level
• type Logger
  • func Default() Logger
  • func FromContext(ctx context.Context) Logger
  • func NewStdLogger(output io.Writer) Logger
  • func With(l Logger, keyvals ...interface{}) Logger
  • func WithContext(ctx context.Context, l Logger) Logger
• type Option
  • func WithLevel(level Level) Option
  • func WithMessageKey(key string) Option
• type Valuer
  • func Caller(depth int) Valuer

Constants

const (
	DefaultMessageKey = "msg"
	DefaultLevel      = Info
)

Variables

var (
	// DefaultCaller is a Valuer that returns the file and line where the Log method was invoked.
	// It can only be used with log.With.
	DefaultCaller = Caller(3)
)

var (
	// ErrMissingValue is appended to key-values slices with odd length to substitute the missing value.
	ErrMissingValue = errors.New("(missing value)")
)

Functions

func InContext

func InContext(ctx context.Context, log Logger) context.Context

InContext 将Logger存入Context。

func SetDefault

func SetDefault(fn func() Logger)

Types

type Helper

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

func FromContextAsHelper

func FromContextAsHelper(ctx context.Context) *Helper

FromContextAsHelper 从Context中提取Logger，返回Helper对象。

func NewHelper

func NewHelper(logger Logger, opts ...Option) *Helper

func (*Helper) Debug

func (h *Helper) Debug(msg string, keyvals ...interface{})

func (*Helper) Debugf

func (h *Helper) Debugf(format string, a ...interface{})

func (*Helper) Error

func (h *Helper) Error(msg string, keyvals ...interface{})

func (*Helper) Errorf

func (h *Helper) Errorf(format string, a ...interface{})

func (*Helper) Fatal

func (h *Helper) Fatal(msg string, keyvals ...interface{})

func (*Helper) Fatalf

func (h *Helper) Fatalf(format string, a ...interface{})

func (*Helper) Info

func (h *Helper) Info(msg string, keyvals ...interface{})

func (*Helper) Infof

func (h *Helper) Infof(format string, a ...interface{})

func (*Helper) Log

func (h *Helper) Log(level Level, keyvals ...interface{})

func (*Helper) Panic

func (h *Helper) Panic(msg string, keyvals ...interface{})

func (*Helper) Panicf

func (h *Helper) Panicf(format string, a ...interface{})

func (*Helper) Warn

func (h *Helper) Warn(msg string, keyvals ...interface{})

func (*Helper) Warnf

func (h *Helper) Warnf(format string, a ...interface{})

func (*Helper) WithContext

func (h *Helper) WithContext(ctx context.Context) *Helper

type Level

type Level int

Level .

const (
	Debug Level = iota
	Info
	Warn
	Error
	Panic
	Fatal
)

type Logger

type Logger interface {
	Log(level Level, keyvals ...interface{})
}

Logger is the fundamental interface for all log operations. Log creates a log event from keyvals, a variadic sequence of alternating keys and values. Implementations must be safe for concurrent use by multiple goroutines. In particular, any implementation of Logger that appends to keyvals or modifies or retains any of its elements must make a copy first.

func Default

func Default() Logger

func FromContext

func FromContext(ctx context.Context) Logger

FromContext 从Context中提取Logger，如果不存在则返回默认的Logger。

func NewStdLogger

func NewStdLogger(output io.Writer) Logger

NewStdLogger new a logger implements Logger interface.

func With

func With(l Logger, keyvals ...interface{}) Logger

func WithContext

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

type Option

type Option func(*Helper)

func WithLevel

func WithLevel(level Level) Option

func WithMessageKey

func WithMessageKey(key string) Option

type Valuer

type Valuer func(context.Context) interface{}

A Valuer generates a log value. When passed to With, WithPrefix in a value element (odd indexes), it represents a dynamic value which is re-evaluated with each log event.

func Caller

func Caller(depth int) Valuer