log

package
v1.13.10 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 11, 2024 License: Apache-2.0 Imports: 10 Imported by: 36

README

log

Extension module of golang logging

Documentation

Index

Constants

View Source
const (
	// Bits or'ed together to control what's printed. There is no control over the
	// order they appear (the order listed here) or the format they present (as
	// described in the comments).  A colon appears after these items:
	//	2009/0123 01:23:23.123123 /a/b/c/d.go:23: message
	Ldate         = 1 << iota // the date: 2009/0123
	Ltime                     // the time: 01:23:23
	Lmicroseconds             // microsecond resolution: 01:23:23.123123.  assumes Ltime.
	Llongfile                 // full file name and line number: /a/b/c/d.go:23
	Lshortfile                // final file name element and line number: d.go:23. overrides Llongfile
	// Deprecated: recommend to use Lintermediatefile option instead.
	Lmodule                                           // module name
	Llevel                                            // level: 0(Debug), 1(Info), 2(Warn), 3(Error), 4(Panic), 5(Fatal)
	Lintermediatefile                                 // final file format output is typically in the format c/d.go:23, which includes the last two paths. If the compilation includes the '-trimpath' parameter, this format will just exclude the module path prefix.
	LstdFlags         = Ldate | Ltime | Lmicroseconds // initial values for the standard logger
	Ldefault          = Llevel | Lintermediatefile | LstdFlags
)

These flags define which text to prefix to each log entry generated by the Logger.

View Source
const (
	// Ldebug is a log output level that prints debug information.
	Ldebug = iota
	// Linfo is a log output level that prints prompting information.
	Linfo
	// Lwarn is a log output level that prints warning information.
	Lwarn
	// Lerror is a log output level that prints error information.
	Lerror
	// Lpanic is a log output level that prints error information.
	Lpanic
	// Lfatal is a log output level that prints fatal information.
	Lfatal
)

Variables

View Source
var Std = New(os.Stderr, "", Ldefault)

Std *Logger.

Functions

func CanOutput added in v1.10.2

func CanOutput(lvl int) bool

CanOutput returns to output a message or not.

func Debug

func Debug(v ...interface{})

Debug prints a debug information.

func Debugf

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

Debugf prints a debug information.

func Error

func Error(v ...interface{})

Error prints an error information.

func Errorf

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

Errorf prints an error information.

func Fatal

func Fatal(v ...interface{})

Fatal is equivalent to Print() followed by a call to os.Exit(1).

func Fatalf

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

Fatalf is equivalent to Printf() followed by a call to os.Exit(1).

func Fatalln

func Fatalln(v ...interface{})

Fatalln is equivalent to Println() followed by a call to os.Exit(1).

func Flags

func Flags() int

Flags returns the output flags for the standard logger.

func GetOutputLevel

func GetOutputLevel() int

GetOutputLevel returns output level.

func Info

func Info(v ...interface{})

Info prints a prompting information.

func Infof

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

Infof prints a prompting information.

func Panic

func Panic(v ...interface{})

Panic is equivalent to Print() followed by a call to panic().

func Panicf

func Panicf(format string, v ...interface{})

Panicf is equivalent to Printf() followed by a call to panic().

func Panicln

func Panicln(v ...interface{})

Panicln is equivalent to Println() followed by a call to panic().

func Prefix

func Prefix() string

Prefix returns the output prefix for the standard logger.

func Print

func Print(v ...interface{})

Print calls Output to print to the standard logger. Arguments are handled in the manner of fmt.Print.

func Printf

func Printf(format string, v ...interface{})

Printf calls Output to print to the standard logger. Arguments are handled in the manner of fmt.Printf.

func Println

func Println(v ...interface{})

Println calls Output to print to the standard logger. Arguments are handled in the manner of fmt.Println.

func SetFlags

func SetFlags(flag int)

SetFlags sets the output flags for the standard logger.

func SetOutput

func SetOutput(w io.Writer)

SetOutput sets the output destination for the standard logger.

func SetOutputLevel

func SetOutputLevel(lvl int)

SetOutputLevel sets output level.

func SetPrefix

func SetPrefix(prefix string)

SetPrefix sets the output prefix for the standard logger.

func SingleStack

func SingleStack(v ...interface{})

SingleStack prints a stack trace of the calling goroutines.

func Stack

func Stack(v ...interface{})

