Struct Dial9Config 

pub struct Dial9Config(/* private fields */);

Available on crate feature dial9 only.

Finalized configuration consumed by the #[main] macro.

Constructed via Dial9Config::builder() followed by either:

• Dial9ConfigBuilder::build — strict; returns Result<Dial9Config, Dial9ConfigBuilderError>. The RotatingWriter is probed eagerly inside build, so any I/O failure surfaces here rather than later when the runtime is built.
• Dial9ConfigBuilder::build_or_disabled — lenient; never reports a build error, downgrades to a disabled config that preserves the user’s with_tokio configurators on validation or I/O failure.

Implementations

impl Dial9Config

pub fn from_env() -> Dial9Config

Build a production-oriented config from standard DIAL9_* environment variables.

Supported local trace writer variables:

Variable	Default	Meaning
DIAL9_ENABLED	false	Master switch for installing telemetry.
DIAL9_TRACE_DIR	/tmp/dial9-traces	Directory for rotated trace segments.
DIAL9_ROTATION_SECS	60	Rotation period in seconds, measured monotonically from writer start.
DIAL9_MAX_DISK_USAGE_MB	1024	Total on-disk trace budget in MiB.
DIAL9_MAX_FILE_SIZE_MB	min(100, total / 4)	Per-file trace segment size in MiB.

Supported runtime variables:

Variable	Default	Meaning
DIAL9_TASK_TRACKING_ENABLED	true	Track tasks spawned through dial9 handles.
DIAL9_TOKIO_INSTRUMENTATION_ENABLED	true	Install dial9’s Tokio runtime hook instrumentation.
DIAL9_RUNTIME_NAME	unset	Human-readable runtime name in trace metadata.

Supported S3 variables (worker-s3 feature required):

Variable	Default	Meaning
DIAL9_S3_BUCKET	unset	Upload sealed trace segments to this bucket.
DIAL9_SERVICE_NAME	binary name	Service name used in S3 keys and metadata.
DIAL9_S3_PREFIX	dial9-traces	S3 object key prefix.

Supported CPU profiling variables (cpu-profiling feature required):

Variable	Default	Meaning
DIAL9_CPU_PROFILE_ENABLED	true on Linux with cpu-profiling, false otherwise	Enable CPU stack sampling.
DIAL9_CPU_SAMPLE_HZ	99	CPU sampling frequency in Hz.
DIAL9_SCHEDULE_PROFILE_ENABLED	true on Linux with cpu-profiling, false otherwise	Enable per-worker scheduler event capture. Requires the CPU profiling setup.

Supported process resource usage variables:

Variable	Default	Meaning
DIAL9_PROCESS_RESOURCE_USAGE_ENABLED	true on Unix, false otherwise	Enable process resource usage sampling from getrusage(RUSAGE_SELF).
DIAL9_PROCESS_RESOURCE_USAGE_SAMPLE_INTERVAL_MS	100	Sampling interval in milliseconds.

Supported task dump variables (capture requires the taskdump feature):

Variable	Default	Meaning
DIAL9_TASK_DUMP_ENABLED	false	Capture async task dumps at idle yield points.
DIAL9_TASK_DUMP_IDLE_THRESHOLD_MS	10	Mean idle duration for task dump sampling.

Missing variables use defaults. Blank, invalid, or non-Unicode values emit a warning and are treated as missing. Some numeric defaults come from the underlying config builders and are listed here as the current from_env() behavior. The returned config is built with Dial9ConfigBuilder::build_or_disabled, so writer setup failures are logged and downgraded to a plain Tokio runtime.

impl Dial9Config

pub fn builder() -> Dial9ConfigBuilder

Start a fluent configuration chain.

When telemetry is enabled (the default), the following setters are required: base_path and max_total_size. They may be omitted if .enabled(false) is set, in which case a plain tokio runtime is built without telemetry.

max_file_size is optional; when not set, the underlying RotatingWriter defaults it to min(100 MiB, max_total_size / 4).

Trait Implementations

impl Debug for Dial9Config

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

Formats the value using the given formatter.

impl TryFrom<Dial9Config> for TracedRuntime

type Error = TelemetryRuntimeError

The type returned in the event of a conversion error.

fn try_from( config: Dial9Config, ) -> Result<TracedRuntime, <TracedRuntime as TryFrom<Dial9Config>>::Error>

Performs the conversion.