Struct DispatchCounts 

#[non_exhaustive]
pub struct DispatchCounts {
    pub shed: u64,
    pub acks: u64,
    pub unmatched: u64,
    pub unsupported: u64,
    pub malformed: u64,
    pub merged: u64,
    pub identity: u64,
    pub draining: u64,
}

What a dispatcher has refused, shed or could not place.

The same shape as sipx_transport::ShedCounts and for the same reason (T-19): loss that cannot be counted from outside is loss nobody is told about.

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.

shed: u64

Requests answered 503 because the call they belong to was not reading its inbox.

acks: u64

ACKs that could not be delivered — to a full inbox, or to no call at all.

Counted apart because an ACK cannot be refused: SIP has no response to one, so nothing retransmits it after Timer H and the dialog it would have completed is not reaped unless RFC 4028 session timers happen to be running. This is the one that leaks calls.

unmatched: u64

Requests answered 481 Call/Transaction Does Not Exist.

Two kinds, counted together because they are one fact — something named a dialog or a transaction this endpoint does not have: an in-dialog request for no live call (RFC 3261 §12.2.2), and a CANCEL matching no pending INVITE transaction (§9.2).

unsupported: u64

Out-of-dialog requests answered 405 Method Not Allowed (RFC 3261 §8.2.1).

malformed: u64

Requests answered 400 Bad Request for naming no dialog at all — no Call-ID, or no From tag, both of which RFC 3261 §8.1.1 makes mandatory.

merged: u64

INVITEs answered 482 Loop Detected as merged requests (RFC 3261 §8.2.2.2).

identity: u64

Initial INVITEs refused by the caller-selected authenticated-identity policy.

draining: u64

Valid new work refused because graceful drain intentionally closed admission.

Implementations

impl DispatchCounts

pub fn total(self) -> u64

Everything the dispatcher did not deliver, of every kind.

Every field above, and every refusal the dispatcher makes is on one of them. That is a property worth stating rather than assuming: two of these fields exist because the first version of this type had four, and the 400 and 482 branches moved no counter at all — two refusals invisible to the counters this story added to make loss visible.

Trait Implementations

impl Clone for DispatchCounts

fn clone(&self) -> DispatchCounts

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DispatchCounts

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

Formats the value using the given formatter.

impl Default for DispatchCounts

fn default() -> DispatchCounts

Returns the “default value” for a type.

impl PartialEq for DispatchCounts

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for DispatchCounts

impl Eq for DispatchCounts

impl StructuralPartialEq for DispatchCounts