User Guide

226 Chapter 2: ColdFusion Tags
cflog
Description
Writes a message to a log file.
Category
Data output tags
Syntax
<cflog
text = "text"
log = "log type"
file = "filename"
type = "message type"
application = "application name yes or no">
See also
cfcol, cfcontent, cfoutput, cftable
History
ColdFusion MX: Deprecated the thread, date, and time attributes. They might not work, and
might cause an error, in later releases. (In earlier releases, these attributes determined whether the
respective data items were output to the log. In ColdFusion MX, this data is always output.)
Attributes
Attribute Req/Opt Default Description
text Required Message text to log.
log Optional If you omit the
file attribute, writes messages to standard
log file. Ignored, if you specify
file attribute.
• Application: writes to Application.log, normally used for
application-specific messages.
• Scheduler: writes to Scheduler.log, normally used to log
the execution of scheduled tasks.
file Optional Message file. Specify only the main part of the filename. For
example, to log to the Testing.log file, specify "Testing".
The file must be located in the default log directory. You
cannot specify a directory path. If the file does not exist, it is
created automatically, with the suffix .log.
type Optional Information Type (severity) of the message:
• Information
• Warning
• Error
• Fatal Information
application Optional Yes • Yes: log application name, if it is specified in a
cfapplication tag.
• No