avail/avail.performance/PerInterpreterStatistic

PerInterpreterStatistic

class PerInterpreterStatistic : Comparable<PerInterpreterStatistic>

A PerInterpreterStatistic is an incremental, summarized recording of a set of integral values and times. It is synchronized, although the typical usage is that it will only be written by a single Thread at a time, and read by another Thread only rarely.

If you want to record samples from multiple processes, use a Statistic, which holds a PerInterpreterStatistic for up to AvailRuntimeConfiguration.maxInterpreters separate Threads to access, without any locks.

Author

Mark van Gulik

Parameters

count

The number of samples.

min

The minimum sample.

max

The maximum sample.

mean

The mean of the samples.

sumOfDeltaSquares

The sum of squares of differences of the samples from the mean.

Functions

clear

fun clear()

Reset this statistic as though no samples had ever been recorded.

compareTo

open operator override fun compareTo(other: PerInterpreterStatistic): Int

Default sort is descending by sum.

describeOn

fun describeOn(builder: StringBuilder, unit: ReportingUnit)

Describe this statistic as though its samples are durations in nanoseconds.

record

fun record(sample: Double)

Record a new sample, updating any cumulative statistical values. This is thread-safe. However, the locking cost is very low due to a spinlock, as long as there's very low contention. Since Statistic partitions use of PerInterpreterStatistics by Interpreter (and hence by Thread), the contention is non-existent, except when accumulating stats to print.