Struct EventLogContext 

pub struct EventLogContext<'a> {
    pub event: &'a Event,
    pub start_time: Instant,
    pub server_id: ServerId,
    pub connection_id: Option<ConnectionId>,
    pub client_addr: Option<SocketAddr>,
    pub protocol_name: String,
}

Context for logging an event’s lifecycle

Tracks timing and context information from event start to completion. Provides methods to log at appropriate levels using the event’s LogTemplate.

Example

let ctx = EventLogContext::new(
    &event,
    server_id,
    Some(connection_id),
    Some(client_addr),
    "HTTP",
);

ctx.log_start(Some(&status_tx));

// ... process event, get action results ...

ctx.log_complete(Some(&status_tx), &action_results);

Fields

event: &'a Event

Reference to the event being logged

start_time: Instant

When event processing started

server_id: ServerId

Server ID processing this event

connection_id: Option<ConnectionId>

Connection ID if applicable

client_addr: Option<SocketAddr>

Client address if known

protocol_name: String

Protocol name for fallback logging

Implementations

impl<'a> EventLogContext<'a>

pub fn new( event: &'a Event, server_id: ServerId, connection_id: Option<ConnectionId>, client_addr: Option<SocketAddr>, protocol_name: impl Into<String>, ) -> Self

Create a new event log context

Automatically records the start time for duration tracking.

pub fn build_enriched_data(&self) -> Value

Build enriched data with context fields

Adds client_ip, client_port, server_id, connection_id to the event data.

pub so tests/event_logger_test.rs can assert on the enrichment directly — CLAUDE.md forbids unit-test modules in src/, so an internal helper has to be reachable to be tested.

pub fn log_start(&self, status_tx: Option<&UnboundedSender<String>>)

Log event start (DEBUG level)

Called when an event is received and about to be processed. Uses the event’s debug template if available, otherwise falls back to a generic message.

pub fn log_complete( &self, status_tx: Option<&UnboundedSender<String>>, action_results: &[ActionResult], )

Log event completion (INFO/DEBUG/TRACE levels)

Called after actions have been executed. Enriches data with timing and response information.

Logs at:

• INFO: One-liner access log style
• DEBUG: With timing information
• TRACE: Full details