Enum TelemetryRecord 

#[non_exhaustive]
pub enum TelemetryRecord {
    Protocol(Box<Event>),
    Mls(MlsLifecycleEvent),
    MetricsSnapshot(Box<MetricsFrame>),
    TransportState(TransportStateEvent),
    Routing(Box<RoutingDecision>),
    Device(DeviceCapabilitySnapshot),
}

A single typed telemetry emission.

The name is delegated to the inner payload’s telemetry_name() method so there is a single source of truth for variant naming.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Protocol(Box<Event>)

A protocol-level event — wraps the existing Event type.

The inner Event is boxed because it is substantially larger than every other variant; boxing keeps the enum’s footprint flat so non-Protocol records do not pay the size tax when stored in collections.

Mls(MlsLifecycleEvent)

An MLS lifecycle event — wraps the existing MlsLifecycleEvent.

MetricsSnapshot(Box<MetricsFrame>)

A periodic snapshot of protocol-wide counters and per-transport metrics. Boxed to keep the enum footprint flat — the frame carries inline Vec/stat structs that would otherwise dominate the enum size and tax every non-snapshot variant.

TransportState(TransportStateEvent)

A single transport-status transition (per-transport, unlike the protocol-level Event::TransportSwitched).

Routing(Box<RoutingDecision>)

A structured routing decision (supersets Event::Dors*).

Boxed because the score-breakdown vector can carry per-transport factor details at the Diagnostic verbosity tier.

Device(DeviceCapabilitySnapshot)

A snapshot of local device capability (battery, charging, relay role).

Implementations

impl TelemetryRecord

pub fn name(&self) -> &'static str

Returns the stable name for this record. See the module-level docs for the exact grammar and stability guarantees.

Trait Implementations

impl Clone for TelemetryRecord

fn clone(&self) -> TelemetryRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TelemetryRecord

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

Formats the value using the given formatter.