Luis Majano

July 10, 2009

Spread the word

Share your thoughts

After much work and restructuring the ColdBox logging capabilities into a standalone library, we have arrived to the birth of LogBox.  The ColdBox logging capabilities exist since version pre 1.0 way back in 2005 and now finally are open for usage with or without ColdBox MVC.  LogBox is part of an entire set of suites of services that the ColdBox 3.0.0 Platform is being built on, which includes:
  • MockBox : An enterprise object mocking/stubbing framework
  • LogBox: Enterprise ColdFusion Logging Library
  • BlenderBox : Enterprise Inversion of Control, Dependency Injection, Annotation and AOP framework
  • CacheBox : Enterprise Caching Engine
  • ColdBox MVC : MVC framework
  • ColdBox Messaging : Cluster Aware JMS messaging and distributed computing
  • SHHH (Others coming soon)
LogBox was retooled as a standalone service and got inspirations from the Log4J project and CFlogger.  The question that you might be asking yourself is: "Can I use LogBox without ColdBox?" Well, yes! However, understand that LogBox IS ColdBox also.  It is part of the new ColdBox 3.0.0 platform currently in development.  However, you can now download a-la-carte parts of the platform or the entire suite of services.  A 3.0.0 alpha is soon to arrive but it has over 85 tickets already closed and can be found on SVN or the nightly build.

Download LogBox 1.0 Beta:
Download MockBox 1.0 Beta:
Want to suggest a feature, fix a bug, new something? User your voice:

So let's explore a little about LogBox:

LogBox is an enterprise ColdFusion logging library designed to give you flexibility, simplicity and power when logging or tracing is needed in your applications. LogBox is part of the ColdBox Platform 3.0 suite of services and libraries. LogBox allows you to easily build upon its logging framework in order to meet any logging or reporting needs your applications has. ColdFusion has the very basic cflog tag that you can use in your applications to leverage file logging but it has many limitations. LogBox allows you to create multiple destinations for your loggings and even be able to configure them or change them at runtime.

Almost every application needs some kind of logging or tracing capabilities and we believe that LogBox fills that void. Although you always have to remember that over-use of logging can slow down an application. However, LogBox offers you the capabilities to filter out or be able to cancel logging noise a-la-carte. LogBox was inspired by the original logging capabilities in ColdBox and in the Log4j project.

Need for Logging

Almost every single application needs some kind of logging and tracing capabilities. One can usually use the now famous cflog or cftrace tags but you can reach a limitation very fast. What if you needed to log only certain severity levels for a particular cfc or piece of code? What if you needed that severity to advice you via SMS or Twitter, yes Twitter? Well, you would have to build all of these advising and logging capabilities yourself. Also, inserting log statements is tedious, time consuming and sometimes it just pollutes our real code. What if you wanted to turn it off easily, or reconfigure it? Well, you can obviously feel the pain now as we all have dealt with these situations. Therefore, LogBox has been built.

What Can LogBox Do For You?

  • LogBox can handler the inserting of logging or tracing statements in your applications with a very easy to use API and gives you the ability to manage it externally without touching application code.
  • You can configure LogBox via the following means:
    • A programmatic configuration file (cfc)
    • An xml configuration file
  • LogBox categorizes your logging or tracing statements according to user-defined categories that can be configured at runtime or pre-runtime. All of these categorizations can have their own logging level ranges and even their own destination points or what we refer to as LogBox Appenders.
  • LogBox Appenders are the different destination points you can configure for your logging or tracing statements. LogBox also offers a basic extensible API so you can build and extend upon the Appender framework according to your logging or tracing needs. This gives you complete control and flexibility of how to expand LogBox. Some appenders included in LogBox can log to the following destinations: File, Database, Twitter, Sockets, Email, ColdFusion logging, System Console, and much more.
    • LogBox also facilitates the creation of your very own customized message formats via Layouts. You can create a Layout component that can be configured in to ANY LogBox appender so it can spit out your very own customized messages.
    • LogBox can be instantiated as many times as you want and used as many times as you like in a single application. There are no restrictions upon its usage.
LogBox Appenders

