Crate trace_format 

Available on crate feature dial9 only.

dial9-trace-format

A compact binary trace format for recording timestamped events with schema-driven encoding. Events are described by schemas (registered at write time) and encoded with delta-compressed timestamps, LEB128 varints, and an interned string pool.

Crate layout

• encoder — high-level Encoder for writing traces
• decoder — streaming Decoder for reading traces
• codec — wire-format types (WireTypeId, PoolEntry) that appear in decoded frames
• schema — SchemaEntry and FieldDef describing event layouts
• types — field value types, the TraceField trait, and the EventEncoder used by derived code

Modules

codec

Wire-format encoding and decoding for trace frames.

deserde-deserialize

serde [Deserializer] for raw trace events.

decoder

Streaming decoder for reading trace files.

encoder

High-level encoder for writing trace files.

schema

Schema types describing event layouts.

types

Field types, values, and the TraceField trait.

Structs

DeserError

Error returned when deserializing a trace event into a typed value fails.

DynamicListRef

Opaque wrapper for a decoded dynamic list. Access elements via Self::iter.

DynamicMapRef

Opaque wrapper for a decoded dynamic map. Access entries via Self::iter.

EventEncoder

Short-lived encoder for writing the fields of a single event. Created by crate::encoder::Encoder::write and passed to crate::TraceEvent::encode_fields, analogous to fmt::Formatter.

InternedStackFrames

An interned stack-frame reference (pool ID). On the wire this is a PooledStackFrames (u32 LE).

InternedString

An interned string reference (pool ID). Created by Encoder::intern_string. On the wire this is a PooledString (u32 LE).

StackFrames

Newtype for stack frame addresses (leaf-first).

Enums

FieldValue

Owned field value. Decoded from the wire format.

Traits

TraceEvent

Trait implemented by #[derive(TraceEvent)] for compile-time event types.

TraceField

Trait for types that can be used as trace fields. Provides schema metadata (field_type), encoding (encode), and decoding (decode_ref).

Derive Macros

TraceEvent