Enum polkadot_node_subsystem::Span

pub enum Span {
    Enabled(Span),
    Disabled,
}

A wrapper type for a span.

Handles running with and without jaeger.

Variants

Enabled(Span)

Running with jaeger being enabled.

Disabled

Running with jaeger disabled.

Implementations

impl Span

pub fn new<I>(identifier: I, span_name: &'static str) -> Spanwhere I: LazyIdent,

Creates a new span builder based on anything that can be lazily evaluated to and identifier.

Attention: The primary identifier will be used for identification and as such should be

pub fn from_encodable<I>(identifier: I, span_name: &'static str) -> Spanwhere I: Encode,

Creates a new span builder based on an encodable type. The encoded bytes are then used to derive the true trace identifier.

pub fn child(&self, name: &'static str) -> Span

Derive a child span from self.

pub fn with_string_tag<V>(self, tag: &'static str, val: V) -> Spanwhere V: ToString,

pub fn with_peer_id(self, peer: &PeerId) -> Span

pub fn with_candidate(self, candidate_hash: CandidateHash) -> Span

Attach a candidate hash to the span.

pub fn with_para_id(self, para_id: Id) -> Span

Attach a para-id to the span.

pub fn with_stage(self, stage: Stage) -> Span

Attach a candidate stage. Should always come with a CandidateHash.

pub fn with_validator_index(self, validator: ValidatorIndex) -> Span

pub fn with_chunk_index(self, chunk_index: u32) -> Span

pub fn with_relay_parent(self, relay_parent: H256) -> Span

pub fn with_claimed_validator_index( self, claimed_validator_index: ValidatorIndex ) -> Span

pub fn with_pov(self, pov: &PoV) -> Span

pub fn with_int_tag(self, tag: &'static str, i: i64) -> Span

Add an additional int tag to the span without consuming.

Should be used sparingly, introduction of new types is preferred.

pub fn with_uint_tag(self, tag: &'static str, u: u64) -> Span

pub fn with_string_fmt_debug_tag<V>(self, tag: &'static str, val: V) -> Spanwhere V: Debug,

pub fn add_follows_from(&mut self, other: &Span)

Adds the FollowsFrom relationship to this span with respect to the given one.

pub fn add_pov(&mut self, pov: &PoV)

Add a PoV hash meta tag with lazy hash evaluation, without consuming the span.

pub fn add_para_id(&mut self, para_id: Id)

pub fn add_string_tag<V>(&mut self, tag: &'static str, val: V)where V: ToString,

Add a string tag, without consuming the span.

pub fn add_string_fmt_debug_tag<V>(&mut self, tag: &'static str, val: V)where V: Debug,

Add a string tag, without consuming the span.

pub fn add_int_tag(&mut self, tag: &'static str, value: i64)

pub fn add_uint_tag(&mut self, tag: &'static str, value: u64)

pub const fn is_enabled(&self) -> bool

Check whether jaeger is enabled in order to avoid computational overhead.

pub fn trace_id(&self) -> Option<u128>

Obtain the trace identifier for this set of spans.

Trait Implementations

impl Debug for Span

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

Formats the value using the given formatter.

impl From<Option<Span>> for Span

fn from(src: Option<Span>) -> Span

Converts to this type from the input type.

impl From<Span> for Span

fn from(src: Span) -> Span

Converts to this type from the input type.