User Guide

424 Chapter 2: ColdFusion Tags
cftrace
Description
Displays and logs debugging data about the state of an application at the time the cftrace tag
executes. Tracks runtime logic flow, variable values, and execution time. Displays output at the
end of the request or in the debugging section at the end of the request; or, in Dreamweaver MX
and later, in the Server Debug tab of the Results window.
ColdFusion logs
cftrace output to the file logs\cftrace.log, in the ColdFusion installation
directory.
Note: To permit this tag to execute, you must enable debugging in the ColdFusion MX Administrator.
Optionally, to report trace summaries, enable the Trace section.
Category
Debugging tags, Variable manipulation tags
Syntax
<cftrace
abort = "Yes" or "No"
category = "string"
inline = "Yes" or "No"
text = "string"
type = "format"
var = "variable_name"
</cftrace>
See also
cfdump
, cferror, cfrethrow, cftimer, cftry; Chapter 18, “Debugging and Troubleshooting
Applications” in ColdFusion MX Developer’s Guide
History
ColdFusion MX: Added this tag.
Attributes
Attribute Req/Opt Default Description
abort Optional No • Yes: calls a
cfabort tag when the tag is executed.
• No
category Optional User-defined string for identifying trace groups.
inline Optional No • Yes: displays trace code in line on the page in the location of
the
cftrace tag, in addition to the debugging information
output.
• No
text Optional User-defined string, which can include simple variables, but
not complex variables such as arrays. Outputs to the
cflog
text attribute.