logger

Documentation

Overview

Package logger defines logging for grpc.

All logs in transport package only go to verbose level 2. All logs in other packages in grpc are logged in spite of the verbosity level.

In the default logger, severity level can be set by environment variable GRPC_GO_LOG_SEVERITY_LEVEL, verbosity level can be set by GRPC_GO_LOG_VERBOSITY_LEVEL.

Index

• func Error(args ...interface{})
• func Errorf(format string, args ...interface{})
• func Errorln(args ...interface{})
• func Fatal(args ...interface{})
• func Fatalf(format string, args ...interface{})
• func Fatalln(args ...interface{})
• func Info(args ...interface{})
• func Infof(format string, args ...interface{})
• func Infoln(args ...interface{})
• func SetLogger(l Logger)
• func V(l int) bool
• func Warning(args ...interface{})
• func Warningf(format string, args ...interface{})
• func Warningln(args ...interface{})
• type Logger
  • func NewLogger(infoW, warningW, errorW io.Writer) Logger
  • func NewLoggerWithVerbosity(infoW, warningW, errorW io.Writer, v int) Logger

Functions

func Error

func Error(args ...interface{})

Error logs to the ERROR log.

func Errorf

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

Errorf logs to the ERROR log. Arguments are handled in the manner of fmt.Printf.

func Errorln

func Errorln(args ...interface{})

Errorln logs to the ERROR log. Arguments are handled in the manner of fmt.Println.

func Fatal

func Fatal(args ...interface{})

Fatal logs to the FATAL log. Arguments are handled in the manner of fmt.Print. It calls os.Exit() with exit code 1.

func Fatalf

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

Fatalf logs to the FATAL log. Arguments are handled in the manner of fmt.Printf. It calles os.Exit() with exit code 1.

func Fatalln

func Fatalln(args ...interface{})

Fatalln logs to the FATAL log. Arguments are handled in the manner of fmt.Println. It calle os.Exit()) with exit code 1.

func Info

func Info(args ...interface{})

Info logs to the INFO log.

func Infof

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

Infof logs to the INFO log. Arguments are handled in the manner of fmt.Printf.

func Infoln

func Infoln(args ...interface{})

Infoln logs to the INFO log. Arguments are handled in the manner of fmt.Println.

func SetLogger

func SetLogger(l Logger)

SetLogger sets logger that is used in grpc to a V2 logger. Not mutex-protected, should be called before any gRPC functions.

func V

func V(l int) bool

V reports whether verbosity level l is at least the requested verbose level.

func Warning

func Warning(args ...interface{})

Warning logs to the WARNING log.

func Warningf

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

Warningf logs to the WARNING log. Arguments are handled in the manner of fmt.Printf.

func Warningln

func Warningln(args ...interface{})

Warningln logs to the WARNING log. Arguments are handled in the manner of fmt.Println.

Types

type Logger

type Logger interface {
	// Info logs to INFO log. Arguments are handled in the manner of fmt.Print.
	Info(args ...interface{})
	// Infoln logs to INFO log. Arguments are handled in the manner of fmt.Println.
	Infoln(args ...interface{})
	// Infof logs to INFO log. Arguments are handled in the manner of fmt.Printf.
	Infof(format string, args ...interface{})
	// Warning logs to WARNING log. Arguments are handled in the manner of fmt.Print.
	Warning(args ...interface{})
	// Warningln logs to WARNING log. Arguments are handled in the manner of fmt.Println.
	Warningln(args ...interface{})
	// Warningf logs to WARNING log. Arguments are handled in the manner of fmt.Printf.
	Warningf(format string, args ...interface{})
	// Error logs to ERROR log. Arguments are handled in the manner of fmt.Print.
	Error(args ...interface{})
	// Errorln logs to ERROR log. Arguments are handled in the manner of fmt.Println.
	Errorln(args ...interface{})
	// Errorf logs to ERROR log. Arguments are handled in the manner of fmt.Printf.
	Errorf(format string, args ...interface{})
	// Fatal logs to ERROR log. Arguments are handled in the manner of fmt.Print.
	// gRPC ensures that all Fatal logs will exit with os.Exit(1).
	// Implementations may also call os.Exit() with a non-zero exit code.
	Fatal(args ...interface{})
	// Fatalln logs to ERROR log. Arguments are handled in the manner of fmt.Println.
	// gRPC ensures that all Fatal logs will exit with os.Exit(1).
	// Implementations may also call os.Exit() with a non-zero exit code.
	Fatalln(args ...interface{})
	// Fatalf logs to ERROR log. Arguments are handled in the manner of fmt.Printf.
	// gRPC ensures that all Fatal logs will exit with os.Exit(1).
	// Implementations may also call os.Exit() with a non-zero exit code.
	Fatalf(format string, args ...interface{})
	// V reports whether verbosity level l is at least the requested verbose level.
	V(l int) bool
}

Logger does underlying logging work for logger.

func NewLogger

func NewLogger(infoW, warningW, errorW io.Writer) Logger

NewLogger creates a loggerV2 with the provided writers. Fatal logs will be written to errorW, warningW, infoW, followed by exit(1). Error logs will be written to errorW, warningW and infoW. Warning logs will be written to warningW and infoW. Info logs will be written to infoW.

func NewLoggerWithVerbosity

func NewLoggerWithVerbosity(infoW, warningW, errorW io.Writer, v int) Logger

NewLoggerWithVerbosity creates a loggerV2 with the provided writers and verbosity level.