logging

Documentation

Overview

Package logging provides logging functionality for gnet server, it sets up a default logger (powered by go.uber.org/zap) which is about to be used by gnet server, it also allows users to replace the default logger with their customized logger by just implementing the `Logger` interface and assign it to the functional option `Options.Logger`, pass it to `gnet.Serve` method.

The environment variable `GNET_LOGGING_LEVEL` determines which zap logger level will be applied for logging. The environment variable `GNET_LOGGING_FILE` is set to a local file path when you want to print logs into local file. Alternatives of logging level (the variable of logging level ought to be integer):

const (

// DebugLevel logs are typically voluminous, and are usually disabled in
// production.
DebugLevel Level = iota - 1
// InfoLevel is the default logging priority.
InfoLevel
// WarnLevel logs are more important than Info, but don't need individual
// human review.
WarnLevel
// ErrorLevel logs are high-priority. If an application is running smoothly,
// it shouldn't generate any error-level logs.
ErrorLevel
// DPanicLevel logs are particularly important errors. In development the
// logger panics after writing the message.
DPanicLevel
// PanicLevel logs a message, then panics.
PanicLevel
// FatalLevel logs a message, then calls os.Exit(1).
FatalLevel

)

Index

• func Cleanup()
• func Debugf(format string, args ...interface{})
• func Errorf(format string, args ...interface{})
• func Fatalf(format string, args ...interface{})
• func Infof(format string, args ...interface{})
• func LogErr(err error)
• func LogLevel() string
• func Warnf(format string, args ...interface{})
• type Logger
  • func CreateLoggerAsLocalFile(localFilePath string, logLevel zapcore.Level) (logger Logger, flush func() error, err error)
  • func GetDefaultLogger() Logger

Functions

func Cleanup

func Cleanup()

Cleanup does something windup for logger, like closing, flushing, etc.

func Debugf

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

Debugf logs messages at DEBUG level.

func Errorf

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

Errorf logs messages at ERROR level.

func Fatalf

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

Fatalf logs messages at FATAL level.

func Infof

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

Infof logs messages at INFO level.

func LogErr

func LogErr(err error)

LogErr prints err if it's not nil.

func LogLevel

func LogLevel() string

LogLevel tells what the default logging level is.

func Warnf

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

Warnf logs messages at WARN level.

Types

type Logger

type Logger interface {
	// Debugf logs messages at DEBUG level.
	Debugf(format string, args ...interface{})
	// Infof logs messages at INFO level.
	Infof(format string, args ...interface{})
	// Warnf logs messages at WARN level.
	Warnf(format string, args ...interface{})
	// Errorf logs messages at ERROR level.
	Errorf(format string, args ...interface{})
	// Fatalf logs messages at FATAL level.
	Fatalf(format string, args ...interface{})
}

Logger is used for logging formatted messages.

func CreateLoggerAsLocalFile

func CreateLoggerAsLocalFile(localFilePath string, logLevel zapcore.Level) (logger Logger, flush func() error, err error)

CreateLoggerAsLocalFile setups the logger by local file path.

func GetDefaultLogger

func GetDefaultLogger() Logger

GetDefaultLogger returns the default logger.