Graceful ColdFusion Timeout Disaster Recovery (Thanks Barney Boisvert)

Posted August 20, 2007 at 7:00 AM

Tags: ColdFusion

Previously, I blogged about how hard it is to recovery gracefully from ColdFusion request timeout exceptions. The big problem is that after a particular tag or algorithm times out, even if you CFCatch the thrown exception, you simply don't have any processing time to do anything with the error object. Once a page times out, you have about 16-30 milliseconds to perform recovery actions before the thread actually craps out. That pretty much excludes any kind of CFMail or CFDump action (and if you want to log anything to a file, just forget about it!).

In the brief post-timeout period, I demonstrated that you could simply set a higher request timeout in the ColdFusion CFSetting tag. However, unless your page timeouts are always the same, this was pretty much hit or miss. Barney Boisvert just dropped a bomb shell on me last week, demonstrating how to get the current request timeout from ColdFusion Request Monitor.

When I saw that, I immediatly knew it could be leveraged for this task. Using Barney's tip, it now becomes super easy to gracefully recover from a ColdFusion timeout exception. First, we need to create a simple ColdFusion user defined function that encapsulates the getting of the current request timeout; after all, I don't necessarily want to remember how to do this:

 Launch code in new window » Download code as text file »

  • <cffunction
  • name="GetRequestTimeout"
  • access="public"
  • returntype="numeric"
  • output="false"
  • hint="Returns the current request timeout for the current page page request.">
  •  
  • <!--- Define the local scope. --->
  • <cfset var LOCAL = StructNew() />
  •  
  • <!--- Get the request monitor. --->
  • <cfset LOCAL.RequestMonitor = CreateObject(
  • "java",
  • "coldfusion.runtime.RequestMonitor"
  • ) />
  •  
  • <!--- Return the current request timeout. --->
  • <cfreturn LOCAL.RequestMonitor.GetRequestTimeout() />
  • </cffunction>

Once we have that in place, we can update our disaster recovery methodology to add just a few seconds to the current request timeout once a ColdFusion timeout exception has been thrown:

 Launch code in new window » Download code as text file »

  • <cffunction
  • name="KillTime"
  • access="public"
  • returntype="void"
  • output="false"
  • hint="I kill time for the given miliseconds.">
  •  
  • <!--- Define arguments. --->
  • <cfargument
  • name="MS"
  • type="numeric"
  • required="true"
  • />
  •  
  • <!--- Get start and end tick out values. --->
  • <cfset var intStart = GetTickCount() />
  • <cfset var intEnd = (intStart + ARGUMENTS.MS ) />
  •  
  • <!--- Loop until this time is killed. --->
  • <cfloop condition="(GetTickCount() LT intEnd)">
  •  
  • <!--- Just try to kill some processing time. --->
  • <cfset intStart = Sqr(
  • intStart * Pi() * GetTickCount()
  • ) />
  •  
  • </cfloop>
  •  
  • <!--- Return out. --->
  • <cfreturn />
  • </cffunction>
  •  
  •  
  • <!--- ::: DEMO CODE ::: --->
  •  
  •  
  • <!--- Set the current time out to be 2 seconds. --->
  • <cfsetting requesttimeout="2" />
  •  
  • <!---
  • Get the millisecond start time for page processing
  • (so that later on, we can check to see how long
  • the page ran overall).
  • --->
  • <cfset intStart = GetTickCount() />
  •  
  •  
  • <!--- Try to kill some time. --->
  • <cftry>
  •  
  • <!---
  • Here, we are killing time - 4 seconds to be
  • approximate. This will exceed the request time
  • out set above (2 seconds) and will throw an error.
  • --->
  • <cfset KillTime( 4000 ) />
  •  
  •  
  • <!--- The KillTime() method call has timed out. --->
  • <cfcatch>
  •  
  • <p>
  • First Timeout!
  • </p>
  •  
  • <!---
  • Now that our page has timed out, we need to
  • add more time to the request in order to recover
  • gracefully. Add a few seconds onto the request
  • timeout that caused this exception.
  • --->
  • <cfsetting
  • requesttimeout="#(GetRequestTimeout() + 3)#"
  • />
  •  
  •  
  • <!---
  • Now that we have a little more wiggle room,
  • let's email ourselves the caught exception.
  • --->
  • <cfmail
  • to="ben@xxxxxxxx.com"
  • from="no-reply@xxxxxxxx.com"
  • subject="Kinky Solutions Timeout Error"
  • type="html">
  •  
  • <p>
  • The following error was thrown on
  • #DateFormat( Now(), "mmm d, yyyy" )# at
  • #TimeFormat( Now(), "hh:mm TT" )#
  • </p>
  •  
  • <!--- Dump out error. --->
  • <cfdump
  • var="#CFCATCH#"
  • label="Kinky Solutions Exception"
  • />
  •  
  • <!--- Dump out CGI object. --->
  • <cfdump
  • var="#CGI#"
  • label="CGI Struct"
  • />
  • </cfmail>
  •  
  • </cfcatch>
  •  
  • </cftry>
  •  
  •  
  • <cfoutput>
  • <p>
  • Total Time: #(GetTickCount() - intStart)#
  • </p>
  • </cfoutput>

