Programming ColdFusion MX, 2nd Edition

Name

cflog

Synopsis

<cflog>

Logs messages to the Application.log file, the Scheduler.log file, or to a custom log file. The log files generated by cflog follow a standard format. The first line of each log file contains a comma-delimited list of column headers qualified with double quotes that looks like this:

"Severity","ThreadID","Date","Time","Application","Message"

When an entry is made to the log file, the values that are written to each column are also qualified with double quotes and delimited with commas.

Attributes

text=" message "

Text you want to appear in the log entry. Required.

application="Yes|No"

Whether or not to include the application name if one is specified in a cfapplication tag for the application. Optional. The default is Yes.

date="Yes|No"

Whether or not to include the system date in the log entry. Optional. The default is Yes. This attribute is deprecated in ColdFusion MX. The system date is now included in all log entries.

file=" filename "

The name of the log file to write the log entry to. You must specify the name of a file with a .log extension. When specifying the filename, leave off the extension. If the file doesn’t exist, ColdFusion automatically creates it in the default log file directory specified in the ColdFusion Administrator. Optional. If you specify a value for file, you must omit the log attribute.

log=" log_type "

The standard ColdFusion log file to write the entry to. Valid options are:

Application

The entry is written to the Application.log ...