dflog

Documentation

Index

• Constants
• func Init(l *logrus.Logger, opts ...Option) error
• type ConsoleHook
  • func (ch *ConsoleHook) Fire(entry *logrus.Entry) error
  • func (ch *ConsoleHook) Levels() []logrus.Level
• type DragonflyFormatter
  • func (f *DragonflyFormatter) Format(entry *logrus.Entry) ([]byte, error)
• type Option
  • func WithConsole() Option
  • func WithDebug(debug bool) Option
  • func WithLogFile(f string) Option
  • func WithMaxSizeMB(max uint) Option
  • func WithSign(sign string) Option

Constants

const DefaultLogTimeFormat = "2006-01-02 15:04:05.000"

DefaultLogTimeFormat defines the timestamp format.

Functions

func Init

func Init(l *logrus.Logger, opts ...Option) error

Init initializes the logger with given options. If no option is provided, the logger's formatter will be set with an empty sign.

Types

type ConsoleHook

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

ConsoleHook shows logs on console.

func (*ConsoleHook) Fire

func (ch *ConsoleHook) Fire(entry *logrus.Entry) error

Fire implements Hook#Fire.

func (*ConsoleHook) Levels

func (ch *ConsoleHook) Levels() []logrus.Level

Levels implements Hook#Levels().

type DragonflyFormatter

type DragonflyFormatter struct {
	// TimestampFormat sets the format used for marshaling timestamps.
	TimestampFormat string
	Sign            string
}

DragonflyFormatter customizes the dragonfly log format.

func (*DragonflyFormatter) Format

func (f *DragonflyFormatter) Format(entry *logrus.Entry) ([]byte, error)

Format implements Formatter#Format.

type Option

type Option func(l *logrus.Logger) error

Option is a functional configuration for the given logrus logger.

func WithConsole

func WithConsole() Option

WithConsole adds a hook to output logs to stdout.

func WithDebug

func WithDebug(debug bool) Option

WithDebug sets the log level to debug.

func WithLogFile

func WithLogFile(f string) Option

WithLogFile sets the logger to output to the given file, with log rotation. If the given file is empty, nothing will be done.

func WithMaxSizeMB

func WithMaxSizeMB(max uint) Option

WithMaxSizeMB sets the max size of log files in MB. If the logger is not configured to use a log file, an error is returned.

func WithSign

func WithSign(sign string) Option

WithSign sets the sign in formatter.