pub struct SpanRef<'a, R: LookupSpan<'a>> { /* private fields */ }
Expand description
Implementations§
Source§impl<'a, R> SpanRef<'a, R>where
R: LookupSpan<'a>,
impl<'a, R> SpanRef<'a, R>where
R: LookupSpan<'a>,
Sourcepub fn metadata(&self) -> &'static Metadata<'static>
pub fn metadata(&self) -> &'static Metadata<'static>
Returns a static reference to the span’s metadata.
Sourcepub fn parent_id(&self) -> Option<&Id> ⓘ
👎Deprecated since 0.2.21: this method cannot properly support per-subscriber filtering, and may return the Id
of a disabled span if per-subscriber filtering is in use. use .parent().map(SpanRef::id)
instead.
pub fn parent_id(&self) -> Option<&Id> ⓘ
Id
of a disabled span if per-subscriber filtering is in use. use .parent().map(SpanRef::id)
instead.Returns the ID of this span’s parent, or None
if this span is the root
of its trace tree.
Sourcepub fn parent(&self) -> Option<Self> ⓘ
pub fn parent(&self) -> Option<Self> ⓘ
Returns a SpanRef
describing this span’s parent, or None
if this
span is the root of its trace tree.
Sourcepub fn scope(&self) -> Scope<'a, R> ⓘ
pub fn scope(&self) -> Scope<'a, R> ⓘ
Returns an iterator over all parents of this span, starting with this span, ordered from leaf to root.
The iterator will first return the span, then the span’s immediate parent, followed by that span’s parent, and so on, until it reaches a root span.
use tracing::{span, Collect};
use tracing_subscriber::{
subscribe::{Context, Subscribe},
prelude::*,
registry::LookupSpan,
};
struct PrintingSubscriber;
impl<C> Subscribe<C> for PrintingSubscriber
where
C: Collect + for<'lookup> LookupSpan<'lookup>,
{
fn on_enter(&self, id: &span::Id, ctx: Context<C>) {
let span = ctx.span(id).unwrap();
let scope = span.scope().map(|span| span.name()).collect::<Vec<_>>();
println!("Entering span: {:?}", scope);
}
}
tracing::collect::with_default(tracing_subscriber::registry().with(PrintingSubscriber), || {
let _root = tracing::info_span!("root").entered();
// Prints: Entering span: ["root"]
let _child = tracing::info_span!("child").entered();
// Prints: Entering span: ["child", "root"]
let _leaf = tracing::info_span!("leaf").entered();
// Prints: Entering span: ["leaf", "child", "root"]
});
If the opposite order (from the root to this span) is desired, calling Scope::from_root
on
the returned iterator reverses the order.
impl<C> Subscribe<C> for PrintingSubscriber
where
C: Collect + for<'lookup> LookupSpan<'lookup>,
{
fn on_enter(&self, id: &span::Id, ctx: Context<C>) {
let span = ctx.span(id).unwrap();
let scope = span.scope().from_root().map(|span| span.name()).collect::<Vec<_>>();
println!("Entering span: {:?}", scope);
}
}
tracing::collect::with_default(tracing_subscriber::registry().with(PrintingSubscriber), || {
let _root = tracing::info_span!("root").entered();
// Prints: Entering span: ["root"]
let _child = tracing::info_span!("child").entered();
// Prints: Entering span: ["root", "child"]
let _leaf = tracing::info_span!("leaf").entered();
// Prints: Entering span: ["root", "child", "leaf"]
});
Sourcepub fn extensions(&self) -> Extensions<'_>
Available on crate feature std
only.
pub fn extensions(&self) -> Extensions<'_>
std
only.Returns a reference to this span’s Extensions
.
The extensions may be used by Subscriber
s to store additional data
describing the span.
Sourcepub fn extensions_mut(&self) -> ExtensionsMut<'_>
Available on crate feature std
only.
pub fn extensions_mut(&self) -> ExtensionsMut<'_>
std
only.Returns a mutable reference to this span’s Extensions
.
The extensions may be used by Subscriber
s to store additional data
describing the span.