A factory for application metric data. More...

Inheritance diagram for BufferingStatsdDataFactory:

[legend]

Collaboration diagram for BufferingStatsdDataFactory:

[legend]

Public Member Functions
	__construct ( $prefix)

	clearData ()
	Clear all buffered data from the factory.

	getData ()

	getDataCount ()
	Return the number of buffered statsd data entries.

	hasData ()
	Check whether this data factory has any buffered data.

	produceStatsdData ( $key, $value=1, $metric=StatsdDataInterface::STATSD_METRIC_COUNT)

	setEnabled ( $enabled)
	Set collection enable status.

Protected Attributes
	$buffer = []

bool	$enabled = true
	Collection enabled?

Static Private Member Functions
static	normalizeMetricKey ( $key)
	Normalize a metric key for StatsD.

Private Attributes
string	$prefix

Detailed Description

A factory for application metric data.

This class prepends a context-specific prefix to each metric key and keeps a reference to each constructed metric in an internal array buffer.

Since: 1.25 @method StatsdData produceStatsdDataEntity()

Definition at line 36 of file BufferingStatsdDataFactory.php.

Constructor & Destructor Documentation

◆ __construct()

BufferingStatsdDataFactory::__construct ( $prefix )

Definition at line 48 of file BufferingStatsdDataFactory.php.

References $prefix.

Member Function Documentation

◆ clearData()

BufferingStatsdDataFactory::clearData ( )

Clear all buffered data from the factory.

Since: 1.31

Implements IBufferingStatsdDataFactory.

Definition at line 107 of file BufferingStatsdDataFactory.php.

◆ getData()

BufferingStatsdDataFactory::getData ( )

Since: 1.30

Returns: StatsdData[]

Implements IBufferingStatsdDataFactory.

Definition at line 103 of file BufferingStatsdDataFactory.php.

References $buffer.

◆ getDataCount()

BufferingStatsdDataFactory::getDataCount ( )

Return the number of buffered statsd data entries.

Returns: int

Since: 1.31

Implements IBufferingStatsdDataFactory.

Definition at line 111 of file BufferingStatsdDataFactory.php.

◆ hasData()

BufferingStatsdDataFactory::hasData ( )

Check whether this data factory has any buffered data.

Returns: bool

Implements IBufferingStatsdDataFactory.

Definition at line 95 of file BufferingStatsdDataFactory.php.

◆ normalizeMetricKey()

static BufferingStatsdDataFactory::normalizeMetricKey ( $key )

staticprivate

Normalize a metric key for StatsD.

Replace occurences of '::' with dots and any other non-alphanumeric characters with underscores. Combine runs of dots or underscores. Then trim leading or trailing dots or underscores.

Parameters

string $key