Documentation
¶
Index ¶
- func Any(key string, value interface{}) zap.Field
- func Binary(key string, val []byte) zap.Field
- func Bool(key string, val bool) zap.Field
- func Boolp(key string, val *bool) zap.Field
- func ByteString(key string, val []byte) zap.Field
- func Clear()
- func Complex128(key string, val complex128) zap.Field
- func Complex128p(key string, val *complex128) zap.Field
- func Complex64(key string, val complex64) zap.Field
- func Complex64p(key string, val *complex64) zap.Field
- func DPanic(msg string, fields ...zap.Field)
- func Debug(msg string, fields ...zap.Field)
- func Duration(key string, val time.Duration) zap.Field
- func Durationp(key string, val *time.Duration) zap.Field
- func Err(err error) zap.Field
- func Error(msg string, fields ...zap.Field)
- func ErrorWithCaller(msg string, caller zap.Field, fields ...zap.Field)
- func Errors(msg string, err error)
- func Float32(key string, val float32) zap.Field
- func Float32p(key string, val *float32) zap.Field
- func Float64(key string, val float64) zap.Field
- func Float64p(key string, val *float64) zap.Field
- func Info(msg string, fields ...zap.Field)
- func Int(key string, val int) zap.Field
- func Int16(key string, val int16) zap.Field
- func Int16p(key string, val *int16) zap.Field
- func Int32(key string, val int32) zap.Field
- func Int32p(key string, val *int32) zap.Field
- func Int64(key string, val int64) zap.Field
- func Int64p(key string, val *int64) zap.Field
- func Int8(key string, val int8) zap.Field
- func Int8p(key string, val *int8) zap.Field
- func Intp(key string, val *int) zap.Field
- func NamedError(key string, err error) zap.Field
- func Namespace(key string) zap.Field
- func NewEntryCaller(pc uintptr, file string, line int, ok bool) zapcore.EntryCaller
- func Object(key string, val zapcore.ObjectMarshaler) zap.Field
- func Panic(msg string, fields ...zap.Field)
- func Reflect(key string, val interface{}) zap.Field
- func Skip() zap.Field
- func Stack(key string) zap.Field
- func String(key string, val string) zap.Field
- func Stringer(key string, val fmt.Stringer) zap.Field
- func Stringp(key string, val *string) zap.Field
- func Sync()
- func Time(key string, val time.Time) zap.Field
- func Timep(key string, val *time.Time) zap.Field
- func Uint(key string, val uint) zap.Field
- func Uint16(key string, val uint16) zap.Field
- func Uint16p(key string, val *uint16) zap.Field
- func Uint32(key string, val uint32) zap.Field
- func Uint32p(key string, val *uint32) zap.Field
- func Uint64(key string, val uint64) zap.Field
- func Uint64p(key string, val *uint64) zap.Field
- func Uint8(key string, val uint8) zap.Field
- func Uint8p(key string, val *uint8) zap.Field
- func Uintp(key string, val *uint) zap.Field
- func Uintptr(key string, val uintptr) zap.Field
- func Uintptrp(key string, val *uintptr) zap.Field
- func Warn(msg string, fields ...zap.Field)
- type Conf
- type GormLog
- type Log
- func (l *Log) DPanic(msg string, fields ...zap.Field)
- func (l *Log) Debug(msg string, fields ...zap.Field)
- func (l *Log) Error(msg string, fields ...zap.Field)
- func (l *Log) ErrorWithCaller(msg string, caller zap.Field, fields ...zap.Field)
- func (l *Log) Errors(msg string, err error)
- func (l *Log) Info(msg string, fields ...zap.Field)
- func (l *Log) Panic(msg string, fields ...zap.Field)
- func (l *Log) Sync()
- func (l *Log) Warn(msg string, fields ...zap.Field)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Any ¶
Any takes a key and an arbitrary value and chooses the best way to represent them as a field, falling back to a reflection-based approach only if necessary.
Since byte/uint8 and rune/int32 are aliases, Any can't differentiate between them. To minimize surprises, []byte values are treated as binary blobs, byte values are treated as uint8, and runes are always treated as integers.
func Binary ¶
Binary constructs a field that carries an opaque binary blob.
Binary data is serialized in an encoding-appropriate format. For example, zap's JSON encoder base64-encodes binary blobs. To log UTF-8 encoded text, use ByteString.
func Boolp ¶
Boolp constructs a field that carries a *bool. The returned Field will safely and explicitly represent `nil` when appropriate.
func ByteString ¶
ByteString constructs a field that carries UTF-8 encoded text as a []byte. To log opaque binary blobs (which aren't necessarily valid UTF-8), use Binary.
func Complex128 ¶
func Complex128(key string, val complex128) zap.Field
Complex128 constructs a field that carries a complex number. Unlike most numeric fields, this costs an allocation (to convert the complex128 to interface{}).
func Complex128p ¶
func Complex128p(key string, val *complex128) zap.Field
Complex128p constructs a field that carries a *complex128. The returned Field will safely and explicitly represent `nil` when appropriate.
func Complex64 ¶
Complex64 constructs a field that carries a complex number. Unlike most numeric fields, this costs an allocation (to convert the complex64 to interface{}).
func Complex64p ¶
Complex64p constructs a field that carries a *complex64. The returned Field will safely and explicitly represent `nil` when appropriate.
func DPanic ¶
DPanic logs a message at DPanicLevel. The message includes any fields passed at the log site, as well as any fields accumulated on the logger.
If the logger is in development mode, it then panics (DPanic means "development panic"). This is useful for catching errors that are recoverable, but shouldn't ever happen.
func Debug ¶
Debug logs a message at DebugLevel. The message includes any fields passed at the log site, as well as any fields accumulated on the logger.
func Duration ¶
Duration constructs a field with the given key and value. The encoder controls how the duration is serialized.
func Durationp ¶
Durationp constructs a field that carries a *time.Duration. The returned Field will safely and explicitly represent `nil` when appropriate.
func Error ¶
Error logs a message at ErrorLevel. The message includes any fields passed at the log site, as well as any fields accumulated on the logger.
func ErrorWithCaller ¶
ErrorWithCaller logs a message at ErrorLevel. The message includes any fields passed at the log site, as well as any fields accumulated on the logger.
func Errors ¶
Errors logs a message at ErrorLevel. The message includes any fields passed at the log site, as well as any fields accumulated on the logger.
func Float32 ¶
Float32 constructs a field that carries a float32. The way the floating-point value is represented is encoder-dependent, so marshaling is necessarily lazy.
func Float32p ¶
Float32p constructs a field that carries a *float32. The returned Field will safely and explicitly represent `nil` when appropriate.
func Float64 ¶
Float64 constructs a field that carries a float64. The way the floating-point value is represented is encoder-dependent, so marshaling is necessarily lazy.
func Float64p ¶
Float64p constructs a field that carries a *float64. The returned Field will safely and explicitly represent `nil` when appropriate.
func Info ¶
Info logs a message at InfoLevel. The message includes any fields passed at the log site, as well as any fields accumulated on the logger.
func Int16p ¶
Int16p constructs a field that carries a *int16. The returned Field will safely and explicitly represent `nil` when appropriate.
func Int32p ¶
Int32p constructs a field that carries a *int32. The returned Field will safely and explicitly represent `nil` when appropriate.
func Int64p ¶
Int64p constructs a field that carries a *int64. The returned Field will safely and explicitly represent `nil` when appropriate.
func Int8p ¶
Int8p constructs a field that carries a *int8. The returned Field will safely and explicitly represent `nil` when appropriate.
func Intp ¶
Intp constructs a field that carries a *int. The returned Field will safely and explicitly represent `nil` when appropriate.
func NamedError ¶
NamedError constructs a field that lazily stores err.Error() under the provided key. Errors which also implement fmt.Formatter (like those produced by github.com/pkg/errors) will also have their verbose representation stored under key+"Verbose". If passed a nil error, the field is a no-op.
For the common case in which the key is simply "error", the Error function is shorter and less repetitive.
func Namespace ¶
Namespace creates a named, isolated scope within the logger's context. All subsequent fields will be added to the new namespace.
This helps prevent key collisions when injecting loggers into sub-components or third-party libraries.
func NewEntryCaller ¶
NewEntryCaller makes an EntryCaller from the return signature of runtime.Caller.
func Object ¶
func Object(key string, val zapcore.ObjectMarshaler) zap.Field
Object constructs a field with the given key and ObjectMarshaler. It provides a flexible, but still type-safe and efficient, way to add map- or struct-like user-defined types to the logging context. The struct's MarshalLogObject method is called lazily.
func Panic ¶
Panic logs a message at PanicLevel. The message includes any fields passed at the log site, as well as any fields accumulated on the logger.
The logger then panics, even if logging at PanicLevel is disabled.
func Reflect ¶
Reflect constructs a field with the given key and an arbitrary object. It uses an encoding-appropriate, reflection-based function to lazily serialize nearly any object into the logging context, but it's relatively slow and allocation-heavy. Outside tests, Any is always a better choice.
If encoding fails (e.g., trying to serialize a map[int]string to JSON), Reflect includes the error message in the final log output.
func Skip ¶
Skip constructs a no-op field, which is often useful when handling invalid inputs in other Field constructors.
func Stack ¶
Stack constructs a field that stores a stacktrace of the current goroutine under provided key. Keep in mind that taking a stacktrace is eager and expensive (relatively speaking); this function both makes an allocation and takes about two microseconds.
func Stringer ¶
Stringer constructs a field with the given key and the output of the value's String method. The Stringer's String method is called lazily.
func Stringp ¶
Stringp constructs a field that carries a *string. The returned Field will safely and explicitly represent `nil` when appropriate.
func Sync ¶
func Sync()
Sync calls the underlying Core's Sync method, flushing any buffered log entries. Applications should take care to call Sync before exiting.
func Time ¶
Time constructs a Field with the given key and value. The encoder controls how the time is serialized.
func Timep ¶
Timep constructs a field that carries a *time.Time. The returned Field will safely and explicitly represent `nil` when appropriate.
func Uint16p ¶
Uint16p constructs a field that carries a *uint16. The returned Field will safely and explicitly represent `nil` when appropriate.
func Uint32p ¶
Uint32p constructs a field that carries a *uint32. The returned Field will safely and explicitly represent `nil` when appropriate.
func Uint64p ¶
Uint64p constructs a field that carries a *uint64. The returned Field will safely and explicitly represent `nil` when appropriate.
func Uint8p ¶
Uint8p constructs a field that carries a *uint8. The returned Field will safely and explicitly represent `nil` when appropriate.
func Uintp ¶
Uintp constructs a field that carries a *uint. The returned Field will safely and explicitly represent `nil` when appropriate.
Types ¶
type Conf ¶
type Conf struct {
OutPath string `json:"outPath"`
Level string `json:"level"`
MaxSize int `json:"maxSize"`
MaxBackups int `json:"maxBackups"`
MaxAge int `json:"maxAge"`
Debug bool `json:"debug"`
LogSelect bool `json:"logSelect"`
Stdout bool `json:"-"`
}
Conf log config
type Log ¶
Log log
func (*Log) DPanic ¶
DPanic logs a message at DPanicLevel. The message includes any fields passed at the log site, as well as any fields accumulated on the logger.
If the logger is in development mode, it then panics (DPanic means "development panic"). This is useful for catching errors that are recoverable, but shouldn't ever happen.
func (*Log) Debug ¶
Debug logs a message at DebugLevel. The message includes any fields passed at the log site, as well as any fields accumulated on the logger.
func (*Log) Error ¶
Error logs a message at ErrorLevel. The message includes any fields passed at the log site, as well as any fields accumulated on the logger.
func (*Log) ErrorWithCaller ¶
ErrorWithCaller logs a message at ErrorLevel. The message includes any fields passed at the log site, as well as any fields accumulated on the logger.
func (*Log) Errors ¶
Errors logs a message at ErrorLevel. The message includes any fields passed at the log site, as well as any fields accumulated on the logger.
func (*Log) Info ¶
Info logs a message at InfoLevel. The message includes any fields passed at the log site, as well as any fields accumulated on the logger.
func (*Log) Panic ¶
Panic logs a message at PanicLevel. The message includes any fields passed at the log site, as well as any fields accumulated on the logger.
The logger then panics, even if logging at PanicLevel is disabled.
Source Files