2020-07-10 14:17:51 +00:00
|
|
|
package logger
|
|
|
|
|
|
|
|
import (
|
2020-07-24 13:54:03 +00:00
|
|
|
"errors"
|
2020-07-10 14:17:51 +00:00
|
|
|
|
|
|
|
"go.uber.org/zap"
|
|
|
|
"go.uber.org/zap/zapcore"
|
|
|
|
)
|
|
|
|
|
2020-07-24 13:54:03 +00:00
|
|
|
// Logger represents the component
|
|
|
|
// for writing messages to log.
|
|
|
|
//
|
|
|
|
// It is a type alias of
|
|
|
|
// go.uber.org/zap.Logger.
|
|
|
|
type Logger = zap.Logger
|
|
|
|
|
2021-05-11 08:54:59 +00:00
|
|
|
// Prm groups Logger's parameters.
|
|
|
|
type Prm struct {
|
|
|
|
level zapcore.Level
|
|
|
|
}
|
|
|
|
|
2020-07-24 13:54:03 +00:00
|
|
|
// ErrNilLogger is returned by functions that
|
|
|
|
// expect a non-nil Logger, but received nil.
|
|
|
|
var ErrNilLogger = errors.New("logger is nil")
|
2020-07-10 14:17:51 +00:00
|
|
|
|
2021-05-11 08:54:59 +00:00
|
|
|
// SetLevelString sets minimum logging level.
|
|
|
|
//
|
|
|
|
// Returns error of s is not a string representation of zap.Level
|
|
|
|
// value (see zapcore.Level docs).
|
|
|
|
func (p *Prm) SetLevelString(s string) error {
|
|
|
|
return p.level.UnmarshalText([]byte(s))
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewLogger constructs a new zap logger instance.
|
|
|
|
//
|
|
|
|
// Logger is built from production logging configuration with:
|
|
|
|
// * parameterized level;
|
|
|
|
// * console encoding;
|
|
|
|
// * ISO8601 time encoding.
|
|
|
|
//
|
|
|
|
// Logger records a stack trace for all messages at or above fatal level.
|
|
|
|
func NewLogger(prm Prm) (*Logger, error) {
|
2020-07-10 14:17:51 +00:00
|
|
|
c := zap.NewProductionConfig()
|
2021-05-11 08:54:59 +00:00
|
|
|
c.Level = zap.NewAtomicLevelAt(prm.level)
|
2021-05-11 08:17:45 +00:00
|
|
|
c.Encoding = "console"
|
2020-07-10 14:17:51 +00:00
|
|
|
c.EncoderConfig.EncodeTime = zapcore.ISO8601TimeEncoder
|
|
|
|
|
2021-05-11 08:25:54 +00:00
|
|
|
return c.Build(
|
2021-05-11 08:17:45 +00:00
|
|
|
zap.AddStacktrace(zap.NewAtomicLevelAt(zap.FatalLevel)),
|
|
|
|
)
|
2020-07-10 14:17:51 +00:00
|
|
|
}
|