README
¶
log
Go logging library used at Mailgun.
Usage
Define a logging configuration in a YAML config file. Currently "console" and "syslog" loggers are supported (you can omit one or another):
logging:
- name: console
- name: syslog
Logging config can be built into your program's config struct:
import "github.com/mailgun/log"
type Config struct {
// some program-specific configuration
// logging configuration
Logging []*log.LogConfig
}
After config parsing, initialize the logging library:
import (
"github.com/mailgun/cfg"
"github.com/mailgun/log"
)
func main() {
conf := Config{}
// parse config with logging configuration
cfg.LoadConfig("path/to/config.yaml", &conf)
// init the logging package
log.Init(conf.Logging)
}
Documentation
¶
Index ¶
- func Errorf(format string, args ...interface{})
- func Fatalf(format string, args ...interface{})
- func Infof(format string, args ...interface{})
- func Init(logConfigs []*LogConfig) error
- func Initialize(name, severity string) error
- func SetSeverity(s Severity)
- func Warningf(format string, args ...interface{})
- type LogConfig
- type Logger
- type Severity
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Errorf ¶
func Errorf(format string, args ...interface{})
Errorf logs to the ERROR, WARNING, and INFO logs.
func Fatalf ¶
func Fatalf(format string, args ...interface{})
Fatalf logs to the FATAL, ERROR, WARNING, and INFO logs, including a stack trace of all running goroutines, then calls os.Exit(255).
func Initialize ¶
func SetSeverity ¶
func SetSeverity(s Severity)
SetSeverity sets current logging severity. Acceptable values are SeverityInfo, SeverityWarn, SeverityError, SeverityFatal
Types ¶
type LogConfig ¶
type LogConfig struct {
Name string
}
Logging configuration to be passed to all loggers during initialization.
type Logger ¶
type Logger interface {
Infof(format string, args ...interface{})
Warningf(format string, args ...interface{})
Errorf(format string, args ...interface{})
Fatalf(format string, args ...interface{})
Writer(Severity) io.Writer
}
Logger is a unified interface for all loggers.
Source Files