User Guide

Debugging & Logging section 29
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.