Struct TraceMetrics 

pub struct TraceMetrics {

    pub scope: EvaluationScope,
    pub started_at_millis: Option<u64>,
    pub ended_at_millis: Option<u64>,
    pub elapsed_ms: Option<u64>,
    pub record_count: usize,
    pub run_count: usize,
    pub turn_count: usize,
    pub provider_call_count: u64,
    pub provider_input_tokens: u64,
    pub provider_output_tokens: u64,
    pub provider_total_tokens: u64,
    pub tool_call_count: u64,
    pub tool_completed_count: u64,
    pub tool_failed_count: u64,
    pub tool_timed_out_count: u64,
    pub tool_cancelled_count: u64,
    pub tool_denied_count: u64,
    pub tool_rewritten_count: u64,
    pub tool_unknown_count: u64,
    pub tool_recovery_required_count: u64,
    pub tool_total_elapsed_ms: Option<u64>,
    pub tools: Vec<ToolTraceMetric>,
}

Deterministic metrics for a turn, run, session, or custom trace scope.

Fields

scope: EvaluationScope

Scope these metrics describe.

started_at_millis: Option<u64>

Earliest non-zero journal timestamp observed for this scope.

ended_at_millis: Option<u64>

Latest non-zero journal timestamp observed for this scope.

elapsed_ms: Option<u64>

ended_at_millis - started_at_millis when both are available.

record_count: usize

Number of journal records inspected for this scope.

run_count: usize

Number of distinct runs represented in this scope.

turn_count: usize

Number of distinct turns represented in this scope.

provider_call_count: u64

Number of completed provider attempts.

provider_input_tokens: u64

Sum of provider-reported input tokens.

provider_output_tokens: u64

Sum of provider-reported output tokens.

provider_total_tokens: u64

Sum of provider-reported total tokens.

tool_call_count: u64

Number of distinct tool calls represented in this scope.

tool_completed_count: u64

Number of tools whose latest terminal status is completed.

tool_failed_count: u64

Number of tools whose latest terminal status is failed.

tool_timed_out_count: u64

Number of tools whose latest terminal status is timed out.

tool_cancelled_count: u64

Number of tools whose latest terminal status is cancelled.

tool_denied_count: u64

Number of tools denied before execution.

tool_rewritten_count: u64

Number of tools whose result was rewritten by a hook.

tool_unknown_count: u64

Number of tools whose latest terminal status is unknown.

tool_recovery_required_count: u64

Number of tools that require recovery.

tool_total_elapsed_ms: Option<u64>

Sum of per-tool elapsed milliseconds when at least one tool has timing.

tools: Vec<ToolTraceMetric>

Per-tool metrics, one row per distinct tool call id.

Implementations

impl TraceMetrics

pub fn from_turn_trace(trace: &TurnTrace) -> Result<Self, AgentError>

Builds deterministic metrics from a turn trace.

pub fn from_run_trace(trace: &RunTrace) -> Result<Self, AgentError>

Builds deterministic metrics from a run trace.

pub fn from_session_timeline(timeline: &SessionTimeline) -> Self

Builds deterministic metrics from a session timeline.

Trait Implementations

impl Clone for TraceMetrics

fn clone(&self) -> TraceMetrics

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TraceMetrics

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TraceMetrics

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for TraceMetrics

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for TraceMetrics

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for TraceMetrics

impl StructuralPartialEq for TraceMetrics