Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security Policy
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

logging

package module

Go to main page

Versions in this module

v0

v0.2.5

May 22, 2015

Changes in this version

+ var FileModeNameToValues = map[string]int

+ var SyslogNameToPriorities = map[string]syslog.Priority

+ func ApplyConfigFile(file string) error

+ func ApplyJsonConfigFile(file string) error

+ func ApplyYAMLConfigFile(file string) error

+ func ConfigFilters(m ConfMap, i Filterer, env *ConfEnv) error

+ func ConfigFormatters(m ConfMap, i SetFormatterable, env *ConfEnv) error

+ func ConfigHandlers(m ConfMap, i AddHandlerable, env *ConfEnv) error

+ func ConfigLevel(m ConfMap, i SetLevelable) error

+ func ConfigLogger(m ConfMap, logger Logger, isRoot bool, env *ConfEnv) error

+ func DictConfig(conf *Conf) error

+ type AddHandlerable interface

+ AddHandler func(handler Handler)

+ type Conf struct

+ Filters map[string]ConfFilter

+ Formatters map[string]ConfFormatter

+ Handlers map[string]ConfMap

+ Loggers map[string]ConfMap

+ Root ConfMap

+ Version int

+ type ConfEnv struct

+ func NewConfigEnv() *ConfEnv

+ type ConfFilter struct

+ Name string

+ type ConfFormatter struct

+ DateFormat *string

+ Format *string

+ type ConfMap map[string]interface

+ func (self ConfMap) GetBool(key string) (bool, error)

+ func (self ConfMap) GetInt(key string) (int, error)

+ func (self ConfMap) GetString(key string) (string, error)

+ func (self ConfMap) GetUint16(key string) (uint16, error)

+ func (self ConfMap) GetUint32(key string) (uint32, error)

+ func (self ConfMap) GetUint64(key string) (uint64, error)

+ type DatagramHandler struct

+ func NewDatagramHandler(host string, port uint16) *DatagramHandler

+ type SetFormatterable interface

+ SetFormatter func(formatter Formatter)

+ type SetLevelable interface

+ SetLevel func(level LogLevelType) error

v0.2.1

May 21, 2015

Changes in this version

+ const Day

+ const DefaultTimedRotatingFileMode

+ const SocketDefaultDelay

+ const SocketDefaultMaxDeadline

+ const SocketDefaultTimeout

+ const ThriftDefaultTimeout

+ const UnlimitedDeadline

+ const UnlimitedDelay

+ const Week

+ var ErrorInvalidFormat = errors.New("invalid format")

+ var ForceRetryError error = errors.New("force to retry")

+ var RetryFailedError = errors.New("retry failed")

+ func FileExists(filename string) bool

+ func IsNil(i interface{}) bool

+ func IsNotNil(i interface{}) bool

+ func Min(a, b int64) int64

+ func RandIntN(n int) int

+ type BaseBufferingHandler struct

+ func NewBaseBufferingHandler(capacity uint64) *BaseBufferingHandler

+ func (self *BaseBufferingHandler) Close()

+ func (self *BaseBufferingHandler) Emit2(handler BufferingHandler, record *LogRecord) error

+ func (self *BaseBufferingHandler) Flush() error

+ func (self *BaseBufferingHandler) GetBuffer() *list.List

+ func (self *BaseBufferingHandler) ShouldFlush(_ *LogRecord) bool

+ type BaseRotatingHandler struct

+ func NewBaseRotatingHandler(filepath string, mode int) (*BaseRotatingHandler, error)

+ func (self *BaseRotatingHandler) RolloverEmit(handler RotatingHandler, record *LogRecord) error

+ type BoundedExponentialBackoffRetry struct

+ func NewBoundedExponentialBackoffRetry(sleepFunc func(time.Duration), maxTries uint32, baseSleepTime time.Duration, ...) *BoundedExponentialBackoffRetry

+ func (self *BoundedExponentialBackoffRetry) Do(fn func() error) error

+ type BufferingHandler interface

+ ShouldFlush func(record *LogRecord) bool

+ type ErrorRetry struct

