logrusKit

Documentation

Index

• func DisposeLogger(logger *logrus.Logger) error
• func NewFileLogger(filePath string, formatter logrus.Formatter, level logrus.Level, ...) (*logrus.Logger, error)
• func NewLogger(formatter logrus.Formatter, level logrus.Level) *logrus.Logger
• func NewRotateFileLogger(filePath string, rotationTime, maxAge time.Duration, softLinkFlag bool, ...) (*logrus.Logger, error)
• func NewTextFormatter(timestampFormat string) logrus.Formatter
• func PrintBasicDetails()
• func PrintError(err error)
• func PrintErrorWithLogger(err error, logger *logrus.Logger)
• func SetConsoleLevel(level logrus.Level)
• func SetLevel(logger *logrus.Logger, level logrus.Level)
• func SetUp(config *Config)
• func StringToLevel(str string) logrus.Level
• type Config

Functions

func DisposeLogger

func DisposeLogger(logger *logrus.Logger) error

DisposeLogger 释放资源（主要针对文件日志）

func NewFileLogger

func NewFileLogger(filePath string, formatter logrus.Formatter, level logrus.Level, toConsoleFlag bool) (*logrus.Logger, error)

NewFileLogger

PS: 如果 logger.Out 被释放后继续调用 logger 进行输出，会失败（e.g. 控制台os.Stderr有输出: Failed to write to log, write /Users/richelieu/Downloads/a.txt: file already closed）.

@param filePath 内部会做处理:

(1) 会尝试创建父级目录
(2) 文件不存在，会自动创建
(3) 文件存在：是个文件，追加在最后；是个目录，返回error

@param formatter 可以为nil，此时将采用默认值 @param toConsoleFlag true: 输出到日志文件的同时，也输出到控制台; false: 只输出到文件日志

func NewLogger

func NewLogger(formatter logrus.Formatter, level logrus.Level) *logrus.Logger

NewLogger 输出到控制台（os.Stderr） + TextFormatter

@param formatter 可以为nil(此时将采用默认值)

func NewRotateFileLogger

func NewRotateFileLogger(filePath string, rotationTime, maxAge time.Duration, softLinkFlag bool, formatter logrus.Formatter, level logrus.Level, toConsoleFlag bool) (*logrus.Logger, error)

NewRotateFileLogger

Deprecated: 不推荐使用.

PS: 如果 logger.Out 被释放后继续调用 logger 进行输出，会失败（e.g. 控制台os.Stderr有输出: Failed to write to log, invalid argument）.

@param filePath 内部会做处理:

(1) 会尝试创建父级目录
(2) 文件不存在，会自动创建
(3) 文件存在：是个文件，追加在最后；是个目录，返回error

func NewTextFormatter

func NewTextFormatter(timestampFormat string) logrus.Formatter

NewTextFormatter

PS: 外部在调用此方法后，建议调用: Logger.SetReportCaller(true)!!!

@param timestampFormat 可以为""（将采用默认值）

e.g. 日志输出 time=2023-03-23 16:46:23.398+08:00 level=info msg=[CHIMERA, PROCESS] pid: [8579]. func=PrintBasicDetails(logrusKit/basicDetails.go:17) time=2023-03-23 16:46:23.398+08:00 level=info msg=[CHIMERA, OS] os: [darwin]. func=PrintBasicDetails(logrusKit/basicDetails.go:20) time=2023-03-23 16:46:23.398+08:00 level=info msg=[CHIMERA, OS] arch: [arm64]. func=PrintBasicDetails(logrusKit/basicDetails.go:21)

func PrintBasicDetails

func PrintBasicDetails()

PrintBasicDetails 输出服务器的基本信息（以便于甩锅）

func PrintError

func PrintError(err error)

PrintError

@param err 只有通过"github.com/pkg/errors" New 或 Wrap 的error才有堆栈信息

func PrintErrorWithLogger

func PrintErrorWithLogger(err error, logger *logrus.Logger)

func SetConsoleLevel

func SetConsoleLevel(level logrus.Level)

SetConsoleLevel 设置控制台输出的日志级别

func SetLevel

func SetLevel(logger *logrus.Logger, level logrus.Level)

func SetUp

func SetUp(config *Config)

SetUp

@param config 可以为nil

func StringToLevel

func StringToLevel(str string) logrus.Level

StringToLevel string => logrus.Level

Types

type Config

type Config struct {
	Level      string `json:"level"`
	PrintBasic bool   `json:"printBasic"`
}