README
¶
Log
Fortio's log is simple logger built on top of go's default one with additional opinionated levels similar to glog but simpler to use and configure.
It's been used for many years for Fortio's org Fortio project and more (under fortio.org/fortio/log package) but split out recently for standalone use, with the "flag polution" limited (as a library it doesn't include the flags, you configure it using apis).
// On a cli tool (avoids file name and line numbers, stack traces on log.Fatalf etc)
log.SetDefaultsForClientTools()
log.LoggerStaticFlagSetup() // adds -loglevel flag to configure
// Or on a server type, import fortio.org/dflag, then:
dflag.LoggerFlagSetup()
// Then, printf style leveled logging:
log.Debugf(...) // Debug level
log.LogVf(...) // Verbose level
log.Infof(...) // Info/default level
log.Warnf(...) // Warning level
log.Errf(...) // Error level
log.Critf(...) // Critical level (always logged even if level is set to max)
log.Fatalf(...) // Fatal level - program will panic/exit
// for http servers there is also
// access log type including user-agent, forwarded ip/proto (behind load balancer case),
// TLS crypto used
log.LogRequest(r, "some info")
See the Config object for options like whether to include line number and file name of caller or not etc
Documentation
¶
Overview ¶
Fortio's log is simple logger built on top of go's default one with additional opinionated levels similar to glog but simpler to use and configure.
See Config object for options like whether to include line number and file name of caller or not etc
Index ¶
- Variables
- func Critf(format string, rest ...interface{})
- func Debugf(format string, rest ...interface{})
- func Errf(format string, rest ...interface{})
- func FErrf(format string, rest ...interface{}) int
- func Fatalf(format string, rest ...interface{})
- func Infof(format string, rest ...interface{})
- func Log(lvl Level) bool
- func LogDebug() bool
- func LogRequest(r *http.Request, msg string)
- func LogVerbose() bool
- func LogVf(format string, rest ...interface{})
- func Logf(lvl Level, format string, rest ...interface{})
- func LoggerStaticFlagSetup(names ...string)
- func Printf(format string, rest ...interface{})
- func SetDefaultsForClientTools()
- func SetFlags(f int)
- func SetLogLevelStr(str string) error
- func SetOutput(w io.Writer)
- func TLSInfo(r *http.Request) string
- func Warnf(format string, rest ...interface{})
- type Level
- type LogConfig
- type LoggerI
Constants ¶
This section is empty.
Variables ¶
var ( Config = DefaultConfig() // Used for dynamic flag setting as strings and validation. LevelToStrA []string )
Functions ¶
func FErrf ¶
FErrF logs a fatal error and returns 1. meant for cli main functions written like:
func main() { os.Exit(Main()) }
and in Main() they can do:
if err != nil {
return log.FErrf("error: %v", err)
}
so they can be tested with testscript. See https://github.com/fortio/delta/ for an example.
func Fatalf ¶
func Fatalf(format string, rest ...interface{})
Fatalf logs if Warning level is on and panics or exits.
func LogRequest ¶ added in v1.1.0
LogRequest logs the incoming request, including headers when loglevel is verbose.
func Logf ¶
Logf logs with format at the given level. 2 level of calls so it's always same depth for extracting caller file/line. Note that log.Logf(Fatal, "...") will not panic or exit, only log.Fatalf() does.
func LoggerStaticFlagSetup ¶ added in v1.2.0
func LoggerStaticFlagSetup(names ...string)
LoggerStaticFlagSetup call to setup a static flag under the passed name or `-loglevel` by default, to set the log level. Use https://pkg.golang.ir/fortio.org/dflag/dynloglevel#LoggerFlagSetup for a dynamic flag instead.
func Printf ¶
func Printf(format string, rest ...interface{})
Printf forwards to the underlying go logger to print (with only timestamp prefixing).
func SetDefaultsForClientTools ¶
func SetDefaultsForClientTools()
SetDefaultsForClientTools changes the default value of LogPrefix and LogFileAndLine to make output without caller and prefix, a default more suitable for command line tools (like dnsping). Needs to be called before flag.Parse(). Caller could also use log.Printf instead of changing this if not wanting to use levels. Also makes log.Fatalf just exit instead of panic.
func SetLogLevelStr ¶
Sets level from string (called by dflags). Use https://pkg.golang.ir/fortio.org/dflag/dynloglevel#LoggerFlagSetup to set up `-loglevel` as a dynamic flag (or an example of how this function is used).
Types ¶
type Level ¶
type Level int32
Level is the level of logging (0 Debug -> 6 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 SetLogLevel ¶
SetLogLevel sets the log level and returns the previous one.
func SetLogLevelQuiet ¶
SetLogLevelQuiet sets the log level and returns the previous one but does not log the change of level itself.
func ValidateLevel ¶
ValidateLevel returns error if the level string is not valid.
type LogConfig ¶
type LogConfig struct {
LogPrefix string // "Prefix to log lines before logged messages
LogFileAndLine bool // Logs filename and line number of callers to log.
FatalPanics bool // If true, log.Fatalf will panic (stack trace) instead of just exit 1
FatalExit func(int) // Function to call upon log.Fatalf. e.g. os.Exit.
}
func DefaultConfig ¶
func DefaultConfig() *LogConfig
DefaultConfig() returns the default initial configuration for the logger, best suited for servers. It will log caller file and line number, use a prefix to split line info from the message and panic (+exit) on Fatal.
Source Files