Module dial9

Available on crate feature dial9 only.

Expand description

dial9 runtime telemetry re-exports.

Modules§

core: Building blocks for extending dial9: implement a Source, write custom encoders, author custom segment processors, reach the raw recording modules.
format: The trace format: define events with #[derive(TraceEvent)], encode your own types with TraceField, read a trace back with Decoder.
trace_format: dial9-trace-format

Dial9Handle: Cheap, cloneable handle for recording events and controlling telemetry.
Dial9TokioHandle: Tokio handle for spawning instrumented tasks.
Disk: Disk-backed mode (default).
InstallGlobalHandleError: Recorder::install_global_handle did not install: a process-global Dial9Handle was already installed.
Memory: In-memory mode.
Recorder: Owns the recording state: the Dial9Handle, the flush thread, and (with the pipeline feature) the background worker.
RecorderBuilder: Builder for a runtime-agnostic Recorder. See recorder.
TaskDumpConfig: Configuration for task dump capture.
TokioAttachOptions: Per-runtime attach settings. All optional; runtime-scoped only (session-wide settings like the pipeline, S3, and segment metadata stay on the recorder).
TokioHooks: User-provided callbacks to run alongside dial9’s internal Tokio runtime hooks.
TracedFuture: Future wrapper produced by spawn_with for custom spawn APIs.

block_on: Run future to completion on runtime, instrumented.
record_event: Record an event on the handle Dial9Handle::current resolves.
recorder: Begin building a recorder backed by writer.
recorder_disabled: A recorder with recording permanently disabled: no flush thread, no sources, and handle returns a disabled handle.
recorder_from_env: Build a recorder and its instrumented Tokio runtime from standard DIAL9_* environment variables.
recorder_from_env_with: recorder_from_env, plus control over the Tokio runtime it builds.
recorder_or_disabled: Begin building a recorder backed by writer, or a writer-free disabled one when the writer could not be created.
spawn: Spawn a traced task on the current tokio runtime.
spawn_in: Spawn a traced task onto a specific runtime, from any thread.

AttachedRuntime: The recorder and runtime pair a #[dial9::main] config returns.
DiskBuffer: Alias for the disk-backed writer (the default mode).
MemoryBuffer: Alias for the in-memory writer.