Struct Operation 

pub struct Operation { /* private fields */ }

Available on crate feature dial9 only.

A lifecycle recorded only when the ambient recorder is enabled at creation.

Construct inside the future being observed so an unpolled future emits nothing. Dropping an unfinished operation attempts a cancellation event once. No clock read, ID allocation, or event construction occurs when disabled. Pausing/stopping the recorder, dropped batches and segment eviction can leave incomplete lifecycles in the retained recording.

Use record_event_with for application details; the closure receives IDs that also identify Rama’s child operations. Avoid recording payloads or high-cardinality strings unless they are needed.

Implementations

impl Operation

pub fn new(name: &'static str) -> Operation

pub fn context(&self) -> TraceContext

pub fn is_recorded(&self) -> bool

Whether this operation was started in an enabled recording.

pub fn elapsed(&self) -> Duration

Elapsed time for an active operation; zero when recording was disabled.

pub fn record_event_with<E>(&self, make: impl FnOnce(TraceContext) -> E)

where E: Encodable,

Lazily add protocol or application information to this operation.

pub fn finish(self, outcome: Outcome)

End the operation without directional byte totals.

pub fn finish_with_bytes(self, outcome: Outcome, sent: u64, received: u64)

End the operation with bytes sent and received at this protocol boundary. These are not necessarily wire bytes (for example, HTTP body bytes).

Trait Implementations

impl Debug for Operation

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

Formats the value using the given formatter.

impl Drop for Operation

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.