Enum Context 

pub enum Context {
    Metric(MetricContext),
    Event(EventContext),
    ServiceCheck(ServiceCheckContext),
}

A reusable DogStatsD identity of one of the three kinds.

Variants

Metric(MetricContext)

A metric identity.

Event(EventContext)

An event identity.

ServiceCheck(ServiceCheckContext)

A service-check identity.

Implementations

impl Context

pub fn mint_within( kind: Kind, rng: &mut (impl Rng + ?Sized), budget: usize, ) -> Option<Context>

Mint a context of kind whose renders fit budget and that the Agent forwards, or None when no such identity is available.

The identity is built against the budget, so it fits by construction and nothing is minted then measured. The remaining re-mint loop is about content alone: the alphabet carries protocol delimiters and some combinations land on the drop side, which a probe render is what detects. An exhausted loop yields None rather than an identity of another kind, so the caller never stores a metric in the event or service-check working set.

pub fn render(&self, rng: &mut (impl Rng + ?Sized), out: &mut Vec<u8>) -> usize

Render one datagram line (no trailing \n) for this identity with a fresh per-occurrence payload. Returns the packed multi-value run length, or zero.

pub fn mint_non_utf8_within( kind: Kind, rng: &mut (impl Rng + ?Sized), budget: usize, ) -> Option<Context>

Mint an identity of kind that carries an invalid UTF-8 byte, or None when none can be built within budget. Corrupt identities live in the pool like any other, so they recur across datagrams and count against the kind’s cap instead of appearing as fresh one-offs.

pub fn has_non_utf8(&self) -> bool

Whether this identity carries an invalid UTF-8 byte.

pub fn floor(&self) -> usize

Bytes every render of this identity must spend, whatever the per-occurrence payload.

pub fn render_wellformed_within( &self, rng: &mut (impl Rng + ?Sized), out: &mut Vec<u8>, budget: usize, ) -> Option<usize>

Render one datagram line the Agent forwards within budget, or None when this context has no forwardable rendering that fits. The budget is a construction input to each attempt rather than a filter on the result, and an exhausted attempt count yields nothing rather than a line carrying an identity the pool never issued.

pub fn encode(&self, out: &mut Vec<u8>)

Append this context’s tagged, length-prefixed encoding.

Trait Implementations

impl Clone for Context

fn clone(&self) -> Context

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Context

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

Formats the value using the given formatter.

impl Hash for Context

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Context

fn eq(&self, other: &Context) -> 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 Eq for Context

impl StructuralPartialEq for Context