Struct TracyTrace 

pub struct TracyTrace { /* private fields */ }

In-memory collection of Tracy trace records.

Holds zones, text messages, and numeric plot entries that can be exported to a CSV file understood by Tracy-compatible tooling.

Example

use trustformers_debug::export::tracy::TracyTrace;

let trace = TracyTrace::new();
assert!(trace.is_empty());

Implementations

impl TracyTrace

pub fn new() -> Self

Creates an empty trace.

pub fn is_empty(&self) -> bool

Returns true if the trace contains no records of any kind.

pub fn total_records(&self) -> usize

Returns the total number of records (zones + messages + plots).

pub fn add_zone(&mut self, zone: TracyZone)

Appends a profiling zone.

Example

use trustformers_debug::export::tracy::{TracyTrace, TracyZone};

let mut trace = TracyTrace::new();
trace.add_zone(TracyZone {
    name: "forward".to_string(),
    timestamp_ns: 0,
    duration_ns: 1000,
    thread_id: 0,
});
assert_eq!(trace.zones().len(), 1);

pub fn add_message(&mut self, msg: &str, timestamp_ns: u64)

Appends a text message with a timestamp.

Example

use trustformers_debug::export::tracy::TracyTrace;

let mut trace = TracyTrace::new();
trace.add_message("epoch started", 1_000_000);
assert_eq!(trace.messages().len(), 1);

pub fn add_plot(&mut self, name: &str, value: f64, timestamp_ns: u64)

Appends a named numeric plot value with a timestamp.

Example

use trustformers_debug::export::tracy::TracyTrace;

let mut trace = TracyTrace::new();
trace.add_plot("loss", 0.42, 2_000_000);
assert_eq!(trace.plots().len(), 1);

pub fn zones(&self) -> &[TracyZone]

Read-only view of the recorded zones.

pub fn messages(&self) -> &[(String, u64)]

Read-only view of the recorded messages.

pub fn plots(&self) -> &[(String, f64, u64)]

Read-only view of the recorded plot entries.

pub fn export_to_file(&self, path: &Path) -> Result<()>

Writes the trace to path in Tracy CSV format.

Records are emitted in the order: zones (each zone becomes a ZoneBegin / ZoneEnd pair), messages, then plots.

Errors

Returns an error if the file cannot be created or written.

Example

use trustformers_debug::export::tracy::TracyTrace;

let trace = TracyTrace::new();
trace.export_to_file(std::path::Path::new("/tmp/trace.csv")).unwrap();

Trait Implementations

impl Debug for TracyTrace

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

Formats the value using the given formatter.

impl Default for TracyTrace

fn default() -> TracyTrace

Returns the “default value” for a type.

impl From<&TracyTrace> for ProfilingTrace

fn from(t: &TracyTrace) -> Self

Converts to this type from the input type.