README
¶
log - Flexible Logging for Go
Setup logging with SetupLogging():
- Type: logging mode to use - file, syslog, console
- Level: debug, info, error, etc. (See all levels below.)
- Facility: syslog facility to log to - daemon, misc, etc.
- File: path to log to file if in file mode.
e.g.:
log.SetupLogging(log.LogConfig{
Type: "console",
Level: "warning"
})
If logging is not setup, then the messages will simply go to
stdout. If logging cannot be setup for file or syslog, then
the default stdout will be used. An error message will print to
stderr to notify you if this occurs.
The following log levels are defined, in decreasing verbosity / increasing criticality:
- Debug
- Info
- Notice
- Warn
- Error
- Crit
- Alert
- Emerg
Usage
Usage is the same as Sprintf/Printf statements - simply append
an f to the desired level. e.g.:
dbug_mesg := "This isn't a bug."
log.Debugf("I really need to know this in debug mode: %s", msg)
Contributing
- Fork the repo
- Write your code in a feature branch
- Create a new Pull Request
Documentation
¶
Overview ¶
Daemons need to log. This package makes that easy, allowing you to configure logging to syslog, a file, or console (stdout), with syslog style log levels.
Since this logging mechanism supports non-syslog output, filtering based on log levels is done in-application, so you'll want to accept debug messages and above in syslog configs.
Simply call SetupLogging(), passing it a reference to a LogConfig struct and start logging! If you happen to log something prior to setting up logging, messages will print to stderr.
Index ¶
- func Alertf(msg string, args ...interface{})
- func Critf(msg string, args ...interface{})
- func Debugf(msg string, args ...interface{})
- func Emergf(msg string, args ...interface{})
- func Errorf(msg string, args ...interface{})
- func Infof(msg string, args ...interface{})
- func IsAlert() bool
- func IsCritical() bool
- func IsDebug() bool
- func IsEmergency() bool
- func IsError() bool
- func IsInfo() bool
- func IsNotice() bool
- func IsTrace() bool
- func IsWarning() bool
- func LogLevel() syslog.Priority
- func Noticef(msg string, args ...interface{})
- func SetupLogging(cfg LogConfig)
- func Tracef(msg string, args ...interface{})
- func Warnf(msg string, args ...interface{})
- type LogConfig
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Alertf ¶
func Alertf(msg string, args ...interface{})
Logs a formatted Alert message. Supports fmt.Sprintf style arguments.
func Critf ¶
func Critf(msg string, args ...interface{})
Logs a formatted Crit message. Supports fmt.Sprintf style arguments.
func Debugf ¶
func Debugf(msg string, args ...interface{})
Logs a formatted Debug message. Supports fmt.Sprintf style arguments.
func Emergf ¶
func Emergf(msg string, args ...interface{})
Logs a formatted Emerg message. Supports fmt.Sprintf style arguments.
func Errorf ¶
func Errorf(msg string, args ...interface{})
Logs a formatted Error message. Supports fmt.Sprintf style arguments.
func Infof ¶
func Infof(msg string, args ...interface{})
Logs a formatted Info message. Supports fmt.Sprintf style arguments.
func Noticef ¶
func Noticef(msg string, args ...interface{})
Logs a formatted Notice message. Supports fmt.Sprintf style arguments.
func SetupLogging ¶
func SetupLogging(cfg LogConfig)
Source Files