How can I read and write ColdFusion .log files?

ColdFusion log files are a form of text files that end in the .log extension and must be saved inside of the ColdFusion log directory. Although you can use <cffile> to read and write ColdFusion log files by hand, ColdFusion provides tools designed just for this specific task. To read the files, use the ColdFuson administrator (under Debugging & Logging), and to write/update the files, use the <cflog> tag . These handy shortcuts will save you most of the work associated with manipulating ColdFusion log files.

Using <cflog> is easy. You set the contents of the message to be written to the log file by way of the required text attribute. If you wish to use one of the default ColdFusion log files, you set the log attribute equal to either application or scheduler, depending on which of the two logs you wish to write to. If you wish to write to a custom log file, then you set the file attribute to the name (not including the .log extension) of the log file you wish to use. The type attribute is used to set the severity of the log entry. Valid values for this attribute include: information (default), warning, error, and fatal Information. Finally, the Optional application attribute can be set to either yes (default), or no. If application is set to yes, then the application name will be added to the log file.

The following sample code could be used to add a dynamic entry (based on form data) to a custom log file every time a new member registered on your site:

<cflog file="newUserLog" 
       text="User #form.userName# joined the site.">

This question was written by Jeremy Petersen
It was last updated on February 2, 2006.


File and Directory Access


comments powered by Disqus