logger

Documentation

Overview

Package logger provides runtime configuration options for logging, making it easier to consistently have the same configuration options and flags across GitOps Toolkit components.

Index

• Constants
• func NewLogger(opts Options) logr.Logger
• type Options
  • func (o *Options) BindFlags(fs *pflag.FlagSet)

Constants

const (
	TraceLevel = 2
	DebugLevel = 1
	InfoLevel  = 0
)

These are for convenience when doing log.V(...) to log at a particular level. They correspond to the logr equivalents of the zap levels above.

Functions

func NewLogger

func NewLogger(opts Options) logr.Logger

NewLogger returns a logger configured with the given Options, and timestamps set to the ISO8601 format.

Types

type Options

type Options struct {
	LogEncoding string
	LogLevel    string
}

Options contains the configuration options for the runtime logger.

The struct can be used in the main.go file of your controller by binding it to the main flag set, and then utilizing the configured options later:

func main() {
	var (
		// other controller specific configuration variables
		loggerOptions logger.Options
	)

	// Bind the options to the main flag set, and parse it
	loggerOptions.BindFlags(flag.CommandLine)
	flag.Parse()

	// Use the values during the initialisation of the logger
	ctrl.SetLogger(logger.NewLogger(logOptions))
}

func (*Options) BindFlags

func (o *Options) BindFlags(fs *pflag.FlagSet)

BindFlags will parse the given pflag.FlagSet for logger option flags and set the Options accordingly.