Struct LogEntry 

pub struct LogEntry { /* private fields */ }

A structured log entry with message, level, and contextual fields.

Log entries are immutable once created. Use the builder pattern to construct entries with fields.

Example

let entry = LogEntry::info("Operation completed")
    .with_field("duration_ms", "42")
    .with_field("items_processed", "100");

Implementations

impl LogEntry

pub fn new(level: LogLevel, message: impl Into<String>) -> Self

Creates a new log entry with the given level and message.

pub fn trace(message: impl Into<String>) -> Self

Creates a TRACE level entry.

pub fn debug(message: impl Into<String>) -> Self

Creates a DEBUG level entry.

pub fn info(message: impl Into<String>) -> Self

Creates an INFO level entry.

pub fn warn(message: impl Into<String>) -> Self

Creates a WARN level entry.

pub fn error(message: impl Into<String>) -> Self

Creates an ERROR level entry.

pub fn with_field( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

Adds a structured field to the entry.

Fields are key-value pairs that provide context. If the maximum number of fields is reached, additional fields are ignored.

pub fn with_timestamp(self, timestamp: Time) -> Self

Sets the timestamp for the entry.

pub fn with_target(self, target: impl Into<String>) -> Self

Sets the target/module name for the entry.

pub fn with_context(self, ctx: &DiagnosticContext) -> Self

Adds diagnostic context fields to the entry.

pub const fn level(&self) -> LogLevel

Returns the log level.

pub fn message(&self) -> &str

Returns the log message.

pub const fn timestamp(&self) -> Time

Returns the timestamp.

pub fn target(&self) -> Option<&str>

Returns the target/module name, if set.

pub fn fields(&self) -> impl Iterator<Item = (&str, &str)>

Returns an iterator over the fields.

pub fn field_count(&self) -> usize

Returns the number of fields.

pub fn get_field(&self, key: &str) -> Option<&str>

Gets a field value by key.

pub fn format_compact(&self) -> String

Formats the entry as a single-line string (for compact output).

pub fn format_json(&self) -> String

Formats the entry as JSON (for structured logging pipelines).

Trait Implementations

impl Clone for LogEntry

fn clone(&self) -> LogEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LogEntry

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

Formats the value using the given formatter.

impl Display for LogEntry

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

Formats the value using the given formatter.