12
// LogFunction For big messages, it can be more efficient to pass a function
13
// and only call it if the log level is actually enables rather than
14
// generating the log message and then checking if the level is enabled
15
type LogFunction func() []interface{}
18
// The logs are `io.Copy`'d to this in a mutex. It's common to set this to a
19
// file, or leave it default which is `os.Stderr`. You can also set this to
20
// something more adventurous, such as logging to Kafka.
22
// Hooks for the logger instance. These allow firing events based on logging
23
// levels and log entries. For example, to send errors to an error tracking
24
// service, log to StatsD or dump the core on fatal errors.
26
// All log entries pass through the formatter before logged to Out. The
27
// included formatters are `TextFormatter` and `JSONFormatter` for which
28
// TextFormatter is the default. In development (when a TTY is attached) it
29
// logs with colors, but to a file it wouldn't. You can easily implement your
30
// own that implements the `Formatter` interface, see the `README` or included
31
// formatters for examples.
34
// Flag for whether to log caller info (off by default)
37
// The logging level the logger should log at. This is typically (and defaults
38
// to) `logrus.Info`, which allows Info(), Warn(), Error() and Fatal() to be
41
// Used to sync writing to the log. Locking is enabled by Default
43
// Reusable empty entry
45
// Function to exit the application, defaults to `os.Exit()`
49
type exitFunc func(int)
51
type MutexWrap struct {
56
func (mw *MutexWrap) Lock() {
62
func (mw *MutexWrap) Unlock() {
68
func (mw *MutexWrap) Disable() {
72
// Creates a new logger. Configuration should be set by changing `Formatter`,
73
// `Out` and `Hooks` directly on the default logger instance. You can also just
74
// instantiate your own:
76
// var log = &logrus.Logger{
78
// Formatter: new(logrus.TextFormatter),
79
// Hooks: make(logrus.LevelHooks),
80
// Level: logrus.DebugLevel,
83
// It's recommended to make this a global instance called `log`.
87
Formatter: new(TextFormatter),
88
Hooks: make(LevelHooks),
95
func (logger *Logger) newEntry() *Entry {
96
entry, ok := logger.entryPool.Get().(*Entry)
100
return NewEntry(logger)
103
func (logger *Logger) releaseEntry(entry *Entry) {
104
entry.Data = map[string]interface{}{}
105
logger.entryPool.Put(entry)
108
// WithField allocates a new entry and adds a field to it.
109
// Debug, Print, Info, Warn, Error, Fatal or Panic must be then applied to
110
// this new returned entry.
111
// If you want multiple fields, use `WithFields`.
112
func (logger *Logger) WithField(key string, value interface{}) *Entry {
113
entry := logger.newEntry()
114
defer logger.releaseEntry(entry)
115
return entry.WithField(key, value)
118
// Adds a struct of fields to the log entry. All it does is call `WithField` for
120
func (logger *Logger) WithFields(fields Fields) *Entry {
121
entry := logger.newEntry()
122
defer logger.releaseEntry(entry)
123
return entry.WithFields(fields)
126
// Add an error as single field to the log entry. All it does is call
127
// `WithError` for the given `error`.
128
func (logger *Logger) WithError(err error) *Entry {
129
entry := logger.newEntry()
130
defer logger.releaseEntry(entry)
131
return entry.WithError(err)
134
// Add a context to the log entry.
135
func (logger *Logger) WithContext(ctx context.Context) *Entry {
136
entry := logger.newEntry()
137
defer logger.releaseEntry(entry)
138
return entry.WithContext(ctx)
141
// Overrides the time of the log entry.
142
func (logger *Logger) WithTime(t time.Time) *Entry {
143
entry := logger.newEntry()
144
defer logger.releaseEntry(entry)
145
return entry.WithTime(t)
148
func (logger *Logger) Logf(level Level, format string, args ...interface{}) {
149
if logger.IsLevelEnabled(level) {
150
entry := logger.newEntry()
151
entry.Logf(level, format, args...)
152
logger.releaseEntry(entry)
156
func (logger *Logger) Tracef(format string, args ...interface{}) {
157
logger.Logf(TraceLevel, format, args...)
160
func (logger *Logger) Debugf(format string, args ...interface{}) {
161
logger.Logf(DebugLevel, format, args...)
164
func (logger *Logger) Infof(format string, args ...interface{}) {
165
logger.Logf(InfoLevel, format, args...)
168
func (logger *Logger) Printf(format string, args ...interface{}) {
169
entry := logger.newEntry()
170
entry.Printf(format, args...)
171
logger.releaseEntry(entry)
174
func (logger *Logger) Warnf(format string, args ...interface{}) {
175
logger.Logf(WarnLevel, format, args...)
178
func (logger *Logger) Warningf(format string, args ...interface{}) {
179
logger.Warnf(format, args...)
182
func (logger *Logger) Errorf(format string, args ...interface{}) {
183
logger.Logf(ErrorLevel, format, args...)
186
func (logger *Logger) Fatalf(format string, args ...interface{}) {
187
logger.Logf(FatalLevel, format, args...)
191
func (logger *Logger) Panicf(format string, args ...interface{}) {
192
logger.Logf(PanicLevel, format, args...)
195
func (logger *Logger) Log(level Level, args ...interface{}) {
196
if logger.IsLevelEnabled(level) {
197
entry := logger.newEntry()
198
entry.Log(level, args...)
199
logger.releaseEntry(entry)
203
func (logger *Logger) LogFn(level Level, fn LogFunction) {
204
if logger.IsLevelEnabled(level) {
205
entry := logger.newEntry()
206
entry.Log(level, fn()...)
207
logger.releaseEntry(entry)
211
func (logger *Logger) Trace(args ...interface{}) {
212
logger.Log(TraceLevel, args...)
215
func (logger *Logger) Debug(args ...interface{}) {
216
logger.Log(DebugLevel, args...)
219
func (logger *Logger) Info(args ...interface{}) {
220
logger.Log(InfoLevel, args...)
223
func (logger *Logger) Print(args ...interface{}) {
224
entry := logger.newEntry()
226
logger.releaseEntry(entry)
229
func (logger *Logger) Warn(args ...interface{}) {
230
logger.Log(WarnLevel, args...)
233
func (logger *Logger) Warning(args ...interface{}) {
237
func (logger *Logger) Error(args ...interface{}) {
238
logger.Log(ErrorLevel, args...)
241
func (logger *Logger) Fatal(args ...interface{}) {
242
logger.Log(FatalLevel, args...)
246
func (logger *Logger) Panic(args ...interface{}) {
247
logger.Log(PanicLevel, args...)
250
func (logger *Logger) TraceFn(fn LogFunction) {
251
logger.LogFn(TraceLevel, fn)
254
func (logger *Logger) DebugFn(fn LogFunction) {
255
logger.LogFn(DebugLevel, fn)
258
func (logger *Logger) InfoFn(fn LogFunction) {
259
logger.LogFn(InfoLevel, fn)
262
func (logger *Logger) PrintFn(fn LogFunction) {
263
entry := logger.newEntry()
265
logger.releaseEntry(entry)
268
func (logger *Logger) WarnFn(fn LogFunction) {
269
logger.LogFn(WarnLevel, fn)
272
func (logger *Logger) WarningFn(fn LogFunction) {
276
func (logger *Logger) ErrorFn(fn LogFunction) {
277
logger.LogFn(ErrorLevel, fn)
280
func (logger *Logger) FatalFn(fn LogFunction) {
281
logger.LogFn(FatalLevel, fn)
285
func (logger *Logger) PanicFn(fn LogFunction) {
286
logger.LogFn(PanicLevel, fn)
289
func (logger *Logger) Logln(level Level, args ...interface{}) {
290
if logger.IsLevelEnabled(level) {
291
entry := logger.newEntry()
292
entry.Logln(level, args...)
293
logger.releaseEntry(entry)
297
func (logger *Logger) Traceln(args ...interface{}) {
298
logger.Logln(TraceLevel, args...)
301
func (logger *Logger) Debugln(args ...interface{}) {
302
logger.Logln(DebugLevel, args...)
305
func (logger *Logger) Infoln(args ...interface{}) {
306
logger.Logln(InfoLevel, args...)
309
func (logger *Logger) Println(args ...interface{}) {
310
entry := logger.newEntry()
311
entry.Println(args...)
312
logger.releaseEntry(entry)
315
func (logger *Logger) Warnln(args ...interface{}) {
316
logger.Logln(WarnLevel, args...)
319
func (logger *Logger) Warningln(args ...interface{}) {
320
logger.Warnln(args...)
323
func (logger *Logger) Errorln(args ...interface{}) {
324
logger.Logln(ErrorLevel, args...)
327
func (logger *Logger) Fatalln(args ...interface{}) {
328
logger.Logln(FatalLevel, args...)
332
func (logger *Logger) Panicln(args ...interface{}) {
333
logger.Logln(PanicLevel, args...)
336
func (logger *Logger) Exit(code int) {
338
if logger.ExitFunc == nil {
339
logger.ExitFunc = os.Exit
341
logger.ExitFunc(code)
344
//When file is opened with appending mode, it's safe to
345
//write concurrently to a file (within 4k message on Linux).
346
//In these cases user can choose to disable the lock.
347
func (logger *Logger) SetNoLock() {
351
func (logger *Logger) level() Level {
352
return Level(atomic.LoadUint32((*uint32)(&logger.Level)))
355
// SetLevel sets the logger level.
356
func (logger *Logger) SetLevel(level Level) {
357
atomic.StoreUint32((*uint32)(&logger.Level), uint32(level))
360
// GetLevel returns the logger level.
361
func (logger *Logger) GetLevel() Level {
362
return logger.level()
365
// AddHook adds a hook to the logger hooks.
366
func (logger *Logger) AddHook(hook Hook) {
368
defer logger.mu.Unlock()
369
logger.Hooks.Add(hook)
372
// IsLevelEnabled checks if the log level of the logger is greater than the level param
373
func (logger *Logger) IsLevelEnabled(level Level) bool {
374
return logger.level() >= level
377
// SetFormatter sets the logger formatter.
378
func (logger *Logger) SetFormatter(formatter Formatter) {
380
defer logger.mu.Unlock()
381
logger.Formatter = formatter
384
// SetOutput sets the logger output.
385
func (logger *Logger) SetOutput(output io.Writer) {
387
defer logger.mu.Unlock()
391
func (logger *Logger) SetReportCaller(reportCaller bool) {
393
defer logger.mu.Unlock()
394
logger.ReportCaller = reportCaller
397
// ReplaceHooks replaces the logger hooks and returns the old ones
398
func (logger *Logger) ReplaceHooks(hooks LevelHooks) LevelHooks {
400
oldHooks := logger.Hooks