Struct ProcStatus 

pub struct ProcStatus {
    pub state: ProcState,
    pub ready: Option<bool>,
    pub pid: Option<u32>,
    pub uptime_secs: Option<u64>,
    pub version: Option<String>,
    pub detail: Option<String>,
    pub endpoints: BTreeMap<String, String>,
    pub metrics: BTreeMap<String, f64>,
}

A workload’s self-description. Only Self::state is required.

Field-for-field the same document yah-cloud’s proc_control client parses; the two types are separate only because neither side may force its dependencies on the other.

Fields

state: ProcState

Lifecycle state, in kamaji’s vocabulary.

ready: Option<bool>

Redundant convenience mirror of state == running, accepted from producers that emit it. Never trusted over state — a document claiming {"state":"starting","ready":true} is a producer bug, and believing the optimistic half of it is how a supervisor reports a half-booted process as up.

pid: Option<u32>

Process id. Stamped by ControlServer when the producer leaves it unset — the helper knows its own pid and cannot get it wrong.

uptime_secs: Option<u64>

Seconds since the process considered itself started. Stamped by ControlServer (from when the control server was started) when the producer leaves it unset.

version: Option<String>

Build/version string, for an operator staring at two of these.

detail: Option<String>

One human line elaborating on state — “replaying WAL 3/7”, “waiting for GPU”. This is the field that replaces log-grepping.

endpoints: BTreeMap<String, String>

Named addresses the process serves — {"http":"http://127.0.0.1:4325"}. A portless process may legitimately name a non-URL surface here.

metrics: BTreeMap<String, f64>

Numeric gauges the process wants surfaced. Free-form on purpose: this is a status channel, not a metrics pipeline.

Implementations

impl ProcStatus

pub fn new(state: ProcState) -> Self

A document reporting state and nothing else.

pub fn with_detail(self, detail: impl Into<String>) -> Self

The one human line that replaces log-grepping.

pub fn with_version(self, version: impl Into<String>) -> Self

Build/version string. env!("CARGO_PKG_VERSION") is the usual argument.

pub fn with_pid(self, pid: u32) -> Self

Override the pid the server would otherwise stamp — for a producer that supervises something other than itself.

pub fn with_uptime_secs(self, secs: u64) -> Self

Override the uptime the server would otherwise stamp.

pub fn with_endpoint( self, name: impl Into<String>, addr: impl Into<String>, ) -> Self

Name an address this process serves. A portless process may legitimately name a non-URL surface ("gui" -> "winit://main").

pub fn with_metric(self, name: impl Into<String>, value: f64) -> Self

Surface a numeric gauge.

pub fn is_ready(&self) -> bool

Ready iff the state says so. See Self::ready for why the producer-supplied boolean does not get a vote.

pub fn summary(&self) -> String

One-line rendering for an operator-facing note or log line.

Trait Implementations

impl Clone for ProcStatus

fn clone(&self) -> ProcStatus

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProcStatus

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ProcStatus

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ProcStatus

fn eq(&self, other: &ProcStatus) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ProcStatus

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ProcStatus