-
Notifications
You must be signed in to change notification settings - Fork 1
/
logger.go
73 lines (67 loc) · 2.67 KB
/
logger.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
package logger
import (
"time"
)
// Level is the type for different log levels
type Level int
// Levels have the same value as syslog, hence 5 is skipped
const (
// DebugLevel defines debug log level.
DebugLevel Level = 7
// InfoLevel defines info log level.
InfoLevel = 6
// WarnLevel defines warn log level.
WarnLevel = 4
// ErrorLevel defines error log level.
ErrorLevel = 3
// FatalLevel defines fatal log level.
FatalLevel = 2
// PanicLevel defines panic log level.
PanicLevel = 1
)
// Logger is an standard interface for logging so that different log implementations can be wrapped around.
// The API is heavily influenced by the zerolog API for structured JSON logging
type Logger interface {
// WithField returns a new Logger that always logs the specified field
WithField(key, value string) Logger
// Level creates a new Entry with the specified Level
Level(Level) Entry
// Debug creates a new Entry with level Debug
Debug() Entry
// Info creates a new Entry with level Info
Info() Entry
// Warn creates a new Entry with level Warn
Warn() Entry
// Error creates a new Entry with level Error
Error() Entry
// Fatal creates a new Entry with level Fatal. Executing a log at fatal level exits the application with exit code 1.
Fatal() Entry
// Panic creates a new Entry with level Panic. Executing a log at panic level will call panic().
Panic() Entry
}
// Entry is an interface for a log entry. A single entry always has defined a log level. Custom fields can be
// added. An entry will never be written to the log unless Flush is called.
type Entry interface {
// Flush writes the entry as a single log statement. Optionally, a message can be added which will
// be included in the final log entry
Flush(string)
// AddFields adds a range of fields to the log statement
AddFields(map[string]interface{}) Entry
// AddErr adds an error to the log statement. The error will have the key "err". An error stack will be included
// under the key "err_stack"
AddErr(err error) Entry
// AddError adds an error to the log statement. An error stack will be included under the key "${key}_stack"
AddError(key string, val error) Entry
// AddBool adds a bool value to the log statement.
AddBool(key string, val bool) Entry
// AddInt adds an integer value to the log statement.
AddInt(key string, val int) Entry
// AddStr adds a string value to the log statement.
AddStr(key string, val string) Entry
// AddTime adds a time value to the log statement.
AddTime(key string, val time.Time) Entry
// AddDur adds a duration value to the log statement.
AddDur(key string, val time.Duration) Entry
// AddAny adds any value to the log statement.
AddAny(key string, val interface{}) Entry
}