Struct DeviceSummary 

pub struct DeviceSummary {
    pub id: String,
    pub label: Option<String>,
    pub attached_secs: u64,
    pub last_seen_secs: u64,
    pub exchanges: Option<u64>,
    pub last_exchange_ms: Option<u64>,
    pub mean_exchange_ms: Option<u64>,
    pub slowest_exchange_ms: Option<u64>,
}

A point-in-time view of an attached device.

Separate from Device because a device owns its data connections and therefore cannot be cloned or serialized; this is what an operator asking “what is attached right now?” actually needs.

Fields

id: String

Routing key used in /d/<id>/….

label: Option<String>

Label the device supplied, if any.

attached_secs: u64

Seconds since the device attached.

last_seen_secs: u64

Seconds since its last heartbeat.

exchanges: Option<u64>

Proxied exchanges measured so far, absent until there has been one.

Absent rather than zero: a device nothing has called yet has no timing, and a 0 there reads as “answers instantly”.

last_exchange_ms: Option<u64>

How long the most recent exchange took, in milliseconds.

Transfer and the device’s own processing together — see [Exchanges]. Splitting them is not possible from the relay’s side.

mean_exchange_ms: Option<u64>

Mean over every exchange since this device attached, in milliseconds.

slowest_exchange_ms: Option<u64>

The slowest single exchange since this device attached, in milliseconds.

Kept alongside the mean because the mean hides exactly the case an operator is looking for: an occasional very slow answer.

Trait Implementations

impl Clone for DeviceSummary

fn clone(&self) -> DeviceSummary

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DeviceSummary

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

Formats the value using the given formatter.

impl Serialize for DeviceSummary

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

where __S: Serializer,

Serialize this value into the given Serde serializer.