cftrace

Overview ColdFusion Open BlueDragon Lucee

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.

Attributes

Name Required Type Default Description
abort No Boolean false Calls cfabort tag when the tag is executed
application No If set to YES, the web application name will be stored with the output of this log entry.
3
caller No scope used for var evaluation, if not defined the current scope is used.
category No String User-defined string for identifying trace groups
file No Specifies a file name that this log will be written to. This attribute cannot be applied with the "LOG" attribute.
3
follow No If true, Railo follows the object defined in the [var] attribute and will log any changes to it. Ignored when attribute [var] is not defined.
inline No Boolean false Displays trace code in line on the page in the location of the cftrace tag, addition to the debugging information output.
log No Specifies a standard openbd log file to write this log to. Possible options include "scheduler", "trace" or "application". This attribute cannot be applied with the "FILE" attribute.
text No String User-defined string, which can include simple variable, but not complex variables such as arrays. Outputs to cflog text attribute
thread No Setting this attribute to YES will gather the thread reference this log was called within and output it with the log. This is useful to find out which thread has generated a log if being used in a threaded environment.
type No String information Corresponds to the cflog type attribute; displays an appropriate icon. * Information * Warning * Error * Fatal Information
var No 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.
variable No