Struct Telemetry

Source

pub struct Telemetry {
    pub device_read_errors: Gauge,
    pub energy_mj: Counter,
    pub energy_counter_raw: Gauge,
    pub energy_resets: Counter,
    pub energy_wraps: Counter,
    pub tokens: Counter,
    pub joules_per_token_live: GaugeF64,
    pub kernel: KernelInstruments,
    pub sched: SchedInstruments,
    pub spec: SpecMatrix,
    pub spec_confidence: ConfidenceOutcomes,
    pub requests: RequestInstruments,
    /* private fields */
}

Fields§

§device_read_errors: Gauge§energy_mj: Counter§energy_counter_raw: Gauge§energy_resets: Counter§energy_wraps: Counter§tokens: Counter§joules_per_token_live: GaugeF64§kernel: KernelInstruments§sched: SchedInstruments§spec: SpecMatrix§spec_confidence: ConfidenceOutcomes§requests: RequestInstruments

Implementations§

Source §

impl Telemetry

Source

pub const fn new(clock: &'static dyn Clock) -> Self

2026-09-26: A set at level Off over clock. Allocates nothing.

Source

pub fn configure(&self, cfg: &TelemetryConfig)

2026-09-26: Apply a validated configuration and disarm kernel spans. The energy ring is allocated here, on the first call at Basic or above, and never again.

Source

pub fn level(&self) -> Level

Source

pub fn set_phase_names(&self, names: &'static [&'static str])

2026-09-26: Name the loop phases phase indexes, keeping at most MAX_PHASES. The first call wins.

Source

pub fn phase_names(&self) -> &'static [&'static str]

Source

pub fn tokens(&self, n: u64)

2026-09-26: n more tokens were produced.

Source

pub fn phase(&self, idx: usize, since: Instant)

2026-09-26: Loop phase idx ran from since until now. An idx of MAX_PHASES or more lands in the last histogram.

Source

pub fn sched_tick(&self, shape: &SchedShape)

2026-09-26: This tick’s scheduler shape.

Source

pub fn spec_verified(&self, drafts: usize, accepted: usize)

2026-09-26: A verify step checked drafts drafts and accepted accepted.

Source

pub fn spec_draft_confidence(&self, lp: f32, accepted: bool)

2026-10-04: A verify step reached a draft whose drafter top-1 log-probability was lp, and accepted it or not.

Source

pub fn request_finished(&self, r: &RequestTiming)

2026-09-26: A request finished. Its energy is attributed from the ring window its lifetime spans, only while the device layer is available.

Source

pub fn step_begin(&self) -> bool

2026-09-26: A scheduler step begins. At level Kernel, arms per-kernel spans on one step in kernel_span_every and returns whether this step is armed; below Kernel, returns false and changes nothing.

Source

pub fn kernel_spans_armed(&self) -> bool

2026-09-26: Whether the kernel launch path should bracket launches this step. Set by step_begin, cleared by configure.

Source

pub fn lane_spans(&self) -> bool

2026-09-26: Whether lane spans are recorded (level Kernel).

Source

pub fn lane_names(&self) -> &'static [&'static str]

Source

pub fn device_state(&self) -> DeviceState

Source

pub fn device_unavailable_reason(&self) -> Option<&str>

Source

pub fn mark_device_unavailable(&self, why: String)

2026-09-26: The device layer cannot read. The first why is kept for Telemetry::device_unavailable_reason.

Source

pub fn absorb_device( &self, tracker: &mut CounterTracker, reading: &DeviceReading, read_errors: u64, )

2026-09-26: Absorb one device reading: publish it and, when it carries the energy counter, advance the energy total; once the ring exists, also push a ring point pairing it with the tokens so far and update the live J/token.

Source