logutil

Documentation

Index

• func AbbreviatedArray(key string, elements interface{}, marshalFunc func(interface{}) []string) zap.Field
• func CL(c context.Context) *zap.Logger
• func ContextWithField(c context.Context, fields ...zap.Field) context.Context
• func File(file *backuppb.File) zap.Field
• func Files(fs []*backuppb.File) zap.Field
• func Key(fieldKey string, key []byte) zap.Field
• func Keys(keys [][]byte) zap.Field
• func Leader(peer *metapb.Peer) zap.Field
• func LoggerFromContext(c context.Context) *zap.Logger
• func Peer(peer *metapb.Peer) zap.Field
• func Redact(field zap.Field) zap.Field
• func RedactAny(fieldKey string, key interface{}) zap.Field
• func Region(region *metapb.Region) zap.Field
• func RegionBy(key string, region *metapb.Region) zap.Field
• func ResetGlobalLogger(l *zap.Logger)
• func RewriteRule(rewriteRule *import_sstpb.RewriteRule) zap.Field
• func SSTMeta(sstMeta *import_sstpb.SSTMeta) zap.Field
• func SSTMetas(sstMetas []*import_sstpb.SSTMeta) zap.Field
• func ShortError(err error) zap.Field
• func WarnTerm(message string, fields ...zap.Field)
• type AbbreviatedArrayMarshaler
  • func (abb AbbreviatedArrayMarshaler) MarshalLogArray(encoder zapcore.ArrayEncoder) error

Functions

func AbbreviatedArray

func AbbreviatedArray(
	key string, elements interface{}, marshalFunc func(interface{}) []string,
) zap.Field

AbbreviatedArray constructs a field that abbreviates an array of elements.

func CL

func CL(c context.Context) *zap.Logger

CL is the shorthand for LoggerFromContext.

func ContextWithField

func ContextWithField(c context.Context, fields ...zap.Field) context.Context

ContextWithField wrap a context with a logger with some fields.

func File

func File(file *backuppb.File) zap.Field

File make the zap fields for a file.

func Files

func Files(fs []*backuppb.File) zap.Field

Files make the zap field for a set of file.

func Key

func Key(fieldKey string, key []byte) zap.Field

Key constructs a field that carries upper hex format key.

func Keys

func Keys(keys [][]byte) zap.Field

Keys constructs a field that carries upper hex format keys.

func Leader

func Leader(peer *metapb.Peer) zap.Field

Leader make the zap fields for a peer as leader. nolint:interfacer

func LoggerFromContext

func LoggerFromContext(c context.Context) *zap.Logger

LoggerFromContext returns the contextual logger via the context. If there isn't a logger in the context, returns the global logger.

func Peer

func Peer(peer *metapb.Peer) zap.Field

Peer make the zap fields for a peer.

func Redact

func Redact(field zap.Field) zap.Field

Redact replaces the zap field by a '?' if redaction is turned on.

func RedactAny

func RedactAny(fieldKey string, key interface{}) zap.Field

RedactAny constructs a redacted field that carries an interface{}.

func Region

func Region(region *metapb.Region) zap.Field

Region make the zap fields for a region.

func RegionBy

func RegionBy(key string, region *metapb.Region) zap.Field

RegionBy make the zap fields for a region with name.

func ResetGlobalLogger

func ResetGlobalLogger(l *zap.Logger)

ResetGlobalLogger resets the global logger. Contexts have already made by `ContextWithField` would keep untouched, subsequent wrapping over those contexts would keep using the old global logger, only brand new contexts (i.e. context without logger) would be wrapped with the new global logger. This method is mainly for testing.

func RewriteRule

func RewriteRule(rewriteRule *import_sstpb.RewriteRule) zap.Field

RewriteRule make the zap fields for a rewrite rule.

func SSTMeta

func SSTMeta(sstMeta *import_sstpb.SSTMeta) zap.Field

SSTMeta make the zap fields for a SST meta.

func SSTMetas

func SSTMetas(sstMetas []*import_sstpb.SSTMeta) zap.Field

SSTMetas make the zap fields for SST metas.

func ShortError

func ShortError(err error) zap.Field

ShortError make the zap field to display error without verbose representation (e.g. the stack trace).

func WarnTerm

func WarnTerm(message string, fields ...zap.Field)

WarnTerm put a log both to terminal and to the log file.

Types

type AbbreviatedArrayMarshaler

type AbbreviatedArrayMarshaler []string

AbbreviatedArrayMarshaler abbreviates an array of elements.

func (AbbreviatedArrayMarshaler) MarshalLogArray

func (abb AbbreviatedArrayMarshaler) MarshalLogArray(encoder zapcore.ArrayEncoder) error

MarshalLogArray implements zapcore.ArrayMarshaler.