logs

package

v0.78.1 Latest Latest Go to latest Published: Jul 23, 2023 License: MIT Imports: 10 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/issue9/web

Links

Open Source Insights

Documentation ¶

Overview ¶

Package logs 日志操作

这是对 logs 的二次定义，方便使用者引用。

Index ¶

Constants
func DestroyParamsLogs(l *ParamsLogs)
func NewRotateFile(format, dir string, size int64) (io.WriteCloser, error)
func NewSMTP(username, password, subject, host string, sendTo []string) io.Writer
type HandleFunc
type Handler
type Level
- func AllLevels() []Level
type Logger
type Logs
- func New(opt *Options) (*Logs, error)
type Options
type ParamsLogs
type Record

Constants ¶

View Source

const (
	MilliLayout = logs.MilliLayout
	MicroLayout = logs.MicroLayout
	NanoLayout  = logs.NanoLayout
)

日志的时间格式

View Source

const (
	Info  = logs.LevelInfo
	Trace = logs.LevelTrace
	Warn  = logs.LevelWarn
	Debug = logs.LevelDebug
	Error = logs.LevelError
	Fatal = logs.LevelFatal
)

日志的类别

Variables ¶

This section is empty.

Functions ¶

func DestroyParamsLogs ¶ added in v0.78.0

func DestroyParamsLogs(l *ParamsLogs)

DestroyParamsLogs 回收由 ParamsLogs 对象

这是一个非必须的方法，调用可能会有一定的性能提升。

func NewRotateFile ¶

func NewRotateFile(format, dir string, size int64) (io.WriteCloser, error)

NewRotateFile 按大小分割的文件日志

参数说明参考 rotate.New

func NewSMTP ¶ added in v0.67.1

func NewSMTP(username, password, subject, host string, sendTo []string) io.Writer

NewSMTP 将日志内容发送至指定邮箱

参数说明参考 writers.NewSMTP

Types ¶

type HandleFunc ¶ added in v0.78.0

type HandleFunc = logs.HandleFunc

type Handler ¶ added in v0.78.0

type Handler = logs.Handler

func MergeHandler ¶ added in v0.78.0

func MergeHandler(w ...Handler) Handler

func NewDispatchHandler ¶ added in v0.78.0

func NewDispatchHandler(d map[Level]Handler) Handler

func NewJSONHandler ¶ added in v0.78.0

func NewJSONHandler(timeLayout string, w ...io.Writer) Handler

func NewNopHandler ¶ added in v0.78.0

func NewNopHandler() Handler

func NewTermHandler ¶ added in v0.78.0

func NewTermHandler(timeLayout string, w io.Writer, colors map[Level]colors.Color) Handler

NewTermHandler 带颜色的终端输出通道

参数说明参考 logs.NewTermHandler

func NewTextHandler ¶ added in v0.78.0

func NewTextHandler(timeLayout string, w ...io.Writer) Handler

type Level ¶

type Level = logs.Level

func AllLevels ¶

func AllLevels() []Level

type Logger ¶

type Logger = logs.Logger

type Logs ¶

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

Logs 日志对象

func New ¶

func New(opt *Options) (*Logs, error)

New 声明日志实例

func (*Logs) DEBUG ¶

func (l *Logs) DEBUG() Logger

func (*Logs) ERROR ¶

func (l *Logs) ERROR() Logger

func (*Logs) FATAL ¶

func (l *Logs) FATAL() Logger

func (*Logs) INFO ¶

func (l *Logs) INFO() Logger

func (*Logs) Logger ¶ added in v0.78.0

func (l *Logs) Logger(lv Level) Logger

func (*Logs) NewRecord ¶ added in v0.78.0

func (l *Logs) NewRecord(lv Level) *Record

func (*Logs) TRACE ¶

func (l *Logs) TRACE() Logger

func (*Logs) WARN ¶

func (l *Logs) WARN() Logger

func (*Logs) With ¶

func (l *Logs) With(ps map[string]any) *ParamsLogs

With 构建一个带有指定参数日志对象

type Options ¶

type Options struct {
	Handler Handler
	Caller  bool    // 是否带调用堆栈信息
	Created bool    // 是否带时间
	Levels  []Level // 允许的日志通道

	// 标准库的错误日志重定义至哪个通道
	//
	// 一些由 log.Println 等全局方法输出的内容，由此指定输出的通道。
	StdLevel Level
}

Options 初始化日志的选项

type ParamsLogs ¶

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

ParamsLogs 带参数的日志

func (*ParamsLogs) DEBUG ¶

func (l *ParamsLogs) DEBUG() Logger

func (*ParamsLogs) ERROR ¶

func (l *ParamsLogs) ERROR() Logger

func (*ParamsLogs) FATAL ¶

func (l *ParamsLogs) FATAL() Logger

func (*ParamsLogs) INFO ¶

func (l *ParamsLogs) INFO() Logger

func (*ParamsLogs) Logger ¶ added in v0.78.0

func (l *ParamsLogs) Logger(lv Level) Logger

func (*ParamsLogs) NewRecord ¶ added in v0.78.0

func (l *ParamsLogs) NewRecord(lv Level) *Record

func (*ParamsLogs) TRACE ¶

func (l *ParamsLogs) TRACE() Logger

func (*ParamsLogs) WARN ¶

func (l *ParamsLogs) WARN() Logger

type Record ¶ added in v0.78.0

type Record = logs.Record

Source Files ¶

View all Source files

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