Debug Settings

You use the Debug Setting and Debugging IPs pages of the Administrator to configure ColdFusion Server to provide debugging information for every application page requested by a browser. You specify debugging preferences using these pages:

On the Debugging Options page, you select debugging output options. If debugging is enabled, the output appears in block format after normal page output.
On the Debugging IPs page, you restrict access to debugging output. If a debugging option is enabled, debugging output is visible to all users by default.

Debug Options

The Debugging Options page provides these debug options:

Option

Description

Enable Performance Monitoring*
The standard NT Performance Monitor application displays information about a running ColdFusion Server. On platforms that do not support the NT Performance Monitor, a command line utility, cfstat, displays the same information.

Enable CFML Stack Trace
Displays the CFML tags that were executing at the time of the exception.

Show Variables
Displays the names and values of CGI, URL, form and cookie variables.

Show Total Processing Time
Displays the average time, in milliseconds, that it takes to process a page request.

Show Detailed Processing Time Breakdown*
Displays the time, in milliseconds, that it takes to process each page.

Show SQL and Data Source Name
Displays the data source name and the SQL statement in database query error messages.

Show Query Information
Displays the number of records, processing time, and SQL statement for each query executed.

Display the Template Path in Error Messages
Displays the file name of a template. The name is useful in debugging. However, use of this option can pose a security hazard because it displays information about a server's file structure.

* Restart ColdFusion Server in Windows after selecting this option.

Option	Description
Enable Performance Monitoring*	The standard NT Performance Monitor application displays information about a running ColdFusion Server. On platforms that do not support the NT Performance Monitor, a command line utility, `cfstat`, displays the same information.
Enable CFML Stack Trace	Displays the CFML tags that were executing at the time of the exception.
Show Variables	Displays the names and values of CGI, URL, form and cookie variables.
Show Total Processing Time	Displays the average time, in milliseconds, that it takes to process a page request.
Show Detailed Processing Time Breakdown*	Displays the time, in milliseconds, that it takes to process each page.
Show SQL and Data Source Name	Displays the data source name and the SQL statement in database query error messages.
Show Query Information	Displays the number of records, processing time, and SQL statement for each query executed.
Display the Template Path in Error Messages	Displays the file name of a template. The name is useful in debugging. However, use of this option can pose a security hazard because it displays information about a server's file structure.
* Restart ColdFusion Server in Windows after selecting this option.

Debugging IPs

You use the Debugging IPs page to restrict debugging output to one or more IP addresses. You can add and remove IP addresses.

Warning

If you do not specify IP addresses and debugging options are active, debug output displays for all users.

To allow debug output to an IP address:

On the Debugging IPs page, enter an IP address. Click Add.
To add the IP address of the computer you are using, click Add Current.

To disable debug output to an IP address:

On the Debugging IPs page, select an IP address.
Optionally, repeat Steps 1 and 2 for other addresses.
Click Remove.

Installing and Configuring ColdFusion Server
Basic ColdFusion Server Administration