logging

Documentation

Index

• Constants
• func AssertOutput(o string) error
• func NewJournaldCore(identifier string, enab zapcore.LevelEnabler) zapcore.Core
• type Config
  • func (l *Config) Validate() error
• type Logger
  • func NewLogger(base *zap.SugaredLogger, interval time.Duration) *Logger
  • func (l *Logger) Interval() time.Duration
• type Logging
  • func NewLogging(name string, level zapcore.Level, output string, options Options, ...) (*Logging, error)
  • func NewLoggingFromConfig(name string, c Config) (*Logging, error)
  • func (l *Logging) GetChildLogger(name string) *Logger
  • func (l *Logging) GetLogger() *Logger
• type Options

Constants

const (
	CONSOLE = "console"
	JOURNAL = "systemd-journald"
)

Functions

func AssertOutput

func AssertOutput(o string) error

AssertOutput returns an error if output is not a valid logger output.

func NewJournaldCore

func NewJournaldCore(identifier string, enab zapcore.LevelEnabler) zapcore.Core

NewJournaldCore returns a zapcore.Core that sends log entries to systemd-journald and uses the given identifier as a prefix for structured logging context that is sent as journal fields.

Types

type Config

type Config struct {
	// zapcore.Level at 0 is for info level.
	Level  zapcore.Level `yaml:"level" default:"0"`
	Output string        `yaml:"output"`
	// Interval for periodic logging.
	Interval time.Duration `yaml:"interval" default:"20s"`

	Options `yaml:"options"`
}

Config defines Logger configuration.

func (*Config) Validate

func (l *Config) Validate() error

Validate checks constraints in the configuration and returns an error if they are violated. Also configures the log output if it is not configured: systemd-journald is used when Icinga DB is running under systemd, otherwise stderr.

type Logger

type Logger struct {
	*zap.SugaredLogger
	// contains filtered or unexported fields
}

Logger wraps zap.SugaredLogger and allows to get the interval for periodic logging.

func NewLogger

func NewLogger(base *zap.SugaredLogger, interval time.Duration) *Logger

NewLogger returns a new Logger.

func (*Logger) Interval

func (l *Logger) Interval() time.Duration

Interval returns the interval for periodic logging.

type Logging

type Logging struct {
	// contains filtered or unexported fields
}

Logging implements access to a default logger and named child loggers. Log levels can be configured per named child via Options which, if not configured, fall back on a default log level. Logs either to the console or to systemd-journald.

func NewLogging

func NewLogging(name string, level zapcore.Level, output string, options Options, interval time.Duration) (*Logging, error)

NewLogging takes the name and log level for the default logger, output where log messages are written to, options having log levels for named child loggers and returns a new Logging.

func NewLoggingFromConfig

func NewLoggingFromConfig(name string, c Config) (*Logging, error)

NewLoggingFromConfig returns a new Logging from Config.

func (*Logging) GetChildLogger

func (l *Logging) GetChildLogger(name string) *Logger

GetChildLogger returns a named child logger. Log levels for named child loggers are obtained from the logging options and, if not found, set to the default log level.

func (*Logging) GetLogger

func (l *Logging) GetLogger() *Logger

GetLogger returns the default logger.

type Options

type Options map[string]zapcore.Level

Options define child loggers with their desired log level.