Struct TuningInfo 

pub struct TuningInfo {
    pub memory_source: String,
    pub available_bytes: usize,
    pub model_rss_bytes_per_worker: usize,
    pub worst_case_peak_bytes: usize,
    pub utilization_pct: f64,
}

Static workspace memory info surfaced by the /health endpoint.

Written once to AppState::tuning immediately after memory detection. The cost-model fields (a, b, max_workspace_bytes) are served dynamically from AppState::cost_model so they reflect the live probe result rather than the initial conservative defaults.

Fields

memory_source: String

Where the available-memory reading came from.

available_bytes: usize

Total available bytes detected at startup.

model_rss_bytes_per_worker: usize

Measured model session RSS delta (bytes) — max across all workers.

Accurate on Linux via /proc/self/status; 0 on other platforms.

worst_case_peak_bytes: usize

Worst-case total peak memory (bytes) when all workers run simultaneously at their per-worker workspace ceiling.

Formula: cfg_workers × per_worker_workspace + cfg_workers × model_rss + OS_HEADROOM.

utilization_pct: f64

Worst-case peak as a percentage of detected available memory.

A value above 90% triggers a startup WARN log.

Implementations

impl TuningInfo

pub fn new( mem: &MemoryReading, model_rss_per_worker: usize, worst_case_peak_bytes: usize, utilization_pct: f64, ) -> Self

Creates a TuningInfo from a memory reading and probe measurements.

pub fn unknown(model_rss_per_worker: usize) -> Self

Convenience builder for the case where memory detection was not possible (macOS without cgroup support, or probe disabled).

Trait Implementations

impl Clone for TuningInfo

fn clone(&self) -> TuningInfo

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TuningInfo

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Serialize for TuningInfo

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.