Struct RequestLogger 

pub struct RequestLogger<'a> { /* private fields */ }

A per-request logger that captures context and emits logs.

This struct is typically created once per request and provides logging methods that automatically include request context.

Example

use fastapi_core::logging::RequestLogger;

async fn handler(ctx: &RequestContext) -> impl IntoResponse {
    let logger = RequestLogger::new(ctx, LogConfig::production());

    logger.info("Request started");
    logger.debug_with_fields("Processing", |e| e.field("path", ctx.path()));

    "ok"
}

Implementations

impl<'a> RequestLogger<'a>

pub fn new(ctx: &'a RequestContext, config: LogConfig) -> Self

Creates a new request logger.

pub fn is_enabled(&self, level: LogLevel) -> bool

Returns true if the given log level is enabled.

pub fn emit(&self, entry: LogEntry)

Emits a log entry if the level is enabled.

pub fn trace(&self, message: impl Into<String>)

Logs a message at TRACE level.

pub fn debug(&self, message: impl Into<String>)

Logs a message at DEBUG level.

pub fn info(&self, message: impl Into<String>)

Logs a message at INFO level.

pub fn warn(&self, message: impl Into<String>)

Logs a message at WARN level.

pub fn error(&self, message: impl Into<String>)

Logs a message at ERROR level.

pub fn trace_with_fields<F>(&self, message: impl Into<String>, f: F)

where F: FnOnce(LogEntry) -> LogEntry,

Logs with custom field builder at TRACE level.

pub fn debug_with_fields<F>(&self, message: impl Into<String>, f: F)

where F: FnOnce(LogEntry) -> LogEntry,

Logs with custom field builder at DEBUG level.

pub fn info_with_fields<F>(&self, message: impl Into<String>, f: F)

where F: FnOnce(LogEntry) -> LogEntry,

Logs with custom field builder at INFO level.

pub fn warn_with_fields<F>(&self, message: impl Into<String>, f: F)

where F: FnOnce(LogEntry) -> LogEntry,

Logs with custom field builder at WARN level.

pub fn error_with_fields<F>(&self, message: impl Into<String>, f: F)

where F: FnOnce(LogEntry) -> LogEntry,

Logs with custom field builder at ERROR level.

pub fn span(&self, name: impl Into<String>) -> Span

Creates a timing span.

pub fn span_auto(&self, name: impl Into<String>) -> AutoSpan

Creates an auto-ending span.