Struct DelayedLogger 

pub struct DelayedLogger { /* private fields */ }

A tracing::Subscriber that prints the events deemed most important to get a high-level overview of the executed algorithm to stdout.

Features:

• Messages are only printed after the algorithm has spent a certain time in the current span, thus not printing anything for short spans
• Messages are printed from the same threads as they are generated, which makes it compatible with IO capturing during tests
• for each root span, all logged sub-spans and events are written in a single line, keeping the output compact.
• to make the single line easier to read, every second-level span (and its sub-tree) is printed in a different color, cycling through a fixed palette. Colors are only emitted when the feature print_colored is active and the output stream supports them; Furthermore, they can be disabled via the the NO_COLOR and CLICOLOR environment variables.

Implementations

impl DelayedLogger

pub fn new( max_depth: usize, silent_period: u64, levels: RangeInclusive<Level>, ) -> Self

Creates a new DelayedLogger, which logs only events and spans

• whose Level is within levels
• which are part of a span that will be running for at least silent_period microseconds; any message queued at a time when this is not yet decided will be stored and possibly printed later
• are part of a span of depth at most max_depth in the span tree

pub fn init(max_depth: usize, silent_period: u64, levels: RangeInclusive<Level>)

Creates a new DelayedLogger using DelayedLogger::new() and sets it as the global default. This will panic if a global default has already been set.

pub fn init_test()

Creates a new DelayedLogger using a test configuration and sets it as the global default, unless a global default is already set.

Trait Implementations

impl Subscriber for DelayedLogger

fn register_callsite(&self, metadata: &'static Metadata<'static>) -> Interest

Registers a new callsite with this subscriber, returning whether or not the subscriber is interested in being notified about the callsite.

fn enabled(&self, metadata: &Metadata<'_>) -> bool

Returns true if a span or event with the specified metadata would be recorded.

fn current_span(&self) -> Current

Returns a type representing this subscriber’s view of the current span.

fn new_span(&self, span: &Attributes<'_>) -> Id

Visit the construction of a new span, returning a new span ID for the span being constructed.

fn record(&self, _span: &Id, _values: &Record<'_>)

Record a set of values on a span.

fn record_follows_from(&self, _span: &Id, _follows: &Id)

Adds an indication that span follows from the span with the id follows.

fn event(&self, event: &Event<'_>)

Records that an Event has occurred.

fn enter(&self, span: &Id)

Records that a span has been entered.

fn exit(&self, span: &Id)

Records that a span has been exited.

fn clone_span(&self, id: &Id) -> Id

Notifies the subscriber that a span ID has been cloned.

fn try_close(&self, id: Id) -> bool

Notifies the subscriber that a span ID has been dropped, and returns true if there are now 0 IDs that refer to that span.

fn on_register_dispatch(&self, subscriber: &Dispatch)

Invoked when this subscriber becomes a Dispatch.

fn max_level_hint(&self) -> Option<LevelFilter>

Returns the highest verbosity level that this Subscriber will enable, or None, if the subscriber does not implement level-based filtering or chooses not to implement this method.

fn event_enabled(&self, event: &Event<'_>) -> bool

Determine if an Event should be recorded.

fn drop_span(&self, _id: Id)

👎Deprecated since 0.1.2:

use Subscriber::try_close instead

This method is deprecated.

unsafe fn downcast_raw(&self, id: TypeId) -> Option<*const ()>

If self is the same type as the provided TypeId, returns an untyped *const pointer to that type. Otherwise, returns None.