Dispatch in tracing_core::dispatcher - Rust (original) (raw)
pub struct Dispatch { /* private fields */ }
Expand description
Returns a new Dispatch
that discards events and spans.
Returns a Dispatch
that forwards to the given Subscriber.
Creates a WeakDispatch from this Dispatch
.
A WeakDispatch is similar to a Dispatch, but it does not prevent the underlying Subscriber from being dropped. Instead, it only permits access while other references to the Subscriber
exist. This is equivalent to the standard library’s Arc::downgrade method, but for Dispatch
rather than Arc
.
The primary use for creating a WeakDispatch is to allow a Subscriber
to hold a cyclical reference to itself without creating a memory leak. See here for details.
Registers a new callsite with this subscriber, returning whether or not the subscriber is interested in being notified about the callsite.
This calls the register_callsite function on the Subscriberthat this Dispatch
forwards to.
Record the construction of a new span, returning a new ID for the span being constructed.
This calls the new_span function on the Subscriber that thisDispatch
forwards to.
Record a set of values on a span.
This calls the record function on the Subscriber that thisDispatch
forwards to.
Adds an indication that span
follows from the span with the idfollows
.
This calls the record_follows_from function on the Subscriberthat this Dispatch
forwards to.
Returns true if a span with the specified metadata would be recorded.
This calls the enabled function on the Subscriber that thisDispatch
forwards to.
Records that an Event has occurred.
This calls the event function on the Subscriber that thisDispatch
forwards to.
Records that a span has been can_enter.
This calls the enter function on the Subscriber that thisDispatch
forwards to.
Records that a span has been exited.
This calls the exit function on the Subscriber that thisDispatch
forwards to.
Notifies the subscriber that a span ID has been cloned.
This function must only be called with span IDs that were returned by this Dispatch
’s new_span function. The tracing
crate upholds this guarantee and any other libraries implementing instrumentation APIs must as well.
This calls the clone_span function on the Subscriber
that thisDispatch
forwards to.
👎Deprecated since 0.1.2: use Dispatch::try_close
instead
Notifies the subscriber that a span ID has been dropped.
This function must only be called with span IDs that were returned by this Dispatch
’s new_span function. The tracing
crate upholds this guarantee and any other libraries implementing instrumentation APIs must as well.
This calls the drop_span function on the Subscriber that thisDispatch
forwards to.
**Deprecated**: The [ try_close](#method.try%5Fclose) method is functionally identical, but returns
`true` if the span is now closed. It should be used
instead of this method.
Notifies the subscriber that a span ID has been dropped, and returnstrue
if there are now 0 IDs referring to that span.
This function must only be called with span IDs that were returned by this Dispatch
’s new_span function. The tracing
crate upholds this guarantee and any other libraries implementing instrumentation APIs must as well.
This calls the try_close function on the Subscriber that thisDispatch
forwards to.
Returns a type representing this subscriber’s view of the current span.
This calls the current function on the Subscriber
that thisDispatch
forwards to.
Returns true
if this Dispatch
forwards to a Subscriber
of typeT
.
Returns some reference to the Subscriber
this Dispatch
forwards to if it is of type T
, or None
if it isn’t.