log

Documentation

Index

• func DefaultLevel() string
• func GetModuleLevel(module string) string
• func GetPeerStartupLevel(module string) string
• func InitBackend(formatter logging.Formatter, output io.Writer)
• func InitFromSpec(spec string) string
• func InitLogConfig(conf *Config)
• func InitRollingBackend(logfile string, maxSize int, maxBackups int, maxAge int)
• func MustGetLogger(module string) *logging.Logger
• func Reset()
• func RevertToPeerStartupLevels() error
• func SetFormat(formatSpec string) logging.Formatter
• func SetModuleLevel(moduleRegExp string, level string) (string, error)
• func SetPeerStartupModulesMap()
• type Config

Functions

func DefaultLevel

func DefaultLevel() string

DefaultLevel returns the fallback value for loggers to use if parsing fails.

func GetModuleLevel

func GetModuleLevel(module string) string

GetModuleLevel gets the current logging level for the specified module.

func GetPeerStartupLevel

func GetPeerStartupLevel(module string) string

GetPeerStartupLevel returns the peer startup level for the specified module. It will return an empty string if the input parameter is empty or the module is not found

func InitBackend

func InitBackend(formatter logging.Formatter, output io.Writer)

InitBackend sets up the logging backend based on the provided logging formatter and I/O writer.

func InitFromSpec

func InitFromSpec(spec string) string

InitFromSpec initializes the logging based on the supplied spec. It is exposed externally so that consumers of the blogging package may parse their own logging specification. The logging specification has the following form:

[<module>[,<module>...]=]<level>[:[<module>[,<module>...]=]<level>...]

func InitLogConfig

func InitLogConfig(conf *Config)

InitLogConfig Set the logging level with common ServerGeneral configurations

func InitRollingBackend

func InitRollingBackend(logfile string, maxSize int, maxBackups int, maxAge int)

InitRollingBackend set rolling log backend maxSize is the maximum size in megabytes maxBackups is the maximum number of old log files to retain maxAge is the maximum number of days to retain old log files

func MustGetLogger

func MustGetLogger(module string) *logging.Logger

MustGetLogger is used in place of `logging.MustGetLogger` to allow us to store a map of all modules and submodules that have loggers in the system.

func Reset

func Reset()

Reset sets to logging to the defaults defined in this package.

func RevertToPeerStartupLevels

func RevertToPeerStartupLevels() error

RevertToPeerStartupLevels reverts the log levels for all modules to the level defined at the end of peer startup.

func SetFormat

func SetFormat(formatSpec string) logging.Formatter

SetFormat sets the logging format.

func SetModuleLevel

func SetModuleLevel(moduleRegExp string, level string) (string, error)

SetModuleLevel sets the logging level for the modules that match the supplied regular expression. Can be used to dynamically change the log level for the module.

func SetPeerStartupModulesMap

func SetPeerStartupModulesMap()

SetPeerStartupModulesMap saves the modules and their log levels. this function should only be called at the end of peer startup.

Types

type Config

type Config struct {
	LogFile    string
	LogLevel   string
	MaxSize    int
	MaxBackups int
	MaxAge     int
}

Config config with rolling backend MaxSize is the maximum size in megabytes MaxBackups is the maximum number of old log files to retain MaxAge is the maximum number of days to retain old log files