Struct SingleLayer 

pub struct SingleLayer {
    pub domain: Vec<Regex>,
    pub threshold: Ratio<BigInt>,
    /* private fields */
}

Fields

domain: Vec<Regex>

Regular expressions defining the domain patterns to be replaced in log lines.

threshold: Ratio<BigInt>

The similarity threshold used to determine if a new log line matches an existing LogGroup.

Implementations

impl SingleLayer

pub fn new(domain: Vec<String>) -> Result<Self, Error>

Creates a new SingleLayer drain instance.

Arguments

• domain - A vector of strings, each representing a regular expression pattern to be used for preprocessing log lines. These patterns are replaced with a wildcard token before further processing.

Returns

A Result containing the new SingleLayer instance on success, or an anyhow::Error if any of the provided domain patterns are invalid regular expressions.

pub fn set_threshold( &mut self, numerator: u64, denominator: u64, ) -> Result<(), Error>

Sets the similarity threshold for the drain.

This threshold determines how similar a new log line must be to an existing LogGroup’s event template to be considered a match. The similarity is calculated as a ratio of matching tokens to total tokens.

Arguments

• numerator - The numerator of the similarity ratio.
• denominator - The denominator of the similarity ratio.

Returns

Ok(()) on success, or an anyhow::Error if the numerator or denominator cannot be converted into BigInt.

pub fn resolve(&self, sym: DefaultSymbol) -> String

Resolves a DefaultSymbol back into its original string representation.

This is a utility method that uses the internal string interner to retrieve the string associated with a given symbol.

Arguments

• sym - The DefaultSymbol to resolve.

Returns

A String representation of the symbol.

Panics

Panics if the symbol cannot be resolved, which should not happen under normal operation as symbols are only created from interned strings.

Trait Implementations

impl Clone for SingleLayer

fn clone(&self) -> SingleLayer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SingleLayer

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

Formats the value using the given formatter.

impl Display for SingleLayer

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

Formats the SingleLayer drain for display.

This implementation provides a human-readable representation of the drain, including its domain patterns, similarity threshold, and a list of all contained log groups.

Arguments

• f - The formatter to write into.

Returns

A fmt::Result indicating success or failure of the formatting operation.

impl Drain for SingleLayer

fn process_line(&mut self, line: String) -> Result<bool, Error>

Processes a single log line, attempting to match it against existing log groups.

If the line is empty, it is ignored. Otherwise, it is converted into a Record. The method then attempts to find a matching LogGroup based on the record’s length and first token. If a sufficiently similar LogGroup is found (based on the threshold), the new record is added as an example to that group. If no match is found, a new LogGroup is created for the record.

Arguments

• line - The log line string to process.

Returns

• Ok(true) if a new LogGroup was created.
• Ok(false) if the line was added to an existing LogGroup.
• Err(anyhow::Error) if an error occurred during processing.

fn collect_log_groups(&self) -> Vec<LogGroup>

Collects all LogGroups currently stored in the drain.

This method flattens the internal hierarchical storage of log groups into a single vector.

Returns

A Vec<LogGroup> containing clones of all log groups.