Struct LogShipperHandle 

pub struct LogShipperHandle { /* private fields */ }

Cheap cloneable handle. enqueue is non-blocking and never fails — it’s safe to call from the request path. When the shipper isn’t configured the handle is None and calls are zero-cost.

Implementations

impl LogShipperHandle

pub fn disabled() -> Self

Construct a no-op handle. Used when the shipper isn’t configured — the request middleware can still call enqueue without checking.

pub fn enqueue(&self, event: RequestLogEvent)

Non-blocking enqueue. Drops the event silently when the buffer is full, which is the right tradeoff for a request-path component: observability never blocks user traffic.

pub fn is_active(&self) -> bool

True if the shipper is actually running. Useful for skipping work in middleware (e.g., decoding the user-agent header).

Trait Implementations

impl Clone for LogShipperHandle

fn clone(&self) -> LogShipperHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.