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.
Dial9TokioHandletokio: 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.
TaskDumpConfigtokio: Configuration for task dump capture.
TokioAttachOptionstokio: Per-runtime attach settings. All optional; runtime-scoped only (session-wide settings like the pipeline, S3, and segment metadata stay on the recorder).
TokioHookstokio: User-provided callbacks to run alongside dial9’s internal Tokio runtime hooks.
TracedFuturetokio: Future wrapper produced by spawn_with for custom spawn APIs.

Dial9HandleTokioExttokio: Tokio instrumentation for Dial9Handle.
JoinSetExttokio: Dial9 instrumentation for [JoinSet].
RecorderPipelineExttokio: dial9 pipeline presets on the recorder builder.
RecorderSourceExtDeprecated: Empty, its methods are inherent on RecorderBuilder now.

block_ontokio: 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_envtokio: Build a recorder and its instrumented Tokio runtime from standard DIAL9_* environment variables.
recorder_from_env_withtokio: 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.
spawntokio: Spawn a traced task on the current tokio runtime.
spawn_intokio: Spawn a traced task onto a specific runtime, from any thread.

AttachedRuntimetokio: 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.

maintokio: Instrument an async main with dial9 telemetry. Replaces #[tokio::main]. Instrument an async main function with dial9 telemetry.