elog

package
v0.4.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 18, 2021 License: MIT Imports: 17 Imported by: 169

Documentation

Index

Constants

View Source
const (
	// DefaultLoggerName 业务日志名
	DefaultLoggerName = "default.log"
	// EgoLoggerName 系统文件名
	EgoLoggerName = "ego.sys"
)
View Source
const (
	// DebugLevel logs are typically voluminous, and are usually disabled in
	// production.
	DebugLevel = zap.DebugLevel
	// InfoLevel is the default logging priority.
	InfoLevel = zap.InfoLevel
	// WarnLevel logs are more important than Info, but don't need individual
	// human review.
	WarnLevel = zap.WarnLevel
	// ErrorLevel logs are high-priority. If an application is running smoothly,
	// it shouldn't generate any error-Level logs.
	ErrorLevel = zap.ErrorLevel
	// PanicLevel logs a message, then panics.
	PanicLevel = zap.PanicLevel
	// FatalLevel logs a message, then calls os.Exit(1).
	FatalLevel = zap.FatalLevel
)
View Source
const PackageName = "core.elog"

PackageName 包名

Variables

View Source
var (
	// String alias for zap.String
	String = zap.String
	// Any alias for zap.Any
	Any = zap.Any
	// Int64 alias for zap.Int64
	Int64 = zap.Int64
	// Int alias for zap.Int
	Int = zap.Int
	// Int32 alias for zap.Int32
	Int32 = zap.Int32
	// Uint alias for zap.Uint
	Uint = zap.Uint
	// Duration alias for zap.Duration
	Duration = zap.Duration
	// Durationp alias for zap.Duration
	Durationp = zap.Durationp
	// Object alias for zap.Object
	Object = zap.Object
	// Namespace alias for zap.Namespace
	Namespace = zap.Namespace
	// Reflect alias for zap.Reflect
	Reflect = zap.Reflect
	// Skip alias for zap.Skip()
	Skip = zap.Skip()
	// ByteString alias for zap.ByteString
	ByteString = zap.ByteString
)

Functions

func DPanic

func DPanic(msg string, fields ...Field)

DPanic ...

func DPanicf

func DPanicf(msg string, args ...interface{})

DPanicf ...

func DPanicw

func DPanicw(msg string, keysAndValues ...interface{})

DPanicw ...

func Debug

func Debug(msg string, fields ...Field)

Debug ...

func DebugEncodeLevel

func DebugEncodeLevel(lv zapcore.Level, enc zapcore.PrimitiveArrayEncoder)

DebugEncodeLevel ...

func Debugf

func Debugf(msg string, args ...interface{})

Debugf ...

func Debugw

func Debugw(msg string, keysAndValues ...interface{})

Debugw ...

func Error

func Error(msg string, fields ...Field)

Error ...

func Errorf

func Errorf(msg string, args ...interface{})

Errorf ...

func Errorw

func Errorw(msg string, keysAndValues ...interface{})

Errorw ...

func Fatal

func Fatal(msg string, fields ...Field)

Fatal ...

func Fatalf

func Fatalf(msg string, args ...interface{})

Fatalf ...

func Fatalw

func Fatalw(msg string, keysAndValues ...interface{})

Fatalw ...

func Info

func Info(msg string, fields ...Field)

Info ...

func Infof

func Infof(msg string, args ...interface{})

Infof ...

func Infow

func Infow(msg string, keysAndValues ...interface{})

Infow ...

func InjectTraceMD

func InjectTraceMD(ctx interface{ Set(string, interface{}) }, md *Tracer)

InjectTraceMD ...

func NewContext

func NewContext(ctx context.Context, tracer Tracer) context.Context

NewContext ...

func Panic

func Panic(msg string, fields ...Field)

Panic ...

func Panicf

func Panicf(msg string, args ...interface{})

Panicf ...

func Panicw

func Panicw(msg string, keysAndValues ...interface{})

Panicw ...

func Warn

func Warn(msg string, fields ...Field)

Warn ...

func Warnf

func Warnf(msg string, args ...interface{})

Warnf ...

func Warnw

func Warnw(msg string, keysAndValues ...interface{})

Warnw ...

Types

type CloseFunc

type CloseFunc func() error

CloseFunc should be called when the caller exits to clean up buffers.

func Buffer

func Buffer(ws zapcore.WriteSyncer, bufferSize int, flushInterval time.Duration) (zapcore.WriteSyncer, CloseFunc)

Buffer wraps a WriteSyncer in a buffer to improve performance, if bufferSize = 0, we set it to defaultBufferSize if flushInterval = 0, we set it to defaultFlushInterval

type Component

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

Component 组件

var DefaultLogger *Component

DefaultLogger defines default logger, it's usually used in application business logic

var EgoLogger *Component

EgoLogger defines ego framework logger, it's for ego framework only

func With

func With(fields ...Field) *Component

With ...

func (*Component) AutoLevel

func (logger *Component) AutoLevel(confKey string)

AutoLevel ...

func (*Component) DPanic

func (logger *Component) DPanic(msg string, fields ...Field)

DPanic ...

func (*Component) DPanicf

