xlog

README

xlog

xlog is a simple and easy-to-use logger with zap logger as the bottom abstraction

介绍

xlog是一个对zap logger的简单的封装, 意在简化配置, 增强可控, 简洁易用。

example

package example_test

import (
	"testing"
	"time"

	"github.com/pubgo/dix"
	"github.com/pubgo/xerror"
	"github.com/pubgo/xlog"
	"github.com/pubgo/xlog/internal"
	"github.com/pubgo/xlog/xlog_config"
)

var log = xlog.GetLog()

func init() {
	dix.Go(func(log1 xlog.XLog) {
		log = log1.
			Named("service").With(xlog.String("key", "service")).
			Named("hello").With(xlog.String("key", "hello")).
			Named("world").With(xlog.String("key", "world"))
	})
}

func TestExample(t *testing.T) {
	log.Debug("hello",
		xlog.Any("hss", "ss"),
	)

	dix.Go(initCfgFromJsonDebug(time.Now().Format("2006-01-02 15:04:05")))

	log.Info("hello",
		xlog.Any("hss", "ss"),
	)
	//fmt.Println(dix.Graph())
}

func initCfgFromJsonDebug(name string) internal.XLog {
	cfg := `{
        "level": "debug",
        "development": true,
        "disableCaller": false,
        "disableStacktrace": false,
        "sampling": null,
        "encoding": "console",
        "encoderConfig": {
                "messageKey": "M",
                "levelKey": "L",
                "timeKey": "T",
                "nameKey": "N",
                "callerKey": "C",
                "stacktraceKey": "S",
                "lineEnding": "\n",
                "levelEncoder": "capitalColor",
                "timeEncoder": "iso8601",
                "durationEncoder": "string",
                "callerEncoder": "default",
                "nameEncoder": ""
        },
        "outputPaths": [
                "stderr"
        ],
        "errorOutputPaths": [
                "stderr"
        ],
        "initialFields": null
}`

	zl, err := xlog_config.NewZapLoggerFromJson([]byte(cfg), xlog_config.WithEncoding("console"))
	xerror.Exit(err)
	return xlog.New(zl.WithOptions(xlog.AddCallerSkip(1)))
}

Documentation

Index

• func DPanic(msg string, fields ...zap.Field)
• func DPanicFn(msg string, fn func(fields *xlog_abc.Fields))
• func DPanicf(format string, a ...interface{})
• func Debug(msg string, fields ...zap.Field)
• func DebugFn(msg string, fn func(fields *xlog_abc.Fields))
• func Debugf(format string, a ...interface{})
• func Error(msg string, fields ...zap.Field)
• func ErrorFn(msg string, fn func(fields *xlog_abc.Fields))
• func Errorf(format string, a ...interface{})
• func Fatal(msg string, fields ...zap.Field)
• func FatalFn(msg string, fn func(fields *xlog_abc.Fields))
• func Fatalf(format string, a ...interface{})
• func Info(msg string, fields ...zap.Field)
• func InfoFn(msg string, fn func(fields *xlog_abc.Fields))
• func Infof(format string, a ...interface{})
• func Named(s string, opts ...zap.Option) xlog_abc.Xlog
• func New(zl *zap.Logger) xlog_abc.Xlog
• func Panic(msg string, fields ...zap.Field)
• func PanicFn(msg string, fn func(fields *xlog_abc.Fields))
• func Panicf(format string, a ...interface{})
• func SetDefault(lg xlog_abc.Xlog) (err error)
• func Sync() error
• func Warn(msg string, fields ...zap.Field)
• func WarnFn(msg string, fn func(fields *xlog_abc.Fields))
• func Warnf(format string, a ...interface{})
• func Watch(fn func(logs xlog_abc.Xlog))
• func With(fields ...zap.Field) xlog_abc.Xlog

Functions

func DPanic

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

func DPanicFn

func DPanicFn(msg string, fn func(fields *xlog_abc.Fields))

func DPanicf

func DPanicf(format string, a ...interface{})

func Debug

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

func DebugFn

func DebugFn(msg string, fn func(fields *xlog_abc.Fields))

func Debugf

func Debugf(format string, a ...interface{})

func Error

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

func ErrorFn

func ErrorFn(msg string, fn func(fields *xlog_abc.Fields))

func Errorf

func Errorf(format string, a ...interface{})

func Fatal

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

func FatalFn

func FatalFn(msg string, fn func(fields *xlog_abc.Fields))

func Fatalf

func Fatalf(format string, a ...interface{})

func Info

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

func InfoFn

func InfoFn(msg string, fn func(fields *xlog_abc.Fields))

func Infof

func Infof(format string, a ...interface{})

func Named

func Named(s string, opts ...zap.Option) xlog_abc.Xlog

func New

func New(zl *zap.Logger) xlog_abc.Xlog

func Panic

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

func PanicFn

func PanicFn(msg string, fn func(fields *xlog_abc.Fields))

func Panicf

func Panicf(format string, a ...interface{})

func SetDefault

func SetDefault(lg xlog_abc.Xlog) (err error)

func Sync

func Sync() error

func Warn

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

func WarnFn

func WarnFn(msg string, fn func(fields *xlog_abc.Fields))

func Warnf

func Warnf(format string, a ...interface{})

func Watch

func Watch(fn func(logs xlog_abc.Xlog))

func With

func With(fields ...zap.Field) xlog_abc.Xlog