Struct LogEvent 

pub struct LogEvent {
    pub runlevel: Runlevel,
    pub message: String,
    /* private fields */
}

Tor logging event for receiving log messages from the Tor process.

These are the most visible kind of event since, by default, Tor logs at the NOTICE Runlevel to stdout. Log events allow controllers to receive and process Tor’s log output programmatically.

Runlevels

Log events are categorized by severity:

• Runlevel::Debug - Verbose debugging information
• Runlevel::Info - Informational messages
• Runlevel::Notice - Normal operational messages (default)
• Runlevel::Warn - Warning conditions
• Runlevel::Err - Error conditions

Event Types

Each runlevel corresponds to a separate event type:

• DEBUG, INFO, NOTICE, WARN, ERR

Example

use stem_rs::{EventType, Runlevel};
use stem_rs::events::LogEvent;

fn handle_log(event: &LogEvent) {
    match event.runlevel {
        Runlevel::Err | Runlevel::Warn => {
            eprintln!("[{}] {}", event.runlevel, event.message);
        }
        _ => {
            println!("[{}] {}", event.runlevel, event.message);
        }
    }
}

See Also

• Runlevel - Log severity levels
• StatusEvent - Structured status messages

Fields

runlevel: Runlevel

Severity level of the log message.

message: String

The log message content.

Implementations

impl LogEvent

pub fn parse(runlevel: Runlevel, message: &str) -> Result<Self, Error>

Parses a log event from raw control protocol content.

Arguments

• runlevel - The severity level of the log message
• message - The log message content

Errors

This method currently does not return errors but returns Result for API consistency with other event parsers.

Trait Implementations

impl Clone for LogEvent

fn clone(&self) -> LogEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LogEvent

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

Formats the value using the given formatter.

impl Event for LogEvent

fn event_type(&self) -> EventType

Returns the type of this event.

fn raw_content(&self) -> &str

Returns the raw, unparsed content of the event.

fn arrived_at(&self) -> Instant

Returns the instant when this event was received.