+ func NewErrorRetry() *ErrorRetry

+ func (self *ErrorRetry) Backoff(backoff uint32) *ErrorRetry

+ func (self *ErrorRetry) Copy() *ErrorRetry

+ func (self *ErrorRetry) Deadline(deadline time.Duration) *ErrorRetry

+ func (self *ErrorRetry) Delay(delay time.Duration) *ErrorRetry

+ func (self *ErrorRetry) Do(fn func() error) error

+ func (self *ErrorRetry) MaxDelay(maxDelay time.Duration) *ErrorRetry

+ func (self *ErrorRetry) MaxJitter(maxJitter float32) *ErrorRetry

+ func (self *ErrorRetry) MaxTries(maxTries int) *ErrorRetry

+ func (self *ErrorRetry) OnError(err error) *ErrorRetry

+ func (self *ErrorRetry) SleepFunc(fn func(time.Duration)) *ErrorRetry

+ type ExponentialBackoffRetry struct

+ func NewExponentialBackoffRetry(sleepFunc func(time.Duration), baseSleepTime time.Duration, ...) *ExponentialBackoffRetry

+ func (self *ExponentialBackoffRetry) Do(fn func() error) error

+ type FileHandler struct

+ func NewFileHandler(filename string, mode int) (*FileHandler, error)

+ func (self *FileHandler) Close()

+ func (self *FileHandler) Emit(record *LogRecord) error

+ func (self *FileHandler) GetFilePath() string

+ func (self *FileHandler) Handle(record *LogRecord) int

+ func (self *FileHandler) Open() error

+ type FileStream struct

+ File *os.File

+ func (self *FileStream) Close() error

+ func (self *FileStream) Flush() error

+ func (self *FileStream) Tell() (int64, error)

+ func (self *FileStream) Write(s string) error

+ type MemoryHandler struct

+ func NewMemoryHandler(capacity uint64, flushLevel LogLevelType, target Handler) *MemoryHandler

+ func (self *MemoryHandler) Close()

+ func (self *MemoryHandler) Emit(record *LogRecord) error

+ func (self *MemoryHandler) Flush() error

+ func (self *MemoryHandler) Handle(record *LogRecord) int

+ func (self *MemoryHandler) SetTarget(target Handler)

+ func (self *MemoryHandler) ShouldFlush(record *LogRecord) bool

+ type NTimesRetry struct

+ func NewNTimesRetry(sleepFunc func(time.Duration), maxTimes uint32, ...) *NTimesRetry

+ func (self *NTimesRetry) Do(fn func() error) error

+ type NullHandler struct

+ func NewNullHandler() *NullHandler

+ func (self *NullHandler) Emit(_ *LogRecord) error

+ func (self *NullHandler) Handle(_ *LogRecord) int

+ type OnceRetry struct

+ func NewOnceRetry(sleepFunc func(time.Duration), sleepTimeBetweenRetries time.Duration) *OnceRetry

+ type Retry interface

+ Do func(func() error) error

+ type RotatingFileHandler struct

+ func MustNewRotatingFileHandler(filepath string, mode int, maxByte uint64, backupCount uint32) *RotatingFileHandler

+ func NewRotatingFileHandler(filepath string, mode int, maxByte uint64, backupCount uint32) (*RotatingFileHandler, error)

+ func (self *RotatingFileHandler) DoRollover() (err error)

+ func (self *RotatingFileHandler) Emit(record *LogRecord) error

+ func (self *RotatingFileHandler) Handle(record *LogRecord) int

+ func (self *RotatingFileHandler) RotateFile(sourceFile, destFile string) error

+ func (self *RotatingFileHandler) ShouldRollover(record *LogRecord) (bool, string)

+ type RotatingHandler interface

+ DoRollover func() error

+ ShouldRollover func(record *LogRecord) (doRollover bool, message string)

+ type SocketHandler struct

+ func NewSocketHandler(host string, port uint16) *SocketHandler

+ func (self *SocketHandler) Close()

+ func (self *SocketHandler) Emit(record *LogRecord) error

+ func (self *SocketHandler) Handle(record *LogRecord) int

