Struct Instrumentation 

pub struct Instrumentation { /* private fields */ }

A dynamic, isolated tracing instrumentation. Each instrumentation takes a dedicated slot. The slot number identifies which slot this instrumentation uses. The slot number is used to map to that slot in SLOTS, and in the OTel Context to identify which (active) span belongs to the slot.

Implementations

impl Instrumentation

pub fn builder() -> InstrumentationBuilder

Create a new InstrumentationBuilder.

pub fn is_distributed(&self) -> bool

Whether this is the distributed instrumentation (see InstrumentationBuilder::distributed).

pub fn enable_all(&self)

Enable every known #[traceable] function for this instrumentation.

pub fn disable_all(&self)

Disable every function for this instrumentation.

pub fn set_enabled<S: AsRef<str>>( &self, selectors: &[S], ) -> Result<Selection, UnknownKeys>

Replace this instrumentation’s enabled sites with the ones the provided selectors resolve to.

Errors

UnknownKeys does not resolve to any #[traceable] function. In that case nothing is applied and this instrumentation keeps the set it already had.

pub fn enable<S: AsRef<str>>( &self, selectors: &[S], ) -> Result<Selection, UnknownKeys>

Enable everything that selectors resolves to, leaving the rest of the enabled set unchanged (additive).

Errors

As set_enabled.

pub fn disable<S: AsRef<str>>( &self, selectors: &[S], ) -> Result<Selection, UnknownKeys>

Disable everything that selectors resolves to, leaving the rest of the enabled set unchanged.

Errors

As set_enabled.

pub fn enabled_names(&self) -> impl Iterator<Item = &'static str>

Registry keys currently enabled for this instrumentation.

Trait Implementations

impl Debug for Instrumentation

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

Formats the value using the given formatter.

impl Drop for Instrumentation

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.