Using LogBox

Once you have created and configured the LogBox library, you can interact with it in order to get logger objects. The main methods you will use to interact with LogBox are the following, but I recommend you look at the class API (http://www.coldbox.org/api) in order to get a listing of all available methods.

Method	Description
LogBoxConfig getConfig()	Get the config object registered
Logger getLogger(any category)	Get a named logger object using a category string or the object you will log from
Logger getRootLogger()	Get a reference to the root logger
string getVersion()	Get the current version of LogBox
string getCurrentAppenders()	Get a list of currently registered appenders
string getCurrentLoggers()	Get a list of currently instantiated loggers
void configure( any config )	Dynamically re-configure the LogBox library. Accepts a LogBoxConfig object, a plain class path (string) to a config class, or a struct literal (same as the config argument to the LogBox constructor).
LogBox registerAppender( name, class, [properties], [layout], [levelMin], [levelMax] )	Register a new appender into the running LogBox registry at runtime. Returns LogBox (fluent).
void shutdown()	Gracefully shut down LogBox — calls onShutdown() on the config, shuts down all registered appenders and the async task executor.

The two most important methods are getRootLogger() & getLogger(), which you will use to get the root or named logger objects.

Caution: When you ask for a named category logger and LogBox cannot find its definition, it will create a logger that will inherit its logging levels and appenders from the root logger.