+ func (self *SocketHandler) HandleError(record *LogRecord, err error)

+ func (self *SocketHandler) Marshal(record *LogRecord) ([]byte, error)

+ func (self *SocketHandler) Send(bin []byte) error

+ type SocketLogRecord struct

+ AscTime *string

+ CreatedTime time.Time

+ FileName *string

+ Format *string

+ FuncName *string

+ Level LogLevelType

+ LineNo uint32

+ Message *string

+ Name *string

+ PathName *string

+ UseFormat bool

+ type StdoutHandler struct

+ func NewStdoutHandler() *StdoutHandler

+ func (self *StdoutHandler) Close()

+ func (self *StdoutHandler) Emit(record *LogRecord) error

+ func (self *StdoutHandler) Handle(record *LogRecord) int

+ type StdoutStream struct

+ func NewStdoutStream() *StdoutStream

+ func (self *StdoutStream) Close() error

+ func (self *StdoutStream) Flush() error

+ func (self *StdoutStream) Tell() (int64, error)

+ func (self *StdoutStream) Write(s string) error

+ type Stream interface

+ Close func() error

+ Flush func() error

+ Tell func() (offset int64, err error)

+ Write func(s string) error

+ type StreamHandler struct

+ func NewStreamHandler(name string, level LogLevelType, stream Stream) *StreamHandler

+ func (self *StreamHandler) Close2()

+ func (self *StreamHandler) Emit(record *LogRecord) error

+ func (self *StreamHandler) Emit2(handler Handler, record *LogRecord) error

+ func (self *StreamHandler) Flush() error

+ func (self *StreamHandler) GetStream() Stream

+ func (self *StreamHandler) Handle(record *LogRecord) int

+ func (self *StreamHandler) SetStream(s Stream)

+ type SyslogHandler struct

+ func NewSyslogHandler(priority syslog.Priority, tag string) (*SyslogHandler, error)

+ func NewSyslogHandlerToAddr(network, raddr string, priority syslog.Priority, tag string) (*SyslogHandler, error)

+ func (self *SyslogHandler) Close()

+ func (self *SyslogHandler) Emit(record *LogRecord) error

+ func (self *SyslogHandler) Flush() error

+ func (self *SyslogHandler) Handle(record *LogRecord) int

+ type ThriftHandler struct

+ func NewThriftHandler(host string, port uint16) *ThriftHandler

+ func (self *ThriftHandler) Close()

+ func (self *ThriftHandler) Emit(record *LogRecord) error

+ func (self *ThriftHandler) Handle(record *LogRecord) int

+ func (self *ThriftHandler) HandleError(record *LogRecord, err error)

+ type TimedRotatingFileHandler struct

+ func NewTimedRotatingFileHandler(filepath string, when string, interval uint32, backupCount uint32, utc bool) (*TimedRotatingFileHandler, error)

+ func (self *TimedRotatingFileHandler) DoRollover() (err error)

+ func (self *TimedRotatingFileHandler) Emit(record *LogRecord) error

+ func (self *TimedRotatingFileHandler) Handle(record *LogRecord) int

+ func (self *TimedRotatingFileHandler) ShouldRollover(record *LogRecord) (bool, string)

+ type UntilElapsedRetry struct

+ func NewUntilElapsedRetry(sleepFunc func(time.Duration), sleepTimeBetweenRetries time.Duration, ...) *UntilElapsedRetry

+ func (self *UntilElapsedRetry) Do(fn func() error) error

v0.1.0

May 7, 2015

Changes in this version

+ var ErrorNoSuchLevel = errors.New("no such level")

+ var UnknownCallerInfo = &CallerInfo

+ func AddLevel(level LogLevelType, levelName string)

+ func Debugf(format string, args ...interface{})

+ func Errorf(format string, args ...interface{})

+ func Fatalf(format string, args ...interface{})

+ func GetLevelName(level LogLevelType) (name string)

+ func Infof(format string, args ...interface{})

+ func Logf(level LogLevelType, format string, args ...interface{})

+ func SetLoggerMaker(maker LoggerMaker)

+ func Shutdown()

