Struct OwnedRuntimeHandle 

pub struct OwnedRuntimeHandle { /* private fields */ }

Available on crate feature std only.

A cloneable handle targeting one specific OwnedRuntime.

Unlike an ambient spawn helper, this handle targets one Tokio runtime and, when enabled, retains the dial9 telemetry session to which work belongs. It can therefore spawn correctly instrumented tasks from arbitrary threads.

The handle does not keep the runtime itself alive. Retain the owning OwnedRuntime, a blocking::Runtime, or a derived blocking wrapper while using it.

Implementations

impl OwnedRuntimeHandle

pub fn current() -> OwnedRuntimeHandle

Capture the current Tokio runtime and dial9 telemetry session.

Panics

Panics when called outside a Tokio runtime context.

pub fn enter(&self) -> EnterGuard<'_>

Enter the targeted Tokio runtime on the calling thread.

pub fn spawn<F>(&self, future: F) -> JoinHandle<<F as Future>::Output>

where F: Future + Send + 'static, <F as Future>::Output: Send + 'static,

Spawn an owned task on the targeted runtime.

With dial9 enabled, the task is associated with the exact telemetry session captured by this handle, even when called from another thread.

Trait Implementations

impl Clone for OwnedRuntimeHandle

fn clone(&self) -> OwnedRuntimeHandle

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for OwnedRuntimeHandle

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

Formats the value using the given formatter.

impl From<Handle> for OwnedRuntimeHandle

fn from(tokio: Handle) -> OwnedRuntimeHandle

Converts to this type from the input type.