Struct Trace 

pub struct Trace {

    pub id: Id,
    pub name: String,
    pub user_id: Option<String>,
    pub session_id: Option<String>,
    pub tags: Vec<String>,
    pub metadata: Value,
    pub environment: Option<String>,
    pub release: Option<String>,
    pub input: Option<Value>,
    pub output: Option<Value>,
    pub start_time: DateTime<Utc>,
    pub end_time: Option<DateTime<Utc>>,
    pub total_cost: Option<f64>,
    pub total_tokens: Option<u64>,
}

Trace represents a single graph invocation or request lifecycle.

A trace is the top-level container that groups all observations (spans, LLM calls, tool calls) generated during one execution. It maps to Langfuse’s Trace concept and Juncture’s thread_id.

Fields

id: Id

Unique trace identifier.

name: String

Human-readable name (typically the graph name).

user_id: Option<String>

User identifier for per-user cost/quality tracking.

session_id: Option<String>

Session identifier for multi-turn conversation grouping. Maps to Juncture’s thread_id.

tags: Vec<String>

Flexible string labels for categorization and filtering.

metadata: Value

Arbitrary key-value metadata.

environment: Option<String>

Deployment environment (production, staging, development).

release: Option<String>

Application release version.

input: Option<Value>

Graph input captured at invocation time.

output: Option<Value>

Graph output captured at completion time.

start_time: DateTime<Utc>

Trace start timestamp.

end_time: Option<DateTime<Utc>>

Trace end timestamp (set when graph completes).

total_cost: Option<f64>

Aggregated total cost in USD across all LLM calls.

total_tokens: Option<u64>

Aggregated total tokens consumed.

Implementations

impl Trace

pub fn new(name: impl Into<String>) -> Self

Create a new trace with the given name.

pub fn complete( &mut self, output: Option<Value>, total_cost: Option<f64>, total_tokens: Option<u64>, )

Mark the trace as completed with optional output and aggregated metrics.

Trait Implementations

impl Clone for Trace

fn clone(&self) -> Trace

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Trace

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Trace

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Trace

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

where __S: Serializer,

Serialize this value into the given Serde serializer.