cftrace

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.

<cftrace>

CF6+

Lucee

BL 1.0.0+

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

Values:

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.

Compatibility

BoxLang:

Version 1.0.0+ <bx:trace> in BoxLang

Examples
Sample code using the cftrace tag

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