Struct MetricEvent 

pub struct MetricEvent {

    pub ts: u64,
    pub tool: &'static str,
    pub duration_ms: u64,
    pub output_chars: usize,
    pub param_path_depth: usize,
    pub max_depth: Option<u32>,
    pub result: &'static str,
    pub error_type: Option<String>,
    pub error_subtype: Option<String>,
    pub session_id: Option<String>,
    pub seq: Option<u32>,
    pub cache_hit: Option<bool>,
    pub cache_tier: Option<&'static str>,
    pub cache_write_failure: Option<bool>,
    pub exit_code: Option<i32>,
    pub timed_out: bool,
    pub output_truncated: Option<bool>,
    pub chars_threshold_breach: bool,
    pub file_ext: Option<&'static str>,
    pub filter_applied: Option<String>,
    pub language: Option<String>,
    pub git_ref_used: bool,
    pub summary_mode: bool,
    pub is_paginated: bool,
    pub fields_projected: bool,
    pub match_mode: Option<String>,
    pub follow_depth: Option<u32>,
    pub import_lookup: bool,
    pub def_use: bool,
    pub impl_only: bool,
    pub stdin_provided: bool,
    pub timeout_configured_ms: Option<i64>,
    pub drain_timeout_ms: Option<i64>,
    pub working_dir_used: bool,
    pub l1_eviction_count: Option<u64>,
    pub l2_entry_count: Option<u64>,
    pub l2_size_bytes: Option<u64>,
    pub stdout_bytes_raw: Option<u64>,
    pub stderr_bytes_raw: Option<u64>,
}

A single metric event emitted by a tool invocation.

Fields

ts: u64

tool: &'static str

duration_ms: u64

output_chars: usize

param_path_depth: usize

max_depth: Option<u32>

result: &'static str

error_type: Option<String>

error_subtype: Option<String>

session_id: Option<String>

seq: Option<u32>

cache_hit: Option<bool>

cache_tier: Option<&'static str>

cache_write_failure: Option<bool>

Set to Some(true) when an L2 disk cache write fails (dir, tempfile, write, or rename). Drives the cache_write_failures_total OTEL counter.

exit_code: Option<i32>

timed_out: bool

output_truncated: Option<bool>

chars_threshold_breach: bool

True when output_chars > 30_000; fires for the top ~0.33% of exec_command calls (p99.7 of 27,981 observed calls). Early-warning signal for responses approaching the per-stream byte-cap threshold.

file_ext: Option<&'static str>

File extension of the analyzed path, lowercased. Some("rs") for known extensions, Some("other") for unrecognized extensions, None when the path has no extension. Only populated for analyze_file and analyze_module.

filter_applied: Option<String>

Name of the filter rule that matched and transformed exec_command output. None when no filter fired or for non-exec_command tools.

language: Option<String>

Human-readable programming language name derived from the file extension (e.g., Some("Rust") for .rs files). None when the path has no extension or the extension is not recognized. Only populated for analyze_file and analyze_module.

git_ref_used: bool

Whether the tool call used a git_ref parameter. Populated by analyze_directory and analyze_symbol.

summary_mode: bool

Whether the tool call used summary=true or was auto-summarized. Populated by analyze_directory, analyze_file, and analyze_symbol.

is_paginated: bool

Whether the tool call used pagination (cursor was provided). Populated by analyze_directory, analyze_file, and analyze_symbol.

fields_projected: bool

Whether the fields parameter was provided to analyze_file. Populated by analyze_file.

match_mode: Option<String>

Symbol matching mode used by analyze_symbol (e.g., “exact”, “insensitive”). None when not an analyze_symbol call.

follow_depth: Option<u32>

Call graph traversal depth for analyze_symbol (default 1).

import_lookup: bool

Whether import_lookup=true was set on analyze_symbol.

def_use: bool

Whether def_use=true was set on analyze_symbol.

impl_only: bool

Whether impl_only=true was set on analyze_symbol.

stdin_provided: bool

Whether stdin was provided to exec_command.

timeout_configured_ms: Option<i64>

Configured timeout in milliseconds for exec_command. None means no limit.

drain_timeout_ms: Option<i64>

Drain timeout in milliseconds for exec_command. None means default (500ms).

working_dir_used: bool

Whether a working_dir parameter was provided. Populated by edit_overwrite, edit_replace, and exec_command.

l1_eviction_count: Option<u64>

L1 cache eviction count at the time of metric emission. Only populated for cache-related metrics.

l2_entry_count: Option<u64>

L2 disk cache entry count at the time of metric emission. Only populated for cache-related metrics.

l2_size_bytes: Option<u64>

L2 disk cache total size in bytes at the time of metric emission. Only populated for cache-related metrics.

stdout_bytes_raw: Option<u64>

Approximate stdout bytes read before any truncation, counted as line.len() + 1 per LinesStream line (last line and CRLF not exact). Only populated for exec_command when output_truncated=true, timed_out=false, and no drain-abort.

stderr_bytes_raw: Option<u64>

Approximate stderr bytes read before any truncation, counted as line.len() + 1 per LinesStream line (last line and CRLF not exact). Only populated for exec_command when output_truncated=true, timed_out=false, and no drain-abort.

Trait Implementations

impl Clone for MetricEvent

fn clone(&self) -> MetricEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MetricEvent

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

Formats the value using the given formatter.

impl Default for MetricEvent

fn default() -> MetricEvent

Returns the “default value” for a type.

impl Deserialize<'static> for MetricEvent

where MetricEvent: Default,

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

where __D: Deserializer<'static>,

Deserialize this value from the given Serde deserializer.

impl Serialize for MetricEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.