Struct DumpTrigger 

pub struct DumpTrigger { /* private fields */ }

Available on crate features dial9 and pipeline only.

Sending half of the trigger channel.

Cloneable; reach it from any thread owned by the runtime via Dial9Handle::dump_trigger and hand it to whatever subsystem decides when to dump (an idle-ratio watcher, a panic hook, a /dump HTTP handler, …). Every clone shares the debounce gate configured by DumpTriggerConfig::debounce.

Implementations

impl DumpTrigger

pub fn with_debounce(self, window: Duration) -> DumpTrigger

Coalesce duplicate triggers within window into a single dump.

Applied once at build time from DumpTriggerConfig::debounce; every dump_trigger clone then shares one gate. The first trigger in a quiet period dispatches normally; any trigger arriving within window of that dispatch resolves DumpError::Coalesced (naming the dump it folded into) without starting a new dump. Useful when a single source - a watcher that re-trips every poll, a hot path that dumps per slow request - would otherwise fire a burst of near-identical dumps.

pub fn dump_current_data(&self) -> DumpRun<'_>

Capture everything the ring still holds, right now. No forward window.

pub fn dump_time_range( &self, lookback: Duration, lookforward: Duration, ) -> DumpRun<'_>

Capture the window [trigger - lookback, trigger + lookforward]. Either side may be Duration::ZERO.

lookback captures pre-trigger segments; you can look back only as far as the ring still retains, so a lookback wider than the retained history is best-effort and captures what survived. lookforward keeps the dump open until trigger + lookforward, attaching segments as they seal; it is bounded only by the process lifetime and is best-effort under upload pressure. The actual covered span is reported on DumpReceipt::time_range. This never errors and never resizes or pins the ring.

Trait Implementations

impl Clone for DumpTrigger

fn clone(&self) -> DumpTrigger

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DumpTrigger

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

Formats the value using the given formatter.