Documentation ¶
Overview ¶
Package log contains utilities for fetching a new logger when one is not already available.
The Log Handle ¶
This package contains a root logr.Logger Log. It may be used to get a handle to whatever the root logging implementation is. By default, no implementation exists, and the handle returns "promises" to loggers. When the implementation is set using SetLogger, these "promises" will be converted over to real loggers.
Logr ¶
All logging in controller-runtime is structured, using a set of interfaces defined by a package called logr (https://pkg.go.dev/github.com/go-logr/logr). The sub-package zap provides helpers for setting up logr backed by Zap (go.uber.org/zap).
Index ¶
- Variables
- func Error(err error, msg string, keysAndValues ...any)
- func Errorf(err error, format string, v ...any)
- func Fatal(err error, msg string, keysAndValues ...any)
- func Fatalf(err error, format string, v ...any)
- func Info(msg string, keysAndValues ...any)
- func Infof(format string, v ...any)
- func IntoContext(ctx context.Context, log Logger) context.Context
- func SetLogLevel(level int)
- func SetLogger(l Logger)
- type DelegatingLogSink
- func (l *DelegatingLogSink) Enabled(level int) bool
- func (l *DelegatingLogSink) Error(err error, msg string, keysAndValues ...any)
- func (l *DelegatingLogSink) Fulfill(actual logr.LogSink)
- func (l *DelegatingLogSink) Info(level int, msg string, keysAndValues ...any)
- func (l *DelegatingLogSink) Init(info logr.RuntimeInfo)
- func (l *DelegatingLogSink) WithName(name string) logr.LogSink
- func (l *DelegatingLogSink) WithValues(tags ...any) logr.LogSink
- type Logger
Constants ¶
This section is empty.
Variables ¶
var (
Log = Logger{logr.New(dlog).WithName("vineyard")}
)
Functions ¶
func IntoContext ¶
IntoContext takes a context and sets the logger as one of its values. Use FromContext function to retrieve the logger.
func SetLogLevel ¶
func SetLogLevel(level int)
Types ¶
type DelegatingLogSink ¶
type DelegatingLogSink struct {
// contains filtered or unexported fields
}
DelegatingLogSink is a logsink that delegates to another logr.LogSink. If the underlying promise is not nil, it registers calls to sub-loggers with the logging factory to be populated later, and returns a new delegating logger. It expects to have *some* logr.Logger set at all times (generally a no-op logger before the promises are fulfilled).
func NewDelegatingLogSink ¶
func NewDelegatingLogSink(initial logr.LogSink) *DelegatingLogSink
NewDelegatingLogSink constructs a new DelegatingLogSink which uses the given logger before its promise is fulfilled.
func (*DelegatingLogSink) Enabled ¶
func (l *DelegatingLogSink) Enabled(level int) bool
Enabled tests whether this Logger is enabled. For example, commandline flags might be used to set the logging verbosity and disable some info logs.
func (*DelegatingLogSink) Error ¶
func (l *DelegatingLogSink) Error(err error, msg string, keysAndValues ...any)
Error logs an error, with the given message and key/value pairs as context. It functions similarly to calling Info with the "error" named value, but may have unique behavior, and should be preferred for logging errors (see the package documentations for more information).
The msg field should be used to add context to any underlying error, while the err field should be used to attach the actual error that triggered this log line, if present.
func (*DelegatingLogSink) Fulfill ¶
func (l *DelegatingLogSink) Fulfill(actual logr.LogSink)
Fulfill switches the logger over to use the actual logger provided, instead of the temporary initial one, if this method has not been previously called.
func (*DelegatingLogSink) Info ¶
func (l *DelegatingLogSink) Info(level int, msg string, keysAndValues ...any)
Info logs a non-error message with the given key/value pairs as context.
The msg argument should be used to add some constant description to the log line. The key/value pairs can then be used to add additional variable information. The key/value pairs should alternate string keys and arbitrary values.
func (*DelegatingLogSink) Init ¶
func (l *DelegatingLogSink) Init(info logr.RuntimeInfo)
Init implements logr.LogSink.
func (*DelegatingLogSink) WithName ¶
func (l *DelegatingLogSink) WithName(name string) logr.LogSink
WithName provides a new Logger with the name appended.
func (*DelegatingLogSink) WithValues ¶
func (l *DelegatingLogSink) WithValues(tags ...any) logr.LogSink
WithValues provides a new Logger with the tags appended.
type Logger ¶
func FromContext ¶
FromContext returns a logger with predefined values from a context.Context.