func (logger *Component) DPanicf(template string, args ...interface{})

DPanicf ...

func (*Component) DPanicw

func (logger *Component) DPanicw(msg string, keysAndValues ...interface{})

DPanicw ...

func (*Component) Debug

func (logger *Component) Debug(msg string, fields ...Field)

Debug ...

func (*Component) Debugf

func (logger *Component) Debugf(template string, args ...interface{})

Debugf ...

func (*Component) Debugw

func (logger *Component) Debugw(msg string, keysAndValues ...interface{})

Debugw ...

func (*Component) Error

func (logger *Component) Error(msg string, fields ...Field)

Error ...

func (*Component) Errorf

func (logger *Component) Errorf(template string, args ...interface{})

Errorf ...

func (*Component) Errorw

func (logger *Component) Errorw(msg string, keysAndValues ...interface{})

Errorw ...

func (*Component) Fatal

func (logger *Component) Fatal(msg string, fields ...Field)

Fatal ...

func (*Component) Fatalf

func (logger *Component) Fatalf(template string, args ...interface{})

Fatalf ...

func (*Component) Fatalw

func (logger *Component) Fatalw(msg string, keysAndValues ...interface{})

Fatalw ...

func (*Component) Flush

func (logger *Component) Flush() error

Flush ... When use os.Stdout or os.Stderr as zapcore.WriteSyncer logger.desugar.Sync() maybe return an error like this: 'sync /dev/stdout: The handle is invalid.' Because os.Stdout and os.Stderr is a non-normal file, maybe not support 'fsync' in different os platform So ignored Sync() return value About issues: https://github.com/uber-go/zap/issues/328 About 'fsync': https://man7.org/linux/man-pages/man2/fsync.2.html

func (*Component) GetConfigDir added in v0.3.11

func (logger *Component) GetConfigDir() string

GetConfigDir 获取日志路径

func (*Component) GetConfigName added in v0.3.11

func (logger *Component) GetConfigName() string

GetConfigName 获取日志名称

func (*Component) Info

func (logger *Component) Info(msg string, fields ...Field)

Info ...

func (*Component) Infof

func (logger *Component) Infof(template string, args ...interface{})

Infof ...

func (*Component) Infow

func (logger *Component) Infow(msg string, keysAndValues ...interface{})

Infow ...

func (*Component) IsDebugMode

func (logger *Component) IsDebugMode() bool

IsDebugMode ...

func (*Component) Panic

func (logger *Component) Panic(msg string, fields ...Field)

Panic ...

func (*Component) Panicf

func (logger *Component) Panicf(template string, args ...interface{})

Panicf ...

func (*Component) Panicw

func (logger *Component) Panicw(msg string, keysAndValues ...interface{})

Panicw ...

func (*Component) SetLevel

func (logger *Component) SetLevel(lv Level)

SetLevel ...

func (*Component) StdLog

func (logger *Component) StdLog() *log.Logger

StdLog ...

func (*Component) Warn

func (logger *Component) Warn(msg string, fields ...Field)

Warn ...

func (*Component) Warnf

func (logger *Component) Warnf(template string, args ...interface{})

Warnf ...

func (*Component) Warnw

func (logger *Component) Warnw(msg string, keysAndValues ...interface{})

Warnw ...

func (*Component) With

func (logger *Component) With(fields ...Field) *Component

With ...

type Config

type Config struct {
	Debug                     bool          // 是否双写至文件控制日志输出到终端
	Level                     string        // 日志初始等级,默认info级别
	Dir                       string        // [fileWriter]日志输出目录,默认logs
	Name                      string        // [fileWriter]日志文件名称,默认框架日志ego.sys,业务日志default.log
	MaxSize                   int           // [fileWriter]日志输出文件最大长度,超过改值则截断,默认500M
	MaxAge                    int           // [fileWriter]日志存储最大时间,默认最大保存天数为7天
	MaxBackup                 int           // [fileWriter]日志存储最大数量,默认最大保存文件个数为10个
	RotateInterval            time.Duration // [fileWriter]日志轮转时间,默认1天
	EnableAddCaller           bool          // 是否添加调用者信息,默认不加调用者信息
	EnableAsync               bool          // 是否异步,默认异步
	FlushBufferSize           int           // 缓冲大小,默认256 * 1024B
	FlushBufferInterval       time.Duration // 缓冲时间,默认5秒
	Writer                    string        // 使用哪种Writer,可选[file|ali]
	AliAccessKeyID            string        // [aliWriter]阿里云sls AKID,必填
	AliAccessKeySecret        string        // [aliWriter]阿里云sls AKSecret,必填
	AliEndpoint               string        // [aliWriter]阿里云sls endpoint,必填
	AliProject                string        // [aliWriter]阿里云sls Project名称,必填
	AliLogstore               string        // [aliWriter]阿里云sls logstore名称,必填
	AliAPIBulkSize            int           // [aliWriter]阿里云sls API单次请求发送最大日志条数,最少256条,默认256条
	AliAPITimeout             time.Duration // [aliWriter]阿里云sls API接口超时,默认3秒
	AliAPIRetryCount          int           // [aliWriter]阿里云sls API接口重试次数,默认3次
	AliAPIRetryWaitTime       time.Duration // [aliWriter]阿里云sls API接口重试默认等待间隔,默认1秒
	AliAPIRetryMaxWaitTime    time.Duration // [aliWriter]阿里云sls API接口重试最大等待间隔,默认3秒
	AliAPIMaxIdleConnsPerHost int           // [aliWriter]阿里云sls 单个Host HTTP最大空闲连接数,应当大于AliApiMaxIdleConns
	AliAPIMaxIdleConns        int           // [aliWriter]阿里云sls HTTP最大空闲连接数
	AliAPIIdleConnTimeout     time.Duration // [aliWriter]阿里云sls HTTP空闲连接保活时间

	CallerSkip int
	// contains filtered or unexported fields
}

