Struct ConnectUdpMetrics 

pub struct ConnectUdpMetrics { /* private fields */ }

Available on crate feature masque only.

Metrics of the tunnels of a ConnectUdpService built with them.

Every series carries principal.kind when the service tracks principals (a per-principal limit or budget is set): user, token, ip or anonymous for the default keyer’s PrincipalKey, ip for an IP address key, custom for any other key type. A principal’s key itself is never exported.

• connect_udp.tunnels.active: tunnels opened and not yet ended;
• connect_udp.tunnel.refused {reason}: requests refused, by their Proxy-Status error type;
• connect_udp.tunnel.closed and connect_udp.tunnel.duration {reason = closed, idle, failed, capacity, upgrade_failed, relay_failed, cancelled}: tunnels ended, once each, when their task ends: as the relay returns, or when the proxy drops the task (cancelled), whatever handles of the tunnel the relay kept;
• connect_udp.datagrams.from_client {outcome = forwarded, unknown_context, oversize, rate_limited, over_quota, unanswered} and connect_udp.datagrams.from_client.carrier {carrier = native, capsule}: each sums to the HTTP Datagrams received;
• connect_udp.datagrams.to_client {outcome = returned, rate_limited, over_quota, too_large, unsent}: sums to the datagrams accepted to send to the client;
• connect_udp.bytes.received, .oversize_declared, .forwarded, .returned and .returned_dropped: the byte counts of ConnectUdpStats; oversize_declared is what oversized capsules announced, not what arrived.

Datagram and byte counts are recorded as they are when a tunnel’s task ends; what a send handle the relay kept moves after that is not. ConnectUdpMetrics::with_attributes adds attributes of each request to its series. Cheap to clone; clones report into the same series.

Implementations

impl ConnectUdpMetrics

pub fn new(options: MeterOptions) -> ConnectUdpMetrics

Metrics recorded with the global meter provider.

pub fn new_with_meter(meter: &Meter, options: MeterOptions) -> ConnectUdpMetrics

Metrics recorded with meter.

pub fn with_attributes<F>(self, factory: F) -> ConnectUdpMetrics

where F: AttributesFactory,

Add attributes of each CONNECT-UDP request to the series it records into: factory is asked once per refused or opened tunnel, with the request’s extensions. Its attributes are exported as given, so they must stay few in values.

Trait Implementations

impl Clone for ConnectUdpMetrics

fn clone(&self) -> ConnectUdpMetrics

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConnectUdpMetrics

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

Formats the value using the given formatter.