User Guide

cftrace 341
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 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, cftry,
Chapter 18, “Debugging and Troubleshooting
Applications,” in Developing ColdFusion MX Applications
History
ColdFusion MX: Added this tag.
Attributes
Attribute Req/Opt Default Description
abort Optional No • Yes: calls
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, addition to the debugging information
output.
• No
text Optional User-defined string, which can include simple variable, but not
complex variables such as arrays. Outputs to
cflog text
attribute.