Config ...

func DefaultConfig

func DefaultConfig() *Config

DefaultConfig ...

type Container

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

Container 容器

func DefaultContainer

func DefaultContainer() *Container

DefaultContainer 默认容器

func Load

func Load(key string) *Container

Load 加载配置key

func (*Container) Build

func (c *Container) Build(options ...Option) *Component

Build 构建组件

type Field

type Field = zap.Field

Field ...

func FieldAddr

func FieldAddr(value string) Field

FieldAddr 设置地址

func FieldApp added in v0.3.4

func FieldApp(value string) Field

FieldApp 设置应用名

func FieldCode

func FieldCode(value int32) Field

FieldCode ...

func FieldComponent

func FieldComponent(value string) Field

FieldComponent 设置组件

func FieldComponentName

func FieldComponentName(value string) Field

FieldComponentName 设置组件配置名

func FieldCost

func FieldCost(value time.Duration) Field

FieldCost 耗时时间

func FieldDescription added in v0.3.4

func FieldDescription(value string) Field

FieldDescription ...

func FieldErr

func FieldErr(err error) Field

FieldErr ...

func FieldErrAny added in v0.3.11

func FieldErrAny(err interface{}) Field

FieldErrAny ...

func FieldErrKind

func FieldErrKind(value string) Field

FieldErrKind ...

func FieldEvent

func FieldEvent(value string) Field

FieldEvent ...

func FieldExtMessage

func FieldExtMessage(vals ...interface{}) Field

FieldExtMessage ...

func FieldIP added in v0.4.0

func FieldIP(value string) Field

FieldIP ...

func FieldKey

func FieldKey(value string) Field

FieldKey ...

func FieldKind added in v0.3.4

func FieldKind(value string) Field

FieldKind ... level 2

func FieldMethod

func FieldMethod(value string) Field

FieldMethod ...

func FieldName

func FieldName(value string) Field

FieldName ...

func FieldPeerIP added in v0.3.4

func FieldPeerIP(value string) Field

FieldPeerIP ...

func FieldPeerName added in v0.3.4

func FieldPeerName(value string) Field

FieldPeerName ...

func FieldSize added in v0.3.4

func FieldSize(value int32) Field

FieldSize ...

func FieldStack

func FieldStack(value []byte) Field

FieldStack ...

func FieldTid added in v0.3.6

func FieldTid(value string) Field

FieldTid 设置链路id

func FieldType

func FieldType(value string) Field

FieldType ... level 1

func FieldValue

func FieldValue(value string) Field

FieldValue ...

func FieldValueAny

func FieldValueAny(value interface{}) Field

FieldValueAny ...

type Func

type Func func(string, ...zap.Field)

Func ...

func Auto

func Auto(err error) Func

Auto ...

func (Func) Log

func (fn Func) Log(msg string, fields ...Field)

Log ...

type Level

type Level = zapcore.Level

Level ...

type Option

type Option func(c *Container)

Option 可选项

func WithDebug added in v0.3.9

func WithDebug(debug bool) Option

WithDebug 设置在命令行显示

func WithEnableAddCaller added in v0.3.11

func WithEnableAddCaller(enableAddCaller bool) Option

WithEnableAddCaller 是否添加行号,默认不添加行号

func WithEnableAsync added in v0.3.9

func WithEnableAsync(enableAsync bool) Option

WithEnableAsync 是否异步执行,默认异步

func WithFileName

func WithFileName(name string) Option

WithFileName 设置文件名

func WithLevel added in v0.3.9

func WithLevel(level string) Option

WithLevel 设置级别

type Tracer

type Tracer struct {
	BeginTime time.Time
	// contains filtered or unexported fields
}

Tracer ...

func ExtractTraceMD

func ExtractTraceMD(ctx interface{ Get(string) interface{} }) (md *Tracer, ok bool)

ExtractTraceMD ...

func NewTracer

func NewTracer() *Tracer

NewTracer ...

func (*Tracer) Error

func (t *Tracer) Error(fields ...Field)

Error ...

func (*Tracer) Flush

func (t *Tracer) Flush(msg string, logger *Component)

Flush ...

func (*Tracer) Info

func (t *Tracer) Info(fields ...Field)

Info ...

func (*Tracer) Warn

func (t *Tracer) Warn(fields ...Field)

Warn ...

Directories

Path Synopsis
ali
pb

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL