mrlog

Documentation

Index

• func ParseDateTimeFormat(str string) (string, error)
• func SetDefault(logger Logger) error
• func WithContext(ctx context.Context, logger Logger) context.Context
• type Level
  • func ParseLevel(str string) (Level, error)
  • func (e Level) String() string
• type Logger
  • func Ctx(ctx context.Context) Logger
  • func Default() Logger
• type LoggerContext
• type LoggerEvent

Functions

func ParseDateTimeFormat

func ParseDateTimeFormat(str string) (string, error)

ParseDateTimeFormat - comment func.

func SetDefault

func SetDefault(logger Logger) error

SetDefault - устанавливает логгер по умолчанию, одноразовая операция.

func WithContext

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

WithContext - comment func.

Types

type Level

type Level int8

Level - уровень логирования.

const (
	DebugLevel Level = iota // DebugLevel - FatalLevel + WarnLevel + WarnLevel + InfoLevel + отладочные сообщения
	InfoLevel               // InfoLevel - FatalLevel + WarnLevel + WarnLevel + информационные сообщения
	WarnLevel               // WarnLevel - FatalLevel + WarnLevel + предупреждения
	ErrorLevel              // ErrorLevel - FatalLevel + ошибки
	FatalLevel              // FatalLevel - отображение только критических ошибок
	TraceLevel Level = -1   // TraceLevel - FatalLevel + WarnLevel + WarnLevel + InfoLevel + DebugLevel + трассировочные сообщения
)

func ParseLevel

func ParseLevel(str string) (Level, error)

ParseLevel - comment func.

func (Level) String

func (e Level) String() string

String - comment method.

type Logger

type Logger interface {
	Level() Level
	WithContext(ctx context.Context) context.Context

	With() LoggerContext

	Debug() LoggerEvent
	Info() LoggerEvent
	Warn() LoggerEvent
	Error() LoggerEvent
	Fatal() LoggerEvent
	Panic() LoggerEvent
	Trace() LoggerEvent

	Printf(format string, args ...any) // поддержка стандартного интерфейса логгирования сообщений
}

Logger - интерфейс логирования ошибок и сообщений через формирования события.

func Ctx

func Ctx(ctx context.Context) Logger

Ctx - comment func.

func Default

func Default() Logger

Default - возвращает ранее установленный логгер по умолчанию. Если ранее не был вызван метод mrlog.SetDefault(), то будет panic.

type LoggerContext

type LoggerContext interface {
	Logger() Logger

	Str(key, value string) LoggerContext
	Bytes(key string, value []byte) LoggerContext
	Int(key string, value int) LoggerContext
	Any(key string, value any) LoggerContext
}

LoggerContext - контекст логгера для обогащения его дополнительными атрибутами.

type LoggerEvent

type LoggerEvent interface {
	Err(err error) LoggerEvent
	Str(key, value string) LoggerEvent
	Bytes(key string, value []byte) LoggerEvent
	Int(key string, value int) LoggerEvent
	Any(key string, value any) LoggerEvent

	Msg(message string)
	Msgf(format string, args ...any)
	MsgFunc(createMsg func() string)
	Send()
}

LoggerEvent - инерфейс события, с возможностью его обогащения и отправки.