logo
pub struct Registry { /* private fields */ }
Expand description

A shared, reusable store for spans.

A Registry is a Subscriber around which multiple Layers implementing various behaviors may be added. Unlike other types implementing Subscriber Registry does not actually record traces itself: instead, it collects and stores span data that is exposed to any Layers wrapping it through implementations of the LookupSpan trait. The Registry is responsible for storing span metadata, recording relationships between spans, and tracking which spans are active and whicb are closed. In addition, it provides a mechanism for Layers to store user-defined per-span data, called extensions, in the registry. This allows Layer-specific data to benefit from the Registry’s high-performance concurrent storage.

This registry is implemented using a lock-free sharded slab, and is highly optimized for concurrent access.

Trait Implementations

Formats the value using the given formatter. Read more

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

The type of span data stored in this registry.

Returns the SpanData for a given Id, if it exists. Read more

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

This is intentionally not implemented, as recording fields on a span is the responsibility of layers atop of this registry.

This is intentionally not implemented, as recording events is the responsibility of layers atop of this registry.

Decrements the reference count of the span with the given id, and removes the span if it is zero.

The allocated span slot will be reused when a new span is created.

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

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

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

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

Records that a span has been entered. Read more

Records that a span has been exited. Read more

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

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

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

Determine if an Event should be recorded. Read more

👎 Deprecated since 0.1.2:

use Subscriber::try_close instead

This method is deprecated. Read more

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

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Returns the argument unchanged.

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

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

Calls U::from(self).

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

Wraps self with the provided layer.

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

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

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

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.

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

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