Struct Logger 

pub struct Logger { /* private fields */ }

A context-aware logger.

Injected into handlers and services; the #[derive(Inject)] macro gives a logger: Logger field the surrounding struct’s name as its context. Each log line carries that context and any request-scoped fields (request id, method, path) captured when the logger was resolved.

Implementations

impl Logger

pub fn new(context: impl AsRef<str>) -> Self

Creates a logger with the given context and no base fields.

pub fn context(&self) -> &str

Returns the logger’s context (the name shown in [Context]).

pub fn for_context(&self, context: impl AsRef<str>) -> Logger

Returns a logger with a different context, keeping the base fields.

pub fn with_field<T: Serialize>(&self, key: &'static str, value: T) -> Logger

Returns a logger with an extra field included on every record.

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

Starts a TRACE record.

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

Starts a DEBUG record.

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

Starts an INFO record.

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

Starts a WARN record.

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

Starts an ERROR record.

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

Builds a span for an operation, to enter a scope.

pub fn instrument(&self, name: impl Into<String>) -> LogSpan

Builds a span to run a future inside.

Trait Implementations

impl Clone for Logger

fn clone(&self) -> Logger

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl FromRequest for Logger

fn from_request( ctx: &RequestContext, ) -> impl Future<Output = Result<Self>> + Send

Resolves Self from the request context.