• Showing Page History #114249

Normal Logging API

The Normal Logging API differentiates between "normal" log messages and "debug" log messages. This gives you two separate streams to write logging messages to. It also allows you to save all messages (normal and debug) to a set of other streams. This will let you, for example, save all the messages to a file as well as output them to the console.

Types

  • T/LOG-LEVEL: Equivalent to (UNSIGNED-BYTE 8).

Globals

These are the various special variables that will influence how the Normal Logging API functions.

  • *LOG-LEVEL*: The minimum level required to log messages. This can be any number of type T/LOG-LEVEL.
  • *debug-LEVEL*: The minimum level required to log a debug message. This can be any number of type T/LOG-LEVEL.
  • *LOG-STREAM*: The main stream to log messages to. Default is *STANDARD-OUTPUT*.
  • *DEBUG-STREAM*: The main stream to log debugging messages to. Default is *ERROR-OUTPUT*.
  • *MORE-LOG-STREAMS*: A list of additional streams to write normal and debug log messages to.
  • *DEFAULT-HEADER*: When no header is specified in a normal logging function, this one will be displayed instead.
  • *DEBUG-HEADER*: The default header for debug logging. This is always output.
  • *FORCE-OUTPUT*: When non-NIL, FORCE-OUTPUT will be called after each logging call (though it can still be controlled with the lower-level function LOG/BASE). NOTE: this also affects the SimpleLoggingApi.