Node:Statistics, Previous:Session Information, Up:LysKOM Data Types

Statistics

        Stats ::=
              ( average      : FLOAT;
                ascent-rate  : FLOAT;
                descent-rate : FLOAT;
              )

        Stats-Description ::=
              ( what : ARRAY HOLLERITH;
                when : ARRAY INT32;
              )

The Stats structure returns information about a measured value.

average

The average is the average value for the measurement period. If the measurement period is 0, this is instead the current value.

ascent-rate

descent-rate

These fields indicate the activity for this value, measured in units per second. If the measured value is pending DNS requests, the ascent-rate would be the average number of issued requests per second, and the descent-rate would be the average number of received replies (or timeouts, errors, or other reasons why the request is no longer pending).

When calculating the ascent-rate, only events that cause the value to increase are considered. Likewise, the descent-rate only considers events that decrease the value.

Example: if the measurement period is 60 seconds, the value starts at 5, and it is increased by one 90 times and decreased by one 60 times during the measurement period, the value will of course be 35 when the period ends. The ascent rate will be 1.5 per second, and the descent rate 1.0 per second.

If the measurement period is 0, both ascent-rate and descent-rate are set to 0.

The Stats-Description structure returns information about what kind of statistical information that the server gathers. It contains these fields:

what

A list of all things that the server collect statistics about. Measured Properties, for a list of things that might be included in this list.

when

The statistics returned by get-stats is a number of values collected during various periods of time. This array contains the periods, measured in seconds. The value 0 means that the current value is returned. The values are only returned in ascending order, so if 0 is included it will be the first value. Measured Properties, for more info.