Struct DumpRun 

pub struct DumpRun<'a> { /* private fields */ }

Available on crate features dial9 and pipeline only.

In-flight dump request.

The dump is dispatched within the statement that created it: either when this handle is awaited or when it is dropped, whichever comes first. The handle is only needed to retrieve the DumpReceipt; dropping it does not cancel the dump. Chain with_metadata before awaiting to attach correlation pairs.

Implementations

impl<'a> DumpRun<'a>

pub fn with_metadata( self, key: impl Into<String>, value: impl Into<String>, ) -> DumpRun<'a>

Attach a caller-supplied correlation pair. Chainable. Each pair is stamped onto every captured segment’s metadata (namespaced as dump.{key}) before the pipeline runs; pipeline stages decide what to do with them (the S3 stage surfaces them as additional user metadata).

Trait Implementations

impl<'a> Debug for DumpRun<'a>

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

Formats the value using the given formatter.

impl Drop for DumpRun<'_>

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.

impl<'a> IntoFuture for DumpRun<'a>

type Output = Result<DumpReceipt, DumpError>

The output that the future will produce on completion.

type IntoFuture = DumpFuture

Which kind of future are we turning this into?

fn into_future(self) -> <DumpRun<'a> as IntoFuture>::IntoFuture

Creates a future from a value.