Struct Dial9ConfigBuilder 

pub struct Dial9ConfigBuilder<M = PipelineUnset> { /* private fields */ }

Available on crate feature dial9 only.

Builder for a Dial9Config with telemetry enabled.

Created via Dial9ConfigBuilder::new. Exposes both tokio and dial9 runtime knobs. Call .build() to produce a Dial9Config.

The M parameter mirrors the inner TracedRuntimeBuilder’s pipeline-mode marker. It defaults to PipelineUnset and transitions when with_runtime returns a builder in a different mode (e.g. after .with_s3_uploader(...) or .with_custom_pipeline(...)).

Implementations

impl Dial9ConfigBuilder

pub fn new( base_path: impl Into<PathBuf>, max_file_size: u64, max_total_size: u64, ) -> Dial9ConfigBuilder

Start a new configuration with the three required writer fields.

• base_path — trace file path
• max_file_size — per-file rotation threshold in bytes
• max_total_size — total disk budget in bytes

pub fn disabled() -> DisabledDial9ConfigBuilder

Create a DisabledDial9ConfigBuilder that builds a plain tokio runtime with no telemetry. Only .with_tokio() is available.

impl<M> Dial9ConfigBuilder<M>

where M: Send + 'static,

pub fn rotation_period(self, period: Duration) -> Dial9ConfigBuilder<M>

Set the time-based rotation period for the writer.

pub fn with_runtime<F, N>(self, f: F) -> Dial9ConfigBuilder<N>

where F: FnOnce(TracedRuntimeBuilder<HasTracePath, M>) -> TracedRuntimeBuilder<HasTracePath, N>, N: Send + 'static,

Customize the dial9 TracedRuntimeBuilder.

The closure receives the staged builder by value and must return it. Use this to access runtime configuration methods like with_runtime_name, with_task_tracking, with_s3_uploader, or with_custom_pipeline; see TracedRuntimeBuilder for the full list.

Closures may transition the pipeline-mode marker (M) — e.g. calling .with_s3_uploader(...) returns a builder in PipelineS3 mode. The transition is reflected on the returned Dial9ConfigBuilder<N>.

Can be called multiple times; each call composes onto the prior state.

pub fn with_tokio<F>(self, f: F) -> Dial9ConfigBuilder<M>

where F: FnOnce(&mut Builder),

Customize the underlying [tokio::runtime::Builder].

The closure receives the staged builder by mutable reference — use any tokio knob (worker_threads, thread_name, thread_stack_size, global_queue_interval, etc.). The builder is pre-seeded with enable_all() and new_multi_thread(). To switch flavors, replace the whole builder inside the closure: *t = tokio::runtime::Builder::new_current_thread(); t.enable_all();.

Can be called multiple times; each call composes onto the prior state.

pub fn build(self) -> Dial9Config

Finalize into a Dial9Config ready for the macro.

Trait Implementations

impl<M> Debug for Dial9ConfigBuilder<M>

where M: Debug,

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

Formats the value using the given formatter.