Module stats 

Stats server for the flow scheduler.

Copyright (c) 2026 Galih Tama galpt@v.recipes Exports the counters view plus the dashboard view from the BPF maps. The stats server carries deltas while the dashboard carries raw counters plus per CPU cards for the loopback page.

Re-exports

use std::io::Write; 🔒

use std::sync::Arc; 🔒

use std::sync::atomic::AtomicBool; 🔒

use std::sync::atomic::Ordering; 🔒

use std::time::Duration; 🔒

use anyhow::Result; 🔒

use scx_stats_derive::Stats; 🔒

use scx_stats_derive::stat_doc; 🔒

use serde::Deserialize; 🔒

use serde::Deserialize; 🔒

use serde::Serialize; 🔒

use serde::Serialize; 🔒

use scx_stats::prelude::*; 🔒

Structs

Metrics

Counters with placement, admission, and miss detail. BPF holds 17 counters, Rust adds display-only uptime for eighteen.

PerCpuMetrics

One card of the per CPU grid. Id plus SMT stay fixed while pid plus slice refresh on each poll. Pid holds zero when idle and slice holds the shared quantum. SMT marks the second thread of one core for display only with no placement use and false on old JSON.

WebMetrics

Snapshot for the web dashboard. Counters stay raw with the on CPU gauge plus the live pid view. The run loop pushes one per poll and the web thread keeps the newest behind a lock for the page plus the JSON routes.

Functions

monitor

Stats printer loop for the monitor flag. Polls the stats server on the interval with plain text lines.

server_data

Server data for the stats server. A single top op reports interval deltas of the counters.