xlog

README

xlog

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

example

package main

import (
	"encoding/json"

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

var log xlog.Xlog

func init() {
	xlog.Watch(func(logs xlog.Xlog) {
		log = logs.Named("test")
	})
}

func main() {
	log.Info("hello", xlog.String("ss", "hello1"))
	xlog.Info("hello", xlog.String("ss", "hello1"))
	xlog.Infof("hello %s", "1234")
	xlog.InfoM("hello %s", xlog.M{
		"test": "ok",
	})
	xlog.Warn("test")

	initCfgFromJson()

	xlog.Info("hello", xlog.String("ss", "hello1"))
	xlog.Infof("hello %s", "1234")
	xlog.InfoM("hello %s", xlog.M{
		"test": "ok",
	})
	xlog.Warn("test")
	log.Info("hello", xlog.String("ss", "hello1"))
	xlog.WarnW(func(log xlog.Logger) {
		log.Println("hello w")
	})
	log.WarnW(func(log xlog.Logger) {
		log.Print("hhhh jnjnjnj")
	})
}

func initCfgFromJson() {
	cfg := `{
        "level": "info",
        "development": false,
        "disableCaller": false,
        "disableStacktrace": false,
        "sampling": {
                "initial": 100,
                "thereafter": 100
        },
        "encoding": "json",
        "encoderConfig": {
                "messageKey": "msg",
                "levelKey": "level",
                "timeKey": "ts",
                "nameKey": "logger",
                "callerKey": "caller",
                "stacktraceKey": "stacktrace",
                "lineEnding": "\n",
                "levelEncoder": "default",
                "timeEncoder": "default",
                "durationEncoder": "default",
                "callerEncoder": "full",
                "nameEncoder": "default"
        },
        "outputPaths": ["stderr"],
        "errorOutputPaths": ["stderr"],
        "initialFields": null
}`

	var cfg1 xlog_config.Config
	xerror.Exit(json.Unmarshal([]byte(cfg), &cfg1))
	cfg1.Encoding = "console"
	zl, err := cfg1.Build()

	xerror.Exit(err)
	xerror.Exit(xlog.SetDefault(xlog.New(zl)))
	xlog.Warn("test")
}

日志切割

https://github.com/natefinch/lumberjack

日志分析

https://github.com/allinurl/goaccess

Documentation

Index

• func DPanic(args ...interface{})
• func DPanicW(fn func(log Logger))
• func DPanicf(format string, a ...interface{})
• func Debug(args ...interface{})
• func DebugW(fn func(log Logger))
• func Debugf(format string, a ...interface{})
• func ErrWith(name string, err error)
• func Error(args ...interface{})
• func ErrorW(fn func(log Logger))
• func Errorf(format string, a ...interface{})
• func Fatal(args ...interface{})
• func FatalW(fn func(log Logger))
• func Fatalf(format string, a ...interface{})
• func Info(args ...interface{})
• func InfoW(fn func(log Logger))
• func Infof(format string, a ...interface{})
• func Panic(args ...interface{})
• func PanicW(fn func(log Logger))
• func Panicf(format string, a ...interface{})
• func SetDefault(logger *zap.Logger) (err error)
• func Warn(args ...interface{})
• func WarnW(fn func(log Logger))
• func Warnf(format string, a ...interface{})
• type Logger
• type M
• type Xlog
  • func GetDefault() Xlog
  • func GetLogger(name string, opts ...zap.Option) Xlog

Functions

func DPanic

func DPanic(args ...interface{})

func DPanicW

func DPanicW(fn func(log Logger))

func DPanicf

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

func Debug

func Debug(args ...interface{})

func DebugW

func DebugW(fn func(log Logger))

func Debugf

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

func ErrWith

func ErrWith(name string, err error)

func Error

func Error(args ...interface{})

func ErrorW

func ErrorW(fn func(log Logger))

func Errorf

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

func Fatal

func Fatal(args ...interface{})

func FatalW

func FatalW(fn func(log Logger))

func Fatalf

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

func Info

func Info(args ...interface{})

func InfoW

func InfoW(fn func(log Logger))

func Infof

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

func Panic

func Panic(args ...interface{})

func PanicW

func PanicW(fn func(log Logger))

func Panicf

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

func SetDefault

func SetDefault(logger *zap.Logger) (err error)

SetDefault 设置默认的zap logger

func Warn

func Warn(args ...interface{})

func WarnW

func WarnW(fn func(log Logger))

func Warnf

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

Types

type Logger

type Logger interface {
	Printf(format string, v ...interface{})
	Print(v ...interface{})
	Println(v ...interface{})
	PrintM(m M)
}

type M

type M map[string]interface{}

type Xlog

type Xlog interface {
	Debug(args ...interface{})
	Info(args ...interface{})
	Warn(args ...interface{})
	Error(args ...interface{})
	DPanic(args ...interface{})
	Panic(args ...interface{})
	Fatal(args ...interface{})

	DebugW(func(log Logger))
	InfoW(func(log Logger))
	WarnW(func(log Logger))
	ErrorW(func(log Logger))
	DPanicW(func(log Logger))
	PanicW(func(log Logger))
	FatalW(func(log Logger))

	Debugf(format string, a ...interface{})
	Infof(format string, a ...interface{})
	Warnf(format string, a ...interface{})
	Errorf(format string, a ...interface{})
	Panicf(format string, a ...interface{})
	Fatalf(format string, a ...interface{})
	DPanicf(format string, a ...interface{})

	Named(name string, opts ...zap.Option) Xlog
}

func GetDefault

func GetDefault() Xlog

GetDefault 获取默认xlog

func GetLogger

func GetLogger(name string, opts ...zap.Option) Xlog