ns_intervalstats

Overview

Get server statistics for current interval

Syntax

ns_intervalstats ?-server servername? requests | HWM-queued | HWM-threads | busyconns | mintime | maxtime | avgtime | bytes

Description

ns_intervalstats returns statistics information gathered in the current interval, where an interval is defined as the period of time between two calls to ns_resetintervalstats, or the period of time from server startup to the first call to ns_resetintervalstats. If servername isn't specified, the current virtual server is used.

Any of the following statistics can be returned:

• requests: the number of requeusts queued

• HWM-queued: the maximum number (high water mark) of queued requests

• HWM-threads: the maximum number (high water mark) of threads in use

• busyconns: the number of connections rejected by the busy threads

• mintime: the minimum time, in seconds, taken to serve a connection

• maxtime: the longest time, in seconds, taken to serve a connection

• avgtime: the total connection time, in seconds, divided by the number of requests

• bytes: the total number of bytes served

The statistics that return a time are generally only useful for virtual servers that serve large and somewhat uniformly-sized items. Because simple pages serve so quickly, the minimum time usually hovers around zero.

Note that these statistics are not guaranteed to be 100% accurate - they are designed to give a general idea of server performance, and the gathering of the statistics favors minimal impact on performanace over perfect accuracy. Because of this, we recommend that you not use them to generate billing information.

Notes

You can, alternatively, use the CheckStats and CheckStatsInterval configuration parameters to gather interval statistics. We recommend, however, that you do not use both the Tcl interval functions (ns_intervalstats and ns_resetintervalstats) and the interval configuration parameters, because the interval parameters will reset the statistics underneath the Tcl functions and may cause unintended results.