+ func Warnf(format string, args ...interface{})

+ type BaseHandler struct

+ func NewBaseHandler(name string, level LogLevelType) *BaseHandler

+ func (self *BaseHandler) Close()

+ func (self *BaseHandler) Flush() error

+ func (self *BaseHandler) Format(record *LogRecord) string

+ func (self *BaseHandler) GetLevel() LogLevelType

+ func (self *BaseHandler) GetName() string

+ func (self *BaseHandler) Handle2(handler Handler, record *LogRecord) int

+ func (self *BaseHandler) HandleError(_ *LogRecord, _ error)

+ func (self *BaseHandler) Lock()

+ func (self *BaseHandler) SetFormatter(formatter Formatter)

+ func (self *BaseHandler) SetLevel(level LogLevelType) error

+ func (self *BaseHandler) SetName(name string)

+ func (self *BaseHandler) Unlock()

+ type BufferingFormatter struct

+ func NewBufferingFormatter(lineFormatter Formatter) *BufferingFormatter

+ func (self *BufferingFormatter) Format(records []*LogRecord) string

+ func (self *BufferingFormatter) FormatFooter(_ []*LogRecord) string

+ func (self *BufferingFormatter) FormatHeader(_ []*LogRecord) string

+ type CallerInfo struct

+ FileName string

+ FuncName string

+ LineNo uint32

+ PathName string

+ type ExtractAttr func(record *LogRecord) string

+ type Filter interface

+ Filter func(record *LogRecord) bool

+ type Filterer interface

+ AddFilter func(filter Filter)

+ Filter func(record *LogRecord) int

+ RemoveFilter func(filter Filter)

+ type FindCallerFunc func() *CallerInfo

+ type Formatter interface

+ Format func(record *LogRecord) string

+ type GetFormatArgsFunc func(record *LogRecord) []interface

+ type Handler interface

+ Close func()

+ Emit func(record *LogRecord) error

+ Flush func() error

+ GetLevel func() LogLevelType

+ GetName func() string

+ Handle func(record *LogRecord) int

+ HandleError func(record *LogRecord, err error)

+ SetFormatter func(formater Formatter)

+ SetLevel func(level LogLevelType) error

+ SetName func(name string)

+ type HandlerCloser struct

+ var Closer *HandlerCloser

+ func NewHandlerCloser() *HandlerCloser

+ func (self *HandlerCloser) AddHandler(handler Handler)

+ func (self *HandlerCloser) Close()

+ func (self *HandlerCloser) RemoveHandler(handler Handler)

+ type LogLevelType uint8

+ const LevelCritical

+ const LevelDebug

+ const LevelError

+ const LevelFatal

+ const LevelInfo

+ const LevelNotset

+ const LevelWarn

+ const LevelWarning

+ func (level LogLevelType) String() string

+ type LogRecord struct

+ Args []interface{}

+ AscTime string

+ CreatedTime time.Time

+ FileName string

+ Format string

+ FuncName string

+ Level LogLevelType

+ LineNo uint32

+ Message *string

+ Name string

+ PathName string

+ UseFormat bool

+ func NewLogRecord(name string, level LogLevelType, pathName string, fileName string, ...) *LogRecord

+ func (self *LogRecord) GetMessage() string

+ func (self *LogRecord) String() string

+ type Logger interface

+ AddHandler func(handler Handler)

+ Debug func(args ...interface{})

+ Debugf func(format string, args ...interface{})

+ Error func(args ...interface{})

+ Errorf func(format string, args ...interface{})

+ Fatal func(args ...interface{})

+ Fatalf func(format string, args ...interface{})

+ GetEffectiveLevel func() LogLevelType

+ GetHandlers func() []Handler

+ GetLevel func() LogLevelType

+ GetManager func() *Manager

+ GetName func() string

+ GetParent func() Logger

+ GetPropagate func() bool

+ Info func(args ...interface{})

+ Infof func(format string, args ...interface{})

+ IsEnabledFor func(level LogLevelType) bool

+ Log func(level LogLevelType, args ...interface{})

+ Logf func(level LogLevelType, format string, args ...interface{})

