Name

GetMetricData

Synopsis

                  
                  GetMetricData(mode)

Depending on mode, returns data representing information about the performance of the ColdFusion server. The following modes may be used by GetMetricData( ):

Perf_Monitor

Returns a ColdFusion structure containing Performance Monitor data (Windows NT) or CFSTAT data (on Unix/Linux). For this mode to work on Windows NT systems, the Enable Performance Monitoring option must be checked in the Debugging section of the ColdFusion Administrator.

Simple_Load

Returns a number representing the load on the server. This number is produced by an internal algorithm based on ColdFusion queue depths.

Prev_Req_Time

Returns a number representing the previous request time in milliseconds. This metric can calculate server load using the formula:

Load (as a percentage) = Prev_Req_Time / Max_Allowable_Response_Time_In_Milliseconds * 100

Avg_Req_Time

Returns a number representing the average request time in milliseconds. This metric can calculate load using the formula:

Load (as a percentage) = Avg_Req_Time / Max_Allowable_Response_Time_In_Milliseconds * 100

If mode is set to Perf_Monitor, GetMetricData( ) returns a structure containing the following key/value pairs:

AvgDBTime

Length of time in milliseconds averaged over the current and previous request that ColdFusion took to process queries.

AvgQueueTime

Length of time in milliseconds (averaged over the current and previous request), that the request spent in the staging queue.

AvgReqTime

Length ...

Get Programming ColdFusion MX, 2nd Edition now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.

Start your free trial