Table of Contents
Advertisement
DEVELOPING COLDFUSION 9 APPLICATIONS
Developing CFML Applications
About the cftrace tag
The
tag provides the following information:
cftrace
• A severity identifier specified by the
• A timestamp indicating when the
• The time elapsed between the start of processing the request and when the current
• The time between any previous
processed for the request, the output indicates "1st trace". ColdFusion does not display this information in inline
trace output, only the log and in the standard debugging output.
• The name of the page that called the
• The line on the page where the
• A trace category specified by the
• A message specified by the
• The name and value, at the time the
A typical
tag might look like the following:
cftrace
<cftrace category="UDF End" inline = "True" var = "MyStatus"
text = "GetRecords UDF call has completed">
You can display the
cftrace
• As a section in the debugging output: To display the trace information in the debugging output, in the
Administrator, select Tracing Information on the Debugging Settings page.
• Inline in your application page: When you specify the
trace output on the page at the
inside a
tag block.)
cfsilent
The
tag executes only if you select Enable Debugging on the ColdFusion Administrator Debugging Settings
cftrace
page. To display the trace results in the debugging output, you must also specify Tracing Information on the
Debugging Settings page; otherwise, the trace information is logged and inline traces are displayed, but no trace
information appears in the debugging output.
Note: When you use inline trace tags, ColdFusion sends the page to the browser after all page processing is completed, but
before it displays the debugging output from the debug template. As a result, if an error occurs after a trace tag but before
the end of the page, ColdFusion might not display the trace for that tag.
The following image shows inline trace messages:
The following table lists the displayed information:
tag
cftrace
type
tag executed
cftrace
tag in the request and the current one. If this is the first
cftrace
tag
cftrace
call is located
cftrace
attribute
category
attribute
text
call executes, of a single variable specified by the
cftrace
tag output in either or both of the following ways:
tag location
cftrace
. (
Last updated 8/5/2010
attribute
attribute in a
inline
cftrace
An inline
tag does not display any output if it is
cftrace
tag executes.
cftrace
tag
cftrace
attribute
var
tag, ColdFusion displays the
386
Advertisement
Table of Contents
