Struct TraceRunMeta 

pub struct TraceRunMeta {

    pub run_id: String,
    pub correlation_id: String,
    pub entrypoint: String,
    pub phase: ExecutionPhase,
    pub timestamp: String,
    pub capture_step: u64,
    pub warmup_steps: u64,
    pub device: String,
    pub measured_region_device_synchronized: bool,
    pub timing_mode: TimingMode,
    pub capture_contract: CaptureContract,
    pub comparison_identity: Option<ComparisonIdentity>,
    pub tags: BTreeMap<String, String>,
    pub candle_version: Option<String>,
}

Run metadata carried in the first JSONL meta event.

Fields

run_id: String

Stable identifier for this probe run (UUID, build id, or caller-defined key).

correlation_id: String

Stable caller-owned key shared with NVTX range labels and external artifacts.

entrypoint: String

Analyzed entrypoint, e.g. train::leworld_loss or Model::forward.

phase: ExecutionPhase

Execution phase: train or infer.

timestamp: String

ISO-8601 timestamp when the trace was captured.

capture_step: u64

One-based optimizer update or inference invocation selected for capture.

warmup_steps: u64

Completed invocations before the selected capture.

device: String

Device requested by the caller (cpu, cuda:0, …).

measured_region_device_synchronized: bool

Whether the single measured region is bounded by device synchronizations. Nested span durations remain governed by timing_mode.

timing_mode: TimingMode

capture_contract: CaptureContract

comparison_identity: Option<ComparisonIdentity>

tags: BTreeMap<String, String>

Workload-specific provenance such as lesson, batch size, and source revision.

candle_version: Option<String>

Optional candle crate version observed at probe time.

Implementations

impl TraceRunMeta

pub fn validate(&self) -> Result<()>

Validate provenance domain invariants before trusting a parsed or constructed run. Producers enforce these at capture time; consumers re-check them because traces can come from external tools or hand-edited files.

Trait Implementations

impl Clone for TraceRunMeta

fn clone(&self) -> TraceRunMeta

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TraceRunMeta

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TraceRunMeta

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for TraceRunMeta

impl PartialEq for TraceRunMeta

fn eq(&self, other: &TraceRunMeta) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for TraceRunMeta

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for TraceRunMeta