Struct StatusPayloadBuilder 

pub struct StatusPayloadBuilder<S: State = Empty> { /* private fields */ }

Use builder syntax to set the inputs and finish with build().

Implementations

impl<S: State> StatusPayloadBuilder<S>

pub fn build(self) -> StatusPayload

where S: IsComplete,

Finish building and return the requested object

pub fn health( self, value: Vec<HealthCheck>, ) -> StatusPayloadBuilder<SetHealth<S>>

where S::Health: IsUnset,

Required.

Per-check breakdown. A push without a health array is the legacy Tamanu direct-report format: it is treated as the tamanu source reporting a single always-passing tasks heartbeat check. May be empty ([]) for a source that genuinely runs no checks — which recovers every check it previously reported. Each entry must include a non-empty check name and exactly one of result / healthy; any additional fields per check (latency, free disk %, certificate expiry, etc.) are passed through verbatim and shown in the status UI.

Every check name seen — whatever its result — is added to the operator-facing check catalog, where the policy grading its results can be reviewed and adjusted. A check whose effective result is failed or warning opens (or keeps open) its issue; a broken check keeps the same issue open, retaining a known failure’s contribution while warning the check itself is broken; effective passed and skipped results open nothing and close prior issues.

pub fn healthy(self, value: bool) -> StatusPayloadBuilder<SetHealthy<S>>

where S::Healthy: IsUnset,

Optional (Some / Option setters). Overall self-reported health of the server. Absent means true, so senders that predate this field are never treated as unhealthy by omission. Recorded for historical analysis and display, but not consulted for incident or severity decisions — those are derived from the per-check results in health, with each check’s severity controlled by an operator-managed catalog.

pub fn maybe_healthy( self, value: Option<bool>, ) -> StatusPayloadBuilder<SetHealthy<S>>

where S::Healthy: IsUnset,

Optional (Some / Option setters). Overall self-reported health of the server. Absent means true, so senders that predate this field are never treated as unhealthy by omission. Recorded for historical analysis and display, but not consulted for incident or severity decisions — those are derived from the per-check results in health, with each check’s severity controlled by an operator-managed catalog.

pub fn source(self, value: String) -> StatusPayloadBuilder<SetSource<S>>

where S::Source: IsUnset,

Optional (Some / Option setters). The name of the source pushing this status: the reporting agent, e.g. alertd. Multiple sources may report on one server, each with its own set of checks; a source’s push only opens and recovers its own checks.

Transitionally optional: this field will become mandatory. A push without a source is attributed to alertd; new reporters must send their own name. Must be a non-empty string; the names canopy and manual are reserved for canopy itself and are rejected.

pub fn maybe_source( self, value: Option<String>, ) -> StatusPayloadBuilder<SetSource<S>>

where S::Source: IsUnset,

Optional (Some / Option setters). The name of the source pushing this status: the reporting agent, e.g. alertd. Multiple sources may report on one server, each with its own set of checks; a source’s push only opens and recovers its own checks.

Transitionally optional: this field will become mandatory. A push without a source is attributed to alertd; new reporters must send their own name. Must be a non-empty string; the names canopy and manual are reserved for canopy itself and are rejected.