Stack prints a stack trace of all goroutines.

func Warn

func Warn(v ...interface{})

Warn prints a warning information.

func Warnf

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

Warnf prints a warning information.

Types

type Logger

type Logger struct {
	Level int // debug level
	// contains filtered or unexported fields
}

A Logger represents an active logging object that generates lines of output to an io.Writer. Each logging operation makes a single call to the Writer's Write method. A Logger can be used simultaneously from multiple goroutines; it guarantees to serialize access to the Writer.

func New

func New(out io.Writer, prefix string, flag int) *Logger

New creates a new Logger. The out variable sets the destination to which log data will be written. The prefix appears at the beginning of each generated log line. The flag argument defines the logging properties.

func (*Logger) Debug

func (l *Logger) Debug(v ...interface{})

Debug prints a debug information.

func (*Logger) Debugf

func (l *Logger) Debugf(format string, v ...interface{})

Debugf prints a debug information.

func (*Logger) Error

func (l *Logger) Error(v ...interface{})

Error prints an error information.

func (*Logger) Errorf

func (l *Logger) Errorf(format string, v ...interface{})

Errorf prints an error information.

func (*Logger) Fatal

func (l *Logger) Fatal(v ...interface{})

Fatal prints an error information and exit app.

func (*Logger) Fatalf

func (l *Logger) Fatalf(format string, v ...interface{})

Fatalf is equivalent to l.Printf() followed by a call to os.Exit(1).

func (*Logger) Fatalln

func (l *Logger) Fatalln(v ...interface{})

Fatalln is equivalent to l.Println() followed by a call to os.Exit(1).

func (*Logger) Flags

func (l *Logger) Flags() int

Flags returns the output flags for the logger.

func (*Logger) Info

func (l *Logger) Info(v ...interface{})

Info prints a prompting information.

func (*Logger) Infof

func (l *Logger) Infof(format string, v ...interface{})

Infof prints a prompting information.

func (*Logger) Output

func (l *Logger) Output(reqID string, lvl int, calldepth int, s string) error

Output writes the output for a logging event. The string s contains the text to print after the prefix specified by the flags of the Logger. A newline is appended if the last character of s is not already a newline. Calldepth is used to recover the PC and is provided for generality, although at the moment on all pre-defined paths it will be 2.

func (*Logger) Panic

func (l *Logger) Panic(v ...interface{})

Panic is equivalent to l.Print() followed by a call to panic().

func (*Logger) Panicf

func (l *Logger) Panicf(format string, v ...interface{})

Panicf is equivalent to l.Printf() followed by a call to panic().

func (*Logger) Panicln

func (l *Logger) Panicln(v ...interface{})

Panicln is equivalent to l.Println() followed by a call to panic().

func (*Logger) Prefix

func (l *Logger) Prefix() string

Prefix returns the output prefix for the logger.

func (*Logger) Print

func (l *Logger) Print(v ...interface{})

Print calls l.Output to print to the logger. Arguments are handled in the manner of fmt.Print.

func (*Logger) Printf

func (l *Logger) Printf(format string, v ...interface{})

Printf calls l.Output to print to the logger. Arguments are handled in the manner of fmt.Printf.

func (*Logger) Println

func (l *Logger) Println(v ...interface{})

Println calls l.Output to print to the logger. Arguments are handled in the manner of fmt.Println.

func (*Logger) SetFlags

func (l *Logger) SetFlags(flag int)

SetFlags sets the output flags for the logger.

func (*Logger) SetOutputLevel

func (l *Logger) SetOutputLevel(lvl int)

SetOutputLevel sets the output level for the logger.

func (*Logger) SetPrefix

func (l *Logger) SetPrefix(prefix string)

SetPrefix sets the output prefix for the logger.

func (*Logger) SingleStack

func (l *Logger) SingleStack(v ...interface{})

SingleStack prints a stack trace of the calling goroutines.

func (*Logger) Stack

func (l *Logger) Stack(v ...interface{})

Stack prints a stack trace of all goroutines.

func (*Logger) Stat

func (l *Logger) Stat() (stats []int64)

Stat func.

func (*Logger) Warn

func (l *Logger) Warn(v ...interface{})

Warn prints a warning information.

func (*Logger) Warnf

func (l *Logger) Warnf(format string, v ...interface{})

Warnf prints a warning information.

Jump to

Keyboard shortcuts

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