mod planning_capacity¶
- module planning_capacity¶
Advisory scheduler capacity from a captured, normalized observation.
Allocatable resources are scheduler-effective capacities before allocation. This module performs no scheduler calls and never grants storage admission.
Functions
- fn inspect(bytes: &[u8], request: &CapacityRequest, evaluated_at: &str, max_age_seconds: u64) -> Result<Value>¶
Summarize one captured normalized snapshot without exposing node names.
Unknown resources, unknown states and inactive requested features contribute no free slots. Queue-eligible configured capacity is separate from capacity free at the observation. Pending demand is not subtracted as a placement or queue-time prediction.
Errors
The document, resource request or timestamp is invalid, the observation is stale/future-dated, or resource sums overflow.
Structs and Unions
- struct CapacityRequest¶
One single-node resource request, scoped to an exact scheduler route.
- partition: String¶
Exact partition; no fallback partition is selected.
- host_target: String¶
Maintained physical-host profile label, not a runtime ISA attestation.
- features: BTreeSet<String>¶
Literal features required together, without expression rewriting.
- cpus: u64¶
CPUs required on one node.
- memory_mib: u64¶
Scheduler memory required on one node, in MiB.
- gpus: u64¶
GPUs required on one node; zero is a CPU request.
- gpu_type: Option<String>¶
Optional homogeneous GPU type required by the request.
- exclusive_node: Option<bool>¶
Resolved whole-node policy; absent means partition policy is unknown.
- max_slots_per_node: Option<u64>¶
Explicit per-node slot ceiling, independent of free resource totals.
Implementations
- impl CapacityRequest¶