Struct ConfigStatus 

#[non_exhaustive]
pub struct ConfigStatus {
    pub generation: u64,
    pub loaded_at: Option<Instant>,
    pub last_reason: Option<ReloadReason>,
    pub last_failure: Option<FailureStatus>,
    pub consecutive_failures: u32,
}

What is true of a configuration right now, for an operator asking.

Every field is recorded where it happens rather than recomputed here, so building one is a handful of atomic loads: no I/O, no source is re-read, and nothing here can block. That is the constraint — an exporter calling this per scrape must cost nothing.

It is assembled from several loads, so a reload landing mid-call can leave one field an install ahead of another. The same trade SnapshotMeta makes, for the same reason: for operators, not for correctness.

What it does not carry

No values, by construction — see FailureStatus. And no source list: which sources would be read is a question about the next load, and check already answers it against the sources rather than from a cache of them that could go stale. Nor is there a last_success: an install is the success, so loaded_at is when the last one was.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

generation: u64

Installs since the process started; zero before the first.

loaded_at: Option<Instant>

When the serving snapshot was installed — which is also when the last successful load was. None before the first install.

last_reason: Option<ReloadReason>

Why the serving snapshot was installed. None before the first.

last_failure: Option<FailureStatus>

The most recent reload that installed nothing, if there has been one. Kept after a later success: it is history, and consecutive_failures is the health.

consecutive_failures: u32

Failures since the last install. Zero means healthy.

Implementations

impl ConfigStatus

pub fn is_healthy(&self) -> bool

Whether the last attempt to load installed something.

Nothing more than consecutive_failures == 0, spelled the way the question is asked. True before the first load too — nothing has failed yet.

pub fn stale_for(&self) -> Option<Duration>

How long ago the serving snapshot was installed.

None before the first install. This is why the recorded instant is monotonic: a wall clock going backwards under NTP would make a fresh configuration look stale.

Trait Implementations

impl Clone for ConfigStatus

fn clone(&self) -> ConfigStatus

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConfigStatus

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

Formats the value using the given formatter.

impl Eq for ConfigStatus

impl PartialEq for ConfigStatus

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ConfigStatus