perfObject
A perf object summarises Spiral’s optimisation activity over the past second. It is reported on the
error / monitoring stream and is the primary signal of engine
health: the current gear, the size of the working set, and the backlog still to be processed.
{
"time": <string>,
"gear": <integer>,
"stops": <integer>,
"todo": { i, u, s },
"Pos/Soln": <real>,
"Soln/Sec": <real>,
"travelCache": { hit, fin, entries, routes, fill } | null,
}
-
timestring - The engine clock at the time of the report (HH:MM:SS; a leading "!" marks simulated time).
-
gearinteger - The current optimisation gear (effort level) Spiral is running at.
-
stopsinteger - Stops currently in the working set.
-
todo{ i, u, s } - Backlog counts still to process: i = inserts, u = updates, s = solutions.
-
Pos/Solnreal - Positions examined per solution over the period.
-
Soln/Secreal - Solutions produced per second over the period.
-
travelCache{ hit, fin, entries, routes, fill } - Travel-calculator cache statistics: hit / fin are hit ratios, entries / routes are cache sizes, fill is the fill ratio.