CFStat is a free command-line tool that comes with ColdFusion (and has since its earliest releases: at least as far back as CF 4).

CFStat is accessible from the command line (in all operating systems supported by CF) in the [coldfusion]\bin directory, and provides several hi-level metrics on the status of the CF server. While rudimentary, they are far better than nothing when you are suffering problems and have no idea what's going on within CF.

With it, you can know: how many requests are running at a moment in time, and how many requests are queued. You can see how pages per second are running, as well as how many queries per second are running, and the highwater mark for each. There are a few more metrics, and several more still available for those running CF Enterprise (via the -x argument).

It also accepts as an argument a number, which will cause the CFSTAT line of information to be auto-refreshed after that many seconds, which can be helpful to watch the progress of these metrics over time.

More Information

For more information on these arguments, and on using CFStat in gneral, see the Adobe documentation, specifically this page. While that page is in the CF9 docs, the concepts apply just as well to CF 8 (or 7 or 6 and even older versions of CF.) It's an "oldie but a goodie".


Category: Tools