Getting ColdFusion Server Metrics

December 15, 2003 by Pete Freitag

The often forgotten function GetMetricData() function returns the same info as the cfstat utility. Here's an example:

<cfset metrics = GetMetricData("PERF_MONITOR")>
<cfoutput>
  ColdFusion Server Metrics: <br>
  <br>
  InstanceName: #metrics.InstanceName# <br>
  PageHits: #metrics.PageHits# <br>
  ReqQueued: #metrics.ReqQueued# <br>
  DBHits: #metrics.DBHits# <br>
  ReqRunning: #metrics.ReqRunning# <br>
  ReqTimedOut: #metrics.ReqTimedOut# <br>
  BytesIn: #metrics.BytesIn# <br>
  BytesOut: #metrics.BytesOut# <br>
  AvgQueueTime: #metrics.AvgQueueTime# <br>
  AvgReqTime: #metrics.AvgReqTime# <br>
  AvgDBTime: #metrics.AvgDBTime# <br>
  CachePops: #metrics.CachePops# <br>
  Simple Load: #GetMetricData("SIMPLE_LOAD")#<br>
  Prev Request Time: #GetMetricData("PREV_REQ_TIME")#ms<br>
  Avg Request Time: #GetMetricData("AVG_REQ_TIME")#ms<br>
</cfoutput>

I had always thought it would be interesting to write a scheduled task to record these values in a database, and then generate reports.