Struct Setup 

pub struct Setup { /* private fields */ }

Builder for the tracing-subscriber config.

All knobs are optional with sensible defaults. Build up the config and call install when done.

Implementations

impl Setup

pub fn new() -> Self

New builder with defaults: pretty format, "info,sqlx=warn" filter, no thread IDs, no line numbers, targets shown.

pub fn json(self) -> Self

Output JSON instead of pretty colored format. Recommended for production (Loki / CloudWatch / Datadog all parse JSON).

pub fn with_default_env_filter(self, filter: impl Into<String>) -> Self

Default env-filter when RUST_LOG is unset. Defaults to "info,sqlx=warn".

pub fn without_targets(self) -> Self

Hide event targets (the module path) in pretty output.

pub fn with_thread_ids(self) -> Self

Include thread IDs in events.

pub fn with_line_numbers(self) -> Self

Include source-file line numbers in events. Useful in dev, noisy in prod.

pub fn with_file( self, dir: impl Into<PathBuf>, filename_prefix: impl Into<String>, rotation: Rotation, ) -> Self

Tee logs to a rolling file in dir/filename_prefix.YYYY-MM-DD in addition to stdout. By default rotates daily; pass a different Rotation to override. The directory is created on first write if it doesn’t exist.

File output uses tracing-appender’s non-blocking writer so a stalled disk doesn’t pause request handling — events queue in-memory and drop only under sustained extreme pressure. Closes future-backlog item #1 (“advanced logging config”).

use rustango::logging::{Setup, Rotation};
Setup::new()
    .json()
    .with_file("/var/log/myapp", "app", Rotation::Daily)
    .install();

pub fn file_only(self) -> Self

When Self::with_file is configured, drop the stdout layer so logs land in the rolling file ONLY. No-op when no file sink is configured.

pub fn install(self) -> Option<WorkerGuard>

Apply the config. Uses try_init under the hood — duplicate calls are silently ignored. When Self::with_file is configured, returns the tracing_appender::WorkerGuard that flushes pending writes on drop — keep it alive for the lifetime of the process (typically by stashing in a static or OnceLock). None is returned when no file sink is configured.

Trait Implementations

impl Default for Setup

Available on crate feature runtime only.

fn default() -> Self

Returns the “default value” for a type.