logs

code.gopub.tech/logs

Logger 前端

全局函数

基本用法

import	"code.gopub.tech/logs"

logs.Trace(ctx context.Context, format string, args ...any)
logs.Debug()
logs.Info()
logs.Notice()
logs.Warn()
logs.Error()
logs.Panic() // 输出日志后抛出 panic
logs.Fatal() // 输出日志后终止程序 os.Exit

关联 kv

// 在 Logger 上关联 kv
// With() returns a Logger
logs.With(key, value).Info(ctx, "")

// 在 ctx 上关联 kv
ctx = kv.Add(ctx, key, value)

设置全局默认 Logger

logs.SetDefault(Logger)

Logger 接口

type Logger interface {
	With(key, value any) Logger
	Trace(ctx context.Context, format string, args ...any)
	Debug(ctx context.Context, format string, args ...any)
	Info(ctx context.Context, format string, args ...any)
	Notice(ctx context.Context, format string, args ...any)
	Warn(ctx context.Context, format string, args ...any)
	Error(ctx context.Context, format string, args ...any)
	Panic(ctx context.Context, format string, args ...any)
	Fatal(ctx context.Context, format string, args ...any)
	// Log 打印日志接口
	// callDepth: 0=caller position
	Log(ctx context.Context, callDepth int, level Level, format string, args ...any)
}

内置默认的 Logger 实现

logs.NewLogger(handler) // 需要传入 handler 用于日志后端处理

Handler 后端

Handler 接口

type Handler interface {
	Output(Record)
}

内置默认的 Handler 实现

// create a default handler.
// 默认处理器, 输出到 stderr, 自动检测颜色, Info 级别.
logs.NewHandler(opts...)
// Options:
logs.WithWriter(io.Writer)     // 输出目的地 默认 stderr
logs.WithJSON()                // 是否输出 json 格式 默认 false
logs.WithLevel(level Level)    // 默认 Info 级别
logs.WithLevels(LivelProvider) // 为不同包名配置不同级别

License