log

Documentation

Index

• Variables
• func Critf(format string, rest ...interface{})
• func Debugf(format string, rest ...interface{})
• func Errf(format string, rest ...interface{})
• func Fatalf(format string, rest ...interface{})
• func Infof(format string, rest ...interface{})
• func Log(lvl Level) bool
• func LogDebug() bool
• func LogVerbose() bool
• func LogVf(format string, rest ...interface{})
• func Logf(lvl Level, format string, rest ...interface{})
• func SetFlagDefaultsForClientTools()
• func SetFlags(f int)
• func SetOutput(w io.Writer)
• func Warnf(format string, rest ...interface{})
• type Level
  • func GetLogLevel() Level
  • func LevelByName(str string) Level
  • func SetLogLevel(lvl Level) Level
  • func SetLogLevelQuiet(lvl Level) Level
  • func ValidateLevel(str string) (Level, error)
  • func (l Level) String() string
• type LoggerI
  • func Logger() LoggerI

Variables

var (

	// LogPrefix is a prefix to include in each log line.
	LogPrefix = flag.String("logprefix", "> ", "Prefix to log lines before logged messages")
	// LogFileAndLine determines if the log lines will contain caller file name and line number.
	LogFileAndLine = flag.Bool("logcaller", true, "Logs filename and line number of callers to log")
)

Functions

func Critf

func Critf(format string, rest ...interface{})

Critf logs if Warning level is on.

func Debugf

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

Debugf logs if Debug level is on.

func Errf

func Errf(format string, rest ...interface{})

Errf logs if Warning level is on.

func Fatalf

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

Fatalf logs if Warning level is on.

func Infof

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

Infof logs if Info level is on.

func Log

func Log(lvl Level) bool

Log returns true if a given level is currently logged.

func LogDebug

func LogDebug() bool

LogDebug shortcut for fortio.Log(fortio.Debug).

func LogVerbose

func LogVerbose() bool

LogVerbose shortcut for fortio.Log(fortio.Verbose).

func LogVf

func LogVf(format string, rest ...interface{})

LogVf logs if Verbose level is on.

func Logf

func Logf(lvl Level, format string, rest ...interface{})

Logf logs with format at the given level. 2 level of calls so it's always same depth for extracting caller file/line.

func SetFlagDefaultsForClientTools

func SetFlagDefaultsForClientTools()

SetFlagDefaultsForClientTools changes the default value of -logprefix and -logcaller to make output without caller and prefix, a default more suitable for command line tools (like dnsping). Needs to be called before flag.Parse().

func SetFlags

func SetFlags(f int)

SetFlags forwards flags to the system logger.

func SetOutput

func SetOutput(w io.Writer)

SetOutput sets the output to a different writer (forwards to system logger).

func Warnf

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

Warnf logs if Warning level is on.

Types

type Level

type Level int32

Level is the level of logging (0 Debug -> 6 Fatal).

const (
	Debug Level = iota
	Verbose
	Info
	Warning
	Error
	Critical
	Fatal
)

Log levels. Go can't have variable and function of the same name so we keep medium length (Dbg,Info,Warn,Err,Crit,Fatal) names for the functions.

func GetLogLevel

func GetLogLevel() Level

GetLogLevel returns the currently configured LogLevel.

func LevelByName

func LevelByName(str string) Level

LevelByName returns the LogLevel by its name.

func SetLogLevel

func SetLogLevel(lvl Level) Level

SetLogLevel sets the log level and returns the previous one.

func SetLogLevelQuiet

func SetLogLevelQuiet(lvl Level) Level

SetLogLevelQuiet sets the log level and returns the previous one but does not log the change of level itself.

func ValidateLevel

func ValidateLevel(str string) (Level, error)

ValidateLevel returns error if the level string is not valid.

func (Level) String

func (l Level) String() string

String returns the string representation of the level.

type LoggerI

type LoggerI interface {
	Printf(format string, rest ...interface{})
}

LoggerI defines a log.Logger like interface for simple logging.

func Logger

func Logger() LoggerI

Logger returns a LoggerI (standard logger compatible) that can be used for simple logging.