
Contents > Configuring and Administering ColdFusion MX > Basic ColdFusion MX Administration > Debugging & Logging section > Debugging Settings page Using the cfstat utility

Using the cfstat utility

The cfstat command-line utility provides real-time performance metrics for ColdFusion MX. Using a socket connection to obtain metric data, the cfstat utility displays the information that ColdFusion MX writes to the System Monitor without actually using the System Monitor application. The following table lists the metrics that cfstat returns:

Metric abbreviation	Metric name	Description
Pg/Sec	Page hits per second	The number of ColdFusion pages processed per second. You can reduce this by moving static content to HTML pages.
DB/Sec	Database accesses per second	The number of database accesses per second made by ColdFusion MX. Any difference in complexity and resource load between calls is ignored.
CP/Sec	Cache pops per second	The number of ColdFusion template cache pops per second. A cache pop occurs when ColdFusion MX ejects a cached template from the template cache to make room for a new template.
Req Q'ed	Number of queued requests	The number of requests that are currently waiting for ColdFusion MX to process them. Lower values, which you can achieve with efficient CFML, are better.
Req Run'g	Number of running requests	The number of requests that ColdFusion MX is currently actively processing.
Req TO'ed	Number of timed out requests	The total number of ColdFusion requests that have timed out. Lower values, which you can achieve by aggressive caching, removing unnecessary dynamic operations and third-party events, are better.
AvgQ Time	Average queue time	A running average of the time, in milliseconds, that requests spend waiting for ColdFusion MX to process them. Lower values, which you can achieve with efficient CFML and enhanced caching, are better.
AvgReq Time	Average request time	A running average of the time, in milliseconds, that ColdFusion MX spends to process a request (including queued time). Lower values, which you can achieve with efficient CFML, are better.
AvgDB Time	Average database transaction time	A running average of the time that ColdFusion MX spends on database-related processing of ColdFusion requests.
Bytes In/Sec	Bytes incoming per second	The number of bytes that ColdFusion MX read in the last second (not an average).
Bytes Out/Sec	Bytes outgoing per second	The number of bytes that ColdFusion MX wrote in the last second (not an average).

Before you use the cfstat utility, ensure that you selected the Enable Performance Monitoring check box in the ColdFusion MX Administrator (on the Debugging & Logging > Debugging Settings page). If you select this check box, you must restart ColdFusion MX for this change to take effect.

Your cfusionmx\bin directory contains the cfstat utility. From that directory, type cfstat and use the following available switches:

Switch	Description/Comment
-n	Suppress column headers (useful for saving output to a file).
-s	Display output in a single line (delay display of the first line so cfstat can display meaningful values in the per-second counters).
#	Where # is an integer, delay display output by # seconds. If you do not specify an integer, cfstat returns one line.
-h	Web server hostname (localhost is the default).
-p	Web server listening port number (80 is the default).


Contents > Configuring and Administering ColdFusion MX > Basic ColdFusion MX Administration > Debugging & Logging section > Debugging Settings page Using the cfstat utility

Version 6.1

Comments are no longer accepted for ColdFusion MX 6.1. ColdFusion 8 is the current version.