Struct DnsLoadBalancerConfig 

pub struct DnsLoadBalancerConfig<R = GlobalDnsResolver, P = RoundRobinPicker> {
    pub resolver: R,
    pub picker: P,
    pub refresh_after: Duration,
    pub evict_after_idle: Duration,
    pub evict_after_stale: Duration,
    pub mode: DnsResolveIpMode,
    pub max_entries: u64,
}

Available on crate feature dns only.

DNS loadbalancer config used by DnsLoadBalancerLayer and DnsLoadBalancer.

Fields

resolver: R

DnsAddressResolver that will resolve IPs for the given host

WARNING: it is possible that the underlying resolver also has caching of its own. So definetely check the docs and tweak the config if needed so it works together with the caching logic in this loadbalancer.

picker: P

DnsIpPicker that will decide which IP to use

refresh_after: Duration

A cached resolution older than this triggers a background refresh (the stale value is still served while it refreshes)

evict_after_idle: Duration

A cache entry that hasn’t been accessed for this long is dropped from the cache.

evict_after_stale: Duration

A cache entry whose last successful refresh was longer than this ago is dropped

Protects against serving stale data when refreshes keep failing.

mode: DnsResolveIpMode

Ip resolve mode that will be used by resolver

max_entries: u64

Max amount of entries that will be stored in cache

Implementations

impl DnsLoadBalancerConfig

pub fn new() -> DnsLoadBalancerConfig

Default config: global DNS resolver, round-robin picker, DEFAULT_LB_REFRESH_AFTER, DEFAULT_LB_EVICT_AFTER_IDLE, DEFAULT_LB_EVICT_AFTER_STALE, DEFAULT_LB_MAX_ENTRIES.

impl<R, P> DnsLoadBalancerConfig<R, P>

where R: DnsAddressResolver + Clone, P: DnsIpPicker,

pub fn from_parts(resolver: R, picker: P) -> DnsLoadBalancerConfig<R, P>

Build a config with a custom resolver and picker, defaults for everything else.

Combine with struct update syntax to tweak individual fields:

DnsLoadBalancerConfig {
    refresh_after: Duration::from_secs(60),
    ..DnsLoadBalancerConfig::from_parts(my_resolver, my_picker)
}

Trait Implementations

impl<R, P> Clone for DnsLoadBalancerConfig<R, P>

where R: Clone, P: Clone,

fn clone(&self) -> DnsLoadBalancerConfig<R, P>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for DnsLoadBalancerConfig

fn default() -> DnsLoadBalancerConfig

Returns the “default value” for a type.