LogBox

LogBox has been heavily inspired by Apache Log4j.

By default, LogBox is included with all ColdBox packages, version 3 or higher.

This doesn't mean LogBox needs ColdBox to work, developers being able to use LogBox as a stand-alone application.

LogBox will improve how developers debug their code, allowing them to follow and record how an application behaves and then sip through the results, searching for the problem or desired action.

LogBox itself is comprised of four component parts: the LogBox core, the logging framework, the log creation component and the layout controller.

This components provide a very flexible logging utility for ColdFusion, yet well organized and pretty simple to use.

Features:

• Categorize logging events
• Easy insertion into existing applications
• Customizable logging levels
• Customizable logging destinations
• Customizable logging message formats
• Programmatic API available
• Lots of documentation
• Supported logging destinations:
• Local file
• Database
• Twitter
• Sockets
• Email
• SMS
• ColdFusion logging handler
• System console
• Custom handler

What is new in this release:

• Bugs:
• Truncating of category data to avoid error on insertion on DB Appender
• Improvements:
• Deprecate logbox XML support

What is new in version 1.6:

• Convenience methods for log checking: canDebug(), canInfo(), canWarn(), canFatal(), canError().
• Better documentation on logging classes and levels.
• Enhance the logEvent class to have a better serialization schema for extraInfo, it can use convention $toString() on the incoming extra info object to do auto serialization on it. If not, if complex it will use JSON notation.
• LogBox category parsing needs a length check when the category sent is blank.
• Performance tuning that is outta hand.

What is new in version 1.5:

• Implicit logging levels are not changing on max level only but both, misconceptions as per what the documentation says. This is when you do: info = ["myapp.model"] or debug=["coldbox.system.ioc"].
• Added concatenation possibilities to all programmatic configuration methods, so you can concatenate them jquery style.
• SB appender failure when declaring a columnMap property, instance.columns not defined is now fixed.

What is new in version 1.4:

• Fixes to DSL when doing appender affinity, not converting log levels to numeric.
• logLevels isLevelValid not assuring a valid level wrong boolean operation.
• appender() not doing level checks .
• Refactoring the log levels argument types to consolidate them at the three input methods thanks to brad wood.
• Appender registration an init() not registering the log levels correctly.
• Refactor logger and appender to verify logging levels sent via init().
• Update the ensurance of datasources and let CF throw exception instead.
• Creation of XML schema for LogBox.

Requirements:

• ColdFusion MX 7 or higher
• Railo 2 or higher
• BlueDragon 7 or higher