pub struct Subscriber<N = DefaultFields, E = Format<Full>, F = LevelFilter, W = fn() -> Stdout> { /* private fields */ }
Expand description

A Subscriber that logs formatted representations of tracing events.

This consists of an inner Formatter wrapped in a layer that performs filtering.

Implementations§

source§

impl Subscriber

source

pub const DEFAULT_MAX_LEVEL: LevelFilter = LevelFilter::INFO

The maximum verbosity level that is enabled by a Subscriber by default.

This can be overridden with the SubscriberBuilder::with_max_level method.

source

pub fn builder() -> SubscriberBuilder

Returns a new SubscriberBuilder for configuring a format subscriber.

source

pub fn new() -> Self

Returns a new format subscriber with the default configuration.

Trait Implementations§

source§

impl<N: Debug, E: Debug, F: Debug, W: Debug> Debug for Subscriber<N, E, F, W>

source§

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

Formats the value using the given formatter. Read more
source§

impl Default for Subscriber

source§

fn default() -> Self

Returns the “default value” for a type. Read more
source§

impl<'a, N, E, F, W> LookupSpan<'a> for Subscriber<N, E, F, W>where Layered<F, Formatter<N, E, W>>: LookupSpan<'a>,

§

type Data = <Layered<F, Layered<Layer<Registry, N, E, W>, Registry, Registry>, Layered<Layer<Registry, N, E, W>, Registry, Registry>> as LookupSpan<'a>>::Data

The type of span data stored in this registry.
source§

fn span_data(&'a self, id: &Id) -> Option<Self::Data>

Returns the SpanData for a given Id, if it exists.
source§

fn span(&'a self, id: &Id) -> Option<SpanRef<'_, Self>>where Self: Sized,

Returns a SpanRef for the span with the given Id, if it exists. Read more
source§

fn register_filter(&mut self) -> FilterId

Registers a Filter for per-layer filtering with this Subscriber. Read more
source§

impl<N, E, F, W> Subscriber for Subscriber<N, E, F, W>where N: for<'writer> FormatFields<'writer> + 'static, E: FormatEvent<Registry, N> + 'static, F: Layer<Formatter<N, E, W>> + 'static, W: MakeWriter + 'static, Layered<F, Formatter<N, E, W>>: Subscriber, Layer<Registry, N, E, W>: Layer<Registry>,

source§

fn register_callsite(&self, meta: &'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. Read more
source§

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

Returns true if a span or event with the specified metadata would be recorded. Read more
source§

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

Visit the construction of a new span, returning a new span ID for the span being constructed. Read more
source§

fn record(&self, span: &Id, values: &Record<'_>)

Record a set of values on a span. Read more
source§

fn record_follows_from(&self, span: &Id, follows: &Id)

Adds an indication that span follows from the span with the id follows. Read more
source§

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

Records that an Event has occurred. Read more
source§

fn enter(&self, id: &Id)

Records that a span has been entered. Read more
source§

fn exit(&self, id: &Id)

Records that a span has been exited. Read more
source§

fn current_span(&self) -> Current

Returns a type representing this subscriber’s view of the current span. Read more
source§

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

Notifies the subscriber that a span ID has been cloned. Read more
source§

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. Read more
source§

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. Read more
source§

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. Read more
source§

fn on_register_dispatch(&self, subscriber: &Dispatch)

Invoked when this subscriber becomes a Dispatch. Read more
source§

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

Determine if an Event should be recorded. Read more
source§

fn drop_span(&self, _id: Id)

👎Deprecated since 0.1.2: use Subscriber::try_close instead
This method is deprecated. Read more

Auto Trait Implementations§

§

impl<N, E, F, W> RefUnwindSafe for Subscriber<N, E, F, W>where E: RefUnwindSafe, F: RefUnwindSafe, N: RefUnwindSafe, W: RefUnwindSafe,

§

impl<N, E, F, W> Send for Subscriber<N, E, F, W>where E: Send, F: Send, N: Send, W: Send,

§

impl<N, E, F, W> Sync for Subscriber<N, E, F, W>where E: Sync, F: Sync, N: Sync, W: Sync,

§

impl<N, E, F, W> Unpin for Subscriber<N, E, F, W>where E: Unpin, F: Unpin, N: Unpin, W: Unpin,

§

impl<N = DefaultFields, E = Format<Full, SystemTime>, F = LevelFilter, W = fn() -> Stdout> !UnwindSafe for Subscriber<N, E, F, W>

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<S> SubscriberExt for Swhere S: Subscriber,

source§

fn with<L>(self, layer: L) -> Layered<L, Self>where L: Layer<Self>, Self: Sized,

Wraps self with the provided layer.
source§

impl<T> SubscriberInitExt for Twhere T: Into<Dispatch>,

source§

fn set_default(self) -> DefaultGuard

Sets self as the default subscriber in the current scope, returning a guard that will unset it when dropped. Read more
source§

fn try_init(self) -> Result<(), TryInitError>

Attempts to set self as the global default subscriber in the current scope, returning an error if one is already set. Read more
source§

fn init(self)

Attempts to set self as the global default subscriber in the current scope, panicking if this fails. Read more
source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more