Notice that in our CFCatch tag, once we know that the function, KillTime(), has timed out, we are not playing hit-or-miss with the new CFSetting tag. In fact, we are making very sure to only add three more seconds to the page processing. In that time, we are CFMailing ourselves the error as well as the user's CGI object.

Running the above page, we get the following output:

First Timeout!

Total Time: 2078

Notice that after the first request timeout exception was thrown (First Timeout!) we were able to continue processing the CFMail tag. All in all, it took 78 milliseconds to run the additional CFMail / CFDump scripts. This is the kind of disaster recovery that we would NOT have had time to do if we didn't mess with the page's request timeout.

Thanks Barney!

Oh, and incidentally, I had the pleasure of meeting Barney in person at CFUNITED 2007. Very cool guy - seemed way smarter than myself. However, I am embarrassed to say that I was totally mispronouncing his name. Apparently, it is a name of french descent and is pronounced "Bo-v'air". Sorry Barney :)

Download Code Snippet ZIP File

Comments (8)  |  Post Comment  |  Ask Ben  |  Permalink  |  Other Searches  |  Print Page



Adobe ColdFusion 8.0.1 Update - Helping Programmers To Be Signifanctly Less Girlie - Download ColdFusion 8 Update 8.0.1 Now.

Reader Comments

Nice! Been wondering how this would be possible.

Posted by Gareth on Aug 20, 2007 at 9:43 AM


Yes, Barney is just a great guy as well as being a friggin' genius on just about any topic. And don't feel too bad about mispronouncing his name, I think everyone does at first. ;-)

Posted by Brian Kotek on Aug 20, 2007 at 10:55 AM


Very cool. I can use this :-)

Posted by jax on Aug 21, 2007 at 3:18 AM


I think I would like to make this standard place in my applications as part of my catch-all error handling. Just add one second and you should have enough time to take care of all the logging and possible emailing. I think it's just good practice.... anyone see any red flags (and remember and error that goes of inside of the OnError() event method will NOT cause infinite error handling)?

Posted by Ben Nadel on Aug 21, 2007 at 12:24 PM


This is fantastic! I see that this technique works on CF7-- this isn't limited only to the Enterprise version of CF, is it? (I ask because Enterprise is all I can currently test on.)

Posted by Tom Mollerus on Aug 23, 2007 at 3:34 PM


@Tom,

I can only test on Standard, so it certainly not limited to Enterprise.

Posted by Ben Nadel on Aug 23, 2007 at 3:36 PM


Saw this post on the ColdFusion Weekly podcast del.icio.us link roll.

I just incorporated this idea into the error plugin file for my Fusebox 5 application, and it works like a charm! Thanks for the info!

Posted by Brian Swartzfager on Aug 23, 2007 at 3:45 PM


@Ben: Good to know that it works on Standard as well as Enterprise, and CF7 as well as CF8. (Anyone care to test it out on CF6, for the heck of it?)

Posted by Tom Mollerus on Aug 23, 2007 at 3:48 PM


Post Comment  |  Ask Ben


Home   |   Web Log   |   ColdFusion   |   Projects   |   Resume   |   Job Form   |   Search   |   Contact
Epicenter Consulting - Custom Software Solutions for Business Evolution HostMySite.com - The Leader In ColdFusion Hosting