File: ProbabilisticSampler.php

package info (click to toggle)
mediawiki 1%3A1.43.3%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 417,464 kB
  • sloc: php: 1,062,949; javascript: 664,290; sql: 9,714; python: 5,458; xml: 3,489; sh: 1,131; makefile: 64
file content (37 lines) | stat: -rw-r--r-- 927 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
<?php
namespace Wikimedia\Telemetry;

use Wikimedia\Assert\Assert;

/**
 * A {@link SamplerInterface} implementation that samples a given percentage of root spans,
 * while respecting sampling decisions made by other samplers for a given trace.
 *
 * @since 1.43
 * @internal
 */
class ProbabilisticSampler implements SamplerInterface {
	/**
	 * The chance of sampling a root span, as a percentage (0-100).
	 * @var int
	 */
	private int $percentChance;

	public function __construct( int $percentChance ) {
		Assert::parameter(
			$percentChance >= 0 && $percentChance <= 100,
			'$percentChance',
			'must be between 0 and 100 inclusive'
		);
		$this->percentChance = $percentChance;
	}

	/** @inheritDoc */
	public function shouldSample( ?SpanContext $parentSpanContext ): bool {
		if ( $parentSpanContext !== null ) {
			return $parentSpanContext->isSampled();
		}

		return mt_rand( 1, 100 ) <= $this->percentChance;
	}
}