+ RemoveHandler func(handler Handler)

+ SetLevel func(level LogLevelType) error

+ SetManager func(manager *Manager)

+ SetParent func(parent Logger)

+ SetPropagate func(v bool)

+ Warn func(args ...interface{})

+ Warnf func(format string, args ...interface{})

+ func GetLogger(name string) Logger

+ type LoggerMaker func(name string) Logger

+ type Manager struct

+ func NewManager(logger Logger) *Manager

+ func (self *Manager) GetLogger(name string) Logger

+ func (self *Manager) SetLoggerMaker(maker LoggerMaker)

+ type NameFilter struct

+ func NewNameFilter(name string) *NameFilter

+ func (self *NameFilter) Filter(record *LogRecord) bool

+ type Node interface

+ Type func() NodeType

+ type NodeType uint8

+ const NodeLogger

+ const NodePlaceHolder

+ const NodeUnknown

+ type PlaceHolder struct

+ Loggers mapset.Set

+ func NewPlaceHolder(logger Logger) *PlaceHolder

+ func (self *PlaceHolder) Append(logger Logger)

+ func (self *PlaceHolder) Type() NodeType

+ type RootLogger struct

+ func NewRootLogger(level LogLevelType) *RootLogger

+ type StandardFilterer struct

+ func NewStandardFilterer() *StandardFilterer

+ func (self *StandardFilterer) AddFilter(filter Filter)

+ func (self *StandardFilterer) Filter(record *LogRecord) int

+ func (self *StandardFilterer) GetFilters() []Filter

+ func (self *StandardFilterer) RemoveFilter(filter Filter)

+ type StandardFormatter struct

+ func NewStandardFormatter(format string, dateFormat string) *StandardFormatter

+ func (self *StandardFormatter) Format(record *LogRecord) string

+ func (self *StandardFormatter) FormatAll(record *LogRecord) string

+ func (self *StandardFormatter) FormatTime(record *LogRecord) string

+ type StandardLogger struct

+ func NewStandardLogger(name string, level LogLevelType) *StandardLogger

+ func (self *StandardLogger) AddHandler(handler Handler)

+ func (self *StandardLogger) Debug(args ...interface{})

+ func (self *StandardLogger) Debugf(format string, args ...interface{})

+ func (self *StandardLogger) Error(args ...interface{})

+ func (self *StandardLogger) Errorf(format string, args ...interface{})

+ func (self *StandardLogger) Fatal(args ...interface{})

+ func (self *StandardLogger) Fatalf(format string, args ...interface{})

+ func (self *StandardLogger) GetChild(suffix string) Logger

+ func (self *StandardLogger) GetEffectiveLevel() LogLevelType

+ func (self *StandardLogger) GetHandlers() []Handler

+ func (self *StandardLogger) GetLevel() LogLevelType

+ func (self *StandardLogger) GetManager() *Manager

+ func (self *StandardLogger) GetName() string

+ func (self *StandardLogger) GetParent() Logger

+ func (self *StandardLogger) GetPropagate() bool

+ func (self *StandardLogger) Handle(record *LogRecord)

+ func (self *StandardLogger) Info(args ...interface{})

+ func (self *StandardLogger) Infof(format string, args ...interface{})

+ func (self *StandardLogger) IsEnabledFor(level LogLevelType) bool

+ func (self *StandardLogger) Log(level LogLevelType, args ...interface{})

+ func (self *StandardLogger) Logf(level LogLevelType, format string, args ...interface{})

+ func (self *StandardLogger) RemoveHandler(handler Handler)

+ func (self *StandardLogger) SetFindCallerFunc(f FindCallerFunc)

+ func (self *StandardLogger) SetLevel(level LogLevelType) error

+ func (self *StandardLogger) SetManager(manager *Manager)

+ func (self *StandardLogger) SetParent(parent Logger)

+ func (self *StandardLogger) SetPropagate(v bool)

+ func (self *StandardLogger) Type() NodeType

+ func (self *StandardLogger) Warn(args ...interface{})

+ func (self *StandardLogger) Warnf(format string, args ...interface{})