Appender Description
AsyncFileAppender An Asynchronous file appender
AsyncRollingFileAppender An Asynchronous file appender that can do file rotation and archiving
CFAppender Will deliver messages to the coldfusion logs
ConsoleAppender Will deliver messages to the console via system.out
DBAppender Will deliver messages to a database table. It can even auto create the table for you.
EmailAppender Will deliver messages to any email address
FileAppender Will deliver messages a file
RollingFileAppender A file appender that can do file rotation and archiving
ScopeAppender Will deliver messages to any ColdFusion scope you desire
SocketAppender Will connect to any server socket and deliver messages
TwitterAppender Can either send direct messages to a twitter user or update a status of a twitter user.

This is just a simple introduction to LogBox.  If you are compelled to continue reading, then please continue in our wiki at

Add Your Comment


Jul 10, 2009 02:32:32 UTC

by Aaron Longnion

@Luis - thanks so much for putting this together! We have become frustrated with the limitations of cflog, especially in our architecture with 8 CF8 instances in a cluster. It looks like LogBox can solve all our logging issues!

Jul 10, 2009 07:50:26 UTC

by Curt Gratz

This looks awesome. I had created my own Coldbox DB log tool, but it is great that it will now be baked right in. Email logging also...Good thoughts. Thanks as always, Curt Gratz

Jul 10, 2009 08:40:45 UTC

by Dan Wilson

Luis, This project looks pretty cool. I'd like to talk to you about the dependencies of this project. Maybe this would give us a collaboration opportunity? DW

Jul 10, 2009 17:22:46 UTC

by Tony Garcia

Sounds really cool, Luis. Looking forward to the new platform. One thing, though: Isaac Dealey already has a project named CacheBox:

Jul 10, 2009 18:47:09 UTC

by Luis Majano

Hmm, good catch. Well, a renaming will have to take place then. Although the real name is ColdBox CacheBox, but anyways, any ideas? Maybe just ColdBox Cache, which is the original name.

Jul 10, 2009 18:47:58 UTC

by Luis Majano

@dan Thanks Dan!! LogBox is standalone, so you can use it as is or integrate it as is. I sent you an email with some details!! Gracias Amigo!

Jul 12, 2009 14:40:40 UTC

by Sami Hoda

Excellent work as always Luis!

Jan 28, 2011 11:25:22 UTC

by Susan

Can I intergate LogBox with the CFWheels Framework? If so, do I also need to copy the /ColdBox/ folder into the route of my CFWheels application? Thanks in advance for your help.

Jan 28, 2011 11:59:49 UTC

by Luis Majano

Hi Susan, You can because the library can be used standalone. Just download the standalone package. However, we do recommend you give ColdBox a shot as an MVC framework, you will be happily surprised!

Recent Entries

Unveiling the Future of CFML Development - 3rd Round of Sessions

Unveiling the Future of CFML Development - 3rd Round of Sessions

Welcome back to our journey into the future of CFML development! As excitement continues to build for Into the Box 2024, we're thrilled to bring you the latest updates on what promises to be a transformative event. Continuing our blog post series, let's delve deeper into the third wave of session releases and discover the key surprises awaiting attendees. Learn More

Maria Jose Herrera
Maria Jose Herrera
March 01, 2024
Elevate Your ColdBox Experience and Skills

Elevate Your ColdBox Experience and Skills

We're thrilled to announce a significant overhaul of our ColdBox training experience to ensure it's nothing short of extraordinary! We've listened closely to your feedback and made significant improvements geared towards transforming you into a ColdBox superhero. Learn What's New!

Maria Jose Herrera
Maria Jose Herrera
February 20, 2024
Ortus Redis Extension v3.3.0 Released!

Ortus Redis Extension v3.3.0 Released!

We are very excited to bring you another release for our Redis Lucee Extension. The most significant feature in this release is the addition of the `` and `redisLock{}` tag, which allows you perform a lock across all instances in a cluster.

Ortus Redis Extension v3.3.0 gives you greater control over concurrent modifications in a distributed environment, utilizing your distributed cache to prevent overlaps!

Jon Clausen
Jon Clausen
February 16, 2024