Inheritance diagram for InspectingStatHist:

Collaboration diagram for InspectingStatHist:

Public Types
typedef uint64_t	bins_type

Public Member Functions
bool	operator== (const InspectingStatHist &)

bins_type	counter (double v)

double	deltaPctile (const StatHist &B, double pctile) const

double	val (unsigned int bin) const

void	count (double val)

void	dump (StoreEntry sentry, StatHistBinDumper bd) const

void	logInit (unsigned int capacity, double min, double max)

void	enumInit (unsigned int last_enum)

StatHist &	operator+= (const StatHist &B)

Protected Member Functions
void	init (unsigned int capacity, hbase_f val_in, hbase_f val_out, double min, double max)

unsigned int	findBin (double v)

Protected Attributes
bins_type *	bins = nullptr
	the histogram counters

unsigned int	capacity_ = 0

double	min_ = 0.0
	minimum value to be stored, corresponding to the first bin

double	max_ = 0.0
	value of the maximum counter in the histogram

double	scale_ = 1.0
	scaling factor when looking for a bin

hbase_f *	val_in = nullptr

hbase_f *	val_out = nullptr

Detailed Description

Definition at line 36 of file testStatHist.cc.

Member Typedef Documentation

◆ bins_type

typedef uint64_t StatHist::bins_type

inherited

Definition at line 44 of file StatHist.h.

Member Function Documentation

◆ count()

void StatHist::count ( double val )

inherited

increment the counter for the histogram entry associated to the supplied value

Definition at line 55 of file StatHist.cc.

References StatHist::bins, and StatHist::findBin().

Referenced by CacheDigest::add(), clientUpdateHierCounters(), clientUpdateStatHistCounters(), Comm::DoSelect(), Comm::Incoming::finishPolling(), fqdncacheHandleReply(), httpHdrCcUpdateStats(), icpCount(), ipcacheHandleReply(), recordMemBlobSizeAtDestruct(), recordSBufSizeAtDestruct(), TestStatHist::testStatHistBaseAssignment(), TestStatHist::testStatHistBaseEquality(), TestStatHist::testStatHistLog(), TestStatHist::testStatHistSum(), and HttpHdrScTarget::updateStats().

◆ counter()

bins_type InspectingStatHist::counter ( double v )

inline

Definition at line 40 of file testStatHist.cc.

References StatHist::bins, and StatHist::findBin().

Referenced by TestStatHist::testStatHistLog().

◆ deltaPctile()

double StatHist::deltaPctile	(	const StatHist &	B,
		double	pctile
	)		const

inherited

Calculate the percentile for value pctile for the difference between this and the supplied histogram.

Definition at line 103 of file StatHist.cc.

References assert, StatHist::bins, StatHist::capacity_, int, s1, StatHist::val(), xcalloc(), and xfree.

Referenced by statHistDeltaPctile().

◆ dump()

void StatHist::dump	(	StoreEntry *	sentry,
		StatHistBinDumper *	bd
	)		const

inherited

iterate the supplied bd function over the histogram values

Definition at line 171 of file StatHist.cc.

References assert, StatHist::bins, StatHist::capacity_, StatHist::min_, statHistBinDumper, and StatHist::val().

Referenced by commIncomingStats(), commIncomingStats(), commIncomingStats(), commIncomingStats(), SBufStatsAction::dump(), httpHeaderStatDump(), and statCountersHistograms().

◆ enumInit()

void StatHist::enumInit ( unsigned int last_enum )

inherited

initialize the histogram to count occurrences in an enum-represented set

Definition at line 235 of file StatHist.cc.

References StatHist::init(), and Math::Null.

Referenced by HttpHeaderStat::HttpHeaderStat(), HttpHeaderStat::HttpHeaderStat(), Comm::Incoming::init(), statCountersInitSpecial(), TestStatHist::testStatHistBaseAssignment(), and TestStatHist::testStatHistBaseEquality().

◆ findBin()

unsigned int StatHist::findBin ( double v )

protectedinherited

find what entry in the histogram corresponds to v, by applying the preset input transformation function

Definition at line 64 of file StatHist.cc.

References StatHist::capacity_, StatHist::min_, StatHist::scale_, and StatHist::val_in.

Referenced by StatHist::count(), and counter().

◆ init()

void StatHist::init	(	unsigned int	capacity,
		hbase_f *	val_in,
		hbase_f *	val_out,
		double	min,
		double	max
	)

protectedinherited

low-level initialize function. called by *Init high-level functions

Note: Important restrictions on val_in and val_out functions:

val_in: ascending, defined on [0, oo), val_in(0) == 0;
val_out: x == val_out(val_in(x)) where val_in(x) is defined

In practice, the requirements are less strict, but then it gets hard to define them without math notation. val_in is applied after offsetting the value but before scaling See log and linear based histograms for examples

Definition at line 26 of file StatHist.cc.

References assert, StatHist::bins, StatHist::capacity_, StatHist::max_, StatHist::min_, StatHist::scale_, StatHist::val_in, StatHist::val_out, and xcalloc().

Referenced by StatHist::enumInit(), and StatHist::logInit().