The
tag lets you specify the following information:
cflog
•
A custom file or standard ColdFusion log file in which to write the message.
•
Text to write to the log file. This can include the values of all available error and
variables.
•
Message severity (type): Information Warning, Fatal, or Error.
•
Whether to log any of the following: application name, thread ID, system date, or system time.
By default, all get logged.
For example, you could use a
information to an application-specific log file, as in the following page:
<html>
<head>
<title>Products - Error</title>
</head>
<body>
<h2>Sorry</h2>
<p>An error occurred when you requested this page.
The error has been logged and we will work to correct the problem.
We apologize for the inconvenience. </p>
<cflog type="Error"
file="myapp_errors"
text="Exception error --
Exception type: #error.type#
Template: #error.template#,
Remote Address: #error.remoteAddress#,
HTTP Reference: #error.HTTPReferer#
Diagnostics: #error.diagnostics#">
</body>
</html>
Reviewing the code
The following table describes the highlighted code and its function:
Code
<cflog
type="Error"
file="myapp_errors"
text="Exception error
Exception type: #Error.type#
Template: #Error.template#,
Remote Address:
#Error.remoteAddress#,
HTTP Reference: #error.HTTPReferer#
Diagnostics: #Error.diagnostics#">
A log file entry similar to the following is generated if you try to call a nonexistent custom tag and
this page catches the error:
"Error","web-13","12/19/01","11:29:07",MYAPP,"Exception error --
Exception type: coldfusion.runtime.CfErrorWrapper
Template: /MYStuff/NeoDocs/exceptiontest.cfm,
Remote Address: 127.0.0.1,
HTTP Reference:
298
Chapter 14: Handling Errors
tag in an exception error-handling page to log the error
cflog
Description
When this page is processed, log an entry in the file
myapp_errors.log file in the ColdFusion log directory.
Identify the entry as an error message and include an
error message that includes the exception type, the
path of the page that caused the error, the remote
address that called the page, and the error's
diagnostic message.
cfcatch
Need help?
Do you have a question about the COLDFUSION MX 61-DEVELOPING COLDFUSION MX and is the answer not in the manual?
Questions and answers