trace

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

  1. CFDocs
  2. Functions
  3. ColdFusion 9 New Functions and Tags
  4. trace
  5. CF9+
  6. Lucee
  7. 0 Issue
  8. Edit
See Also:   cftrace

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
Values:
  • 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

Compatibility

ColdFusion:

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

Lucee:

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

Examples
Sample code invoking the trace function

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

Fork me on GitHub