Convenience class for working with XHProf profiling data https://github.com/phacility/xhprof. More...

Public Member Functions
	__construct (array $data, array $config=[])
	Configuration data can contain:

	getCallees ( $function)
	Get a list of all callees from a given function.

	getCallers ( $function)
	Get a list of all callers of a given function.

	getCompleteMetrics ()
	Get the inclusive and exclusive metrics for each function call.

	getCriticalPath ( $metric='wt')
	Find the critical path for the given metric.

	getInclusiveMetrics ()
	Get the inclusive metrics for each function call.

	getRawData ()
	Get raw data collected by xhprof.

Static Public Member Functions
static	makeSortFunction ( $key, $sub)
	Make a closure to use as a sort function.

static	splitKey ( $key)
	Convert an xhprof data key into an array of ['parent', 'child'] function names.

Protected Member Functions
	pruneData ( $data)
	Remove data for functions that are not included in the 'include' configuration array.

Protected Attributes
array[]	$complete
	Per-function inclusive and exclusive data.

array	$config

array[]	$hieraData
	Hierarchical profiling data returned by xhprof.

array[][]	$inclusive
	Per-function inclusive data.

Detailed Description

Convenience class for working with XHProf profiling data https://github.com/phacility/xhprof.

XHProf can be installed via PECL.

Note: © 2014 Wikimedia Foundation and contributors

Since: 1.28

Definition at line 18 of file XhprofData.php.

Constructor & Destructor Documentation

◆ __construct()

Wikimedia\XhprofData::__construct	(	array	$data,
		array	$config = [] )

Configuration data can contain:

include: Array of function names to include in profiling.
sort: Key to sort per-function reports on.

Parameters

array	$data	Xhprof profiling data, as returned by xhprof_disable()
array	$config

Definition at line 51 of file XhprofData.php.

Member Function Documentation

◆ getCallees()

Wikimedia\XhprofData::getCallees ( $function )

Get a list of all callees from a given function.

Parameters

string $function Function name

Returns: array

See also: getEdges()

Definition at line 307 of file XhprofData.php.

◆ getCallers()

Wikimedia\XhprofData::getCallers ( $function )

Get a list of all callers of a given function.

Parameters

string $function Function name

Returns: array

See also: getEdges()

Definition at line 291 of file XhprofData.php.

◆ getCompleteMetrics()

Wikimedia\XhprofData::getCompleteMetrics ( )

Get the inclusive and exclusive metrics for each function call.

In addition to the normal data contained in the inclusive metrics, the metrics have an additional 'exclusive' measurement which is the total minus the totals of all child function calls.

Returns: array[]

See also: getRawData(); getInclusiveMetrics()

Definition at line 234 of file XhprofData.php.

◆ getCriticalPath()

Wikimedia\XhprofData::getCriticalPath ( $metric = 'wt' )

Find the critical path for the given metric.

Parameters

string $metric Metric to find critical path for

Returns: array

Definition at line 322 of file XhprofData.php.

References $path.

◆ getInclusiveMetrics()

Wikimedia\XhprofData::getInclusiveMetrics ( )

Get the inclusive metrics for each function call.

Inclusive metrics for given function include the metrics for all functions that were called from that function during the measurement period.

See getRawData() for a description of the metric that are returned for each function call. The values for the wt, cpu, mu and pmu metrics are arrays with these values:

total: Cumulative value
min: Minimum value
mean: Mean (average) value
max: Maximum value
variance: Variance (spread) of the values

Returns: array[][]

See also: getRawData(); getCompleteMetrics()

Definition at line 147 of file XhprofData.php.

◆ getRawData()

Wikimedia\XhprofData::getRawData ( )

Get raw data collected by xhprof.

Each key in the returned array is an edge label for the call graph in the form "caller==>callee". There is once special case edge labeled simply "main()" which represents the global scope entry point of the application.

XHProf will collect different data depending on the flags that are used:

ct: Number of matching events seen.
wt: Inclusive elapsed wall time for this event in microseconds.
cpu: Inclusive elapsed cpu time for this event in microseconds. (XHPROF_FLAGS_CPU)
mu: Delta of memory usage from start to end of callee in bytes. (XHPROF_FLAGS_MEMORY)
pmu: Delta of peak memory usage from start to end of callee in bytes. (XHPROF_FLAGS_MEMORY)
alloc: Delta of amount memory requested from malloc() by the callee, in bytes. (XHPROF_FLAGS_MALLOC)
free: Delta of amount of memory passed to free() by the callee, in bytes. (XHPROF_FLAGS_MALLOC)

Returns: array

See also: getInclusiveMetrics(); getCompleteMetrics()

Definition at line 86 of file XhprofData.php.

◆ makeSortFunction()

static Wikimedia\XhprofData::makeSortFunction	(		$key,
			$sub )

static

Make a closure to use as a sort function.

The resulting function will sort by descending numeric values (largest value first).

Parameters

string	$key	Data key to sort on
string	$sub	Sub key to sort array values on

Returns: Closure

Definition at line 357 of file XhprofData.php.

◆ pruneData()

Wikimedia\XhprofData::pruneData ( $data )

protected

Remove data for functions that are not included in the 'include' configuration array.

Parameters

array[] $data Raw xhprof data

Returns: array[]

Definition at line 111 of file XhprofData.php.

◆ splitKey()

static Wikimedia\XhprofData::splitKey ( $key )

static

Convert an xhprof data key into an array of ['parent', 'child'] function names.

The resulting array is left padded with nulls, so a key with no parent (eg 'main()') will return [null, 'function'].

Parameters

string $key

Returns: array{0:?string,1:string}

Definition at line 100 of file XhprofData.php.

Member Data Documentation

◆ $complete

array [] Wikimedia\XhprofData::$complete

protected

Per-function inclusive and exclusive data.

Definition at line 41 of file XhprofData.php.

◆ $config

array Wikimedia\XhprofData::$config

protected

Definition at line 23 of file XhprofData.php.

◆ $hieraData

array [] Wikimedia\XhprofData::$hieraData

protected

Hierarchical profiling data returned by xhprof.

Definition at line 29 of file XhprofData.php.

◆ $inclusive

array [][] Wikimedia\XhprofData::$inclusive

protected

Per-function inclusive data.

Definition at line 35 of file XhprofData.php.

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

includes/libs/XhprofData.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ getCallees()

◆ getCallers()

◆ getCompleteMetrics()

◆ getCriticalPath()

◆ getInclusiveMetrics()

◆ getRawData()

◆ makeSortFunction()

◆ pruneData()

◆ splitKey()

Member Data Documentation

◆ $complete

◆ $config

◆ $hieraData

◆ $inclusive