MediaWiki REL1_37
SamplingStatsdClient Class Reference

A statsd client that applies the sampling rate to the data items before sending them. More...

Inheritance diagram for SamplingStatsdClient:
Collaboration diagram for SamplingStatsdClient:

Public Member Functions

 appendSampleRate ( $data, $sampleRate=1)
 Sets sampling rate for all items in $data.
 
 send ( $data, $sampleRate=1)
 Send the metrics over UDP Sample the metrics according to their sample rate and send the remaining ones.
 
 setSamplingRates (array $samplingRates)
 Sampling rates as an associative array of patterns and rates.
 

Protected Member Functions

 sampleData ( $data)
 Throw away some of the data according to the sample rate.
 
 throwException (Exception $exception)
 

Protected Attributes

 $samplingRates = []
 

Detailed Description

A statsd client that applies the sampling rate to the data items before sending them.

Since
1.26

Definition at line 32 of file SamplingStatsdClient.php.

Member Function Documentation

◆ appendSampleRate()

SamplingStatsdClient::appendSampleRate (   $data,
  $sampleRate = 1 
)

Sets sampling rate for all items in $data.

The sample rate specified in a StatsdData entity overrides the sample rate specified here.

Definition at line 52 of file SamplingStatsdClient.php.

References $samplingRates.

Referenced by send().

◆ sampleData()

SamplingStatsdClient::sampleData (   $data)
protected

Throw away some of the data according to the sample rate.

Parameters
StatsdDataInterface[]$data
Returns
StatsdDataInterface[]
Exceptions
LogicException

Definition at line 131 of file SamplingStatsdClient.php.

Referenced by send().

◆ send()

SamplingStatsdClient::send (   $data,
  $sampleRate = 1 
)

Send the metrics over UDP Sample the metrics according to their sample rate and send the remaining ones.

Parameters
StatsdDataInterface | StatsdDataInterface[]$datamessage(s) to sent strings are not allowed here as sampleData requires a StatsdDataInterface
int$sampleRate
Returns
int the data sent in bytes

Definition at line 82 of file SamplingStatsdClient.php.

References appendSampleRate(), sampleData(), and throwException().

◆ setSamplingRates()

SamplingStatsdClient::setSamplingRates ( array  $samplingRates)

Sampling rates as an associative array of patterns and rates.

Patterns are Unix shell patterns (e.g. 'MediaWiki.api.*'). Rates are sampling probabilities (e.g. 0.1 means 1 in 10 events are sampled).

Parameters
array$samplingRates
Since
1.28

Definition at line 42 of file SamplingStatsdClient.php.

References $samplingRates.

◆ throwException()

SamplingStatsdClient::throwException ( Exception  $exception)
protected

Definition at line 152 of file SamplingStatsdClient.php.

Referenced by send().

Member Data Documentation

◆ $samplingRates

SamplingStatsdClient::$samplingRates = []
protected

Definition at line 33 of file SamplingStatsdClient.php.

Referenced by appendSampleRate(), and setSamplingRates().


The documentation for this class was generated from the following file: