Interface Logger

Debug logs at [LevelDebug]. It uses [context.Background] internally; to specify the context, use [Logger.DebugContext].

DebugContext logs at [LevelDebug] with the given context.

Enabled reports whether l emits log records at the given context and level.

Error logs at [LevelError]. It uses [context.Background] internally; to specify the context, use [Logger.ErrorContext].

ErrorContext logs at [LevelError] with the given context.

Handler returns l's Handler.

Info logs at [LevelInfo]. It uses [context.Background] internally; to specify the context, use [Logger.InfoContext].

InfoContext logs at [LevelInfo] with the given context.

Log emits a log record with the current time and the given level and message. The Record's Attrs consist of the Logger's attributes followed by the Attrs specified by args.

The attribute arguments are processed as follows:

  - If an argument is an Attr, it is used as is.
  - If an argument is a string and this is not the last argument,
    the following argument is treated as the value and the two are combined
    into an Attr.
  - Otherwise, the argument is treated as a value with key "!BADKEY".
Copy

LogAttrs is a more efficient version of [Logger.Log] that accepts only Attrs.

Warn logs at [LevelWarn]. It uses [context.Background] internally; to specify the context, use [Logger.WarnContext].

WarnContext logs at [LevelWarn] with the given context.

With returns a Logger that includes the given attributes in each output operation. Arguments are converted to attributes as if by [Logger.Log].

WithGroup returns a Logger that starts a group, if name is non-empty. The keys of all attributes added to the Logger will be qualified by the given name. (How that qualification happens depends on the [Handler.WithGroup] method of the Logger's Handler.)

If name is empty, WithGroup returns the receiver.