Struct retina_core::config::SinkConfig

pub struct SinkConfig {
    pub core: u32,
    pub nb_buckets: usize,
}

Sink core options.

A “sink” core is a utility core whose sole purpose is to drop received traffic. This is useful for connection sampling, as entire 4-tuples can be discarded by redirecting them to the sink core.

Remarks

Adding a sink core prevents ethtool counters from classifying intentionally discarded packets as packet loss. However, it can be quite wasteful of system resources, as it requires configuring one additional core per interface and thrashes the cache.

Example

[online.ports.sink]
    core = 9
    nb_buckets = 384   # drops 25% of 4-tuples

Fields

core: u32

Sink core identifier.

nb_buckets: usize

Number of RSS redirection table buckets to use for receive queues. Defaults to 512, which indicates no sampling.

Remarks

Connection sampling is implemented by only polling from a fraction of the available RSS redirection buckets. nb_buckets must range from the number of cores polling the port (call this n) to 512, which is the maximum number of buckets in the RSS redirection table. It is recommended that nb_buckets be a multiple of n for better load balancing. For example, setting nb_buckets = 256 would drop 50% of connections.

Trait Implementations

impl Clone for SinkConfig

fn clone(&self) -> SinkConfig

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SinkConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SinkConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SinkConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.