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;

CFML logs cftrace output to the file logs\cftrace.log, in
the CFML installation directory.

Note: To permit this tag to execute, you must enable debugging
in the CFML Administrator. Optionally, to report trace
summaries, enable the Trace section.


Attribute Reference

abort boolean
Default: false

Calls cfabort tag when the tag is executed

category string

User-defined string for identifying trace groups

inline boolean
Default: false

Displays trace code in line on the page in the
location of the cftrace tag, addition to the debugging
information output.

text string

User-defined string, which can include simple variable,
but not complex variables such as arrays. Outputs to cflog
text attribute

type string
Default: information

Corresponds to the cflog type attribute; displays an
appropriate icon.

* Information
* Warning
* Error
* Fatal Information
  • information
  • warning
  • error
  • fatal information

var string

The name of a simple or complex variable to display.

Useful for displaying a temporary value, or a value that
does not display on any CFM page.

Sample code using the cftrace tag

Signup for cfbreak to stay updated on the latest news from the ColdFusion / CFML community. One email, every friday.

Fork me on GitHub