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

CF9+

Lucee

BL 1.0.0+

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

© 2012–present Foundeo, Inc. and the CFDocs contributors.
Licensed under the MIT License.
ColdFusion is a trademark of Adobe Systems Incorporated.
https://cfdocs.org/trace