Programming ColdFusion

Name

CFLOG — New as of ColdFusion 5.0

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.

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 file. This file is automatically created by ColdFusion and logs application-specific messages.

Scheduler

The entry is written to the Scheduler.log file. This file is used by ColdFusion to log execution information concerning scheduled tasks.

If you wish to write to a custom log file, omit the LOG attribute and use FILE instead. Optional.

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 ...