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.

trace([var] [, text] [, type] [, category] [, inline] [, abort]) → returns void

Argument Reference

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.

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

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.

abort boolean
Default: false

Calls cfabort tag when the tag is executed



Version 9+ As of CF11 parameters must be comma separated.


On Lucee the caller scope must be passed in as the first argument.

Sample code invoking the trace function

Fork me on GitHub