Rules

MMO\admin\monitoring · 1 symbol · generated 27 Oct 2026

class

Rules

The thresholds a reading is judged by: a metric above its warning raises the reading to a warning, above its critical to critical -- below, for a rule that says below (days left on a certificate).

class MMO\admin\monitoring\Rules

Namespace: MMO\admin\monitoring
See: DEFAULTS are what a hub gets without saying anything. A hub's own rules (hub.json, rules) come first: a rule of its own for the same metric and probe replaces the default one, "off": true removes it, and subjects narrows a rule to some servers or targets -- the one client whose disk is meant to be full.

A metric is named by a glob (`fnmatch`): `disk.*.usedPercent` is every disk.

$rules = new Rules([['metric' => 'disk.*.usedPercent', 'warning' => 70, 'critical' => 85]]); $rules->apply($reading); // raises $reading's status, fills $reading->alerts

Index

	DEFAULTS	probe => list of rules: what every hub watches unless it says otherwise
	rules
	all()
	apply($reading)	Judge a reading: raise its status, list what crossed a line in its `alerts`.
	debugName()
	format($value)
	forProbe($probe)
	judge($rule, $value)
	matchesSubject($subject, $name, $subjects)
	starred($glob, $metric)
	__construct($rules)

Constants1

DEFAULTS

probe => list of rules: what every hub watches unless it says otherwise

const DEFAULTS = […6 items]

Properties1

rules

protected array $rules = []

Type: array

Methods9

all()

Rules.php:81

function all(): array

returns

array

list<array<string, mixed>>> every rule, by probe

apply($reading)

Rules.php:88

Judge a reading: raise its status, list what crossed a line in its alerts.

function apply(MMO\admin\monitoring\Reading $reading): MMO\admin\monitoring\Reading

$reading	Reading
returns	Reading	the same

debugName()

Rules.php:75

function debugName(): string

returns

string

format($value)

Rules.php:140

protected function format(int|float $value): string

$value	int \| float
returns	string

forProbe($probe)

Rules.php:78

function forProbe(string $probe): array

$probe	string
returns	array	mixed>> the rules judging $probe's readings

judge($rule, $value)

Rules.php:116

function judge(array $rule, float $value): ?string

$rule	array
$value	float
returns	null \| string	the level $value reaches under $rule, null for none

matchesSubject($subject, $name, $subjects)

Rules.php:127

protected function matchesSubject(string $subject, string $name, array $subjects): bool

$subject	string
$name	string
$subjects	array	names or globs, `server:ovh*` or a bare name
returns	bool

starred($glob, $metric)

Rules.php:135

protected function starred(string $glob, string $metric): string

$glob	string
$metric	string
returns	string	what the `` of $glob stands for in $metric: `disk..usedPercent`, `disk.var-www.usedPercent` is `var-www`

__construct($rules)

Rules.php:59

function __construct(array $rules = [])

$rules = []

array