Struct TelemetryRecord 

pub struct TelemetryRecord {

    pub ts: u64,
    pub request_id: Option<String>,
    pub msg_id: Option<String>,
    pub model: String,
    pub attempt: u32,
    pub refusal_retries_used: Option<u32>,
    pub ttft_ms: Option<u64>,
    pub total_ms: u64,
    pub stop_reason: Option<String>,
    pub usage: UsageRecord,
    pub cost_usd: Option<f64>,
    pub ratelimit: Option<RateLimitRecord>,
    pub cache_diag: Option<CacheDiagRecord>,
    pub context: ContextRecord,
    pub keepwarm: bool,
    pub worker: bool,
    pub session_id: Option<String>,
    pub runtime_session_id: Option<String>,
    pub turn_id: Option<String>,
    pub trace_request_id: Option<String>,
    pub worker_agent: Option<String>,
    pub worker_handle: Option<String>,
    pub parent_session_id: Option<String>,
    pub parent_runtime_session_id: Option<String>,
    pub rollover_window: Option<u64>,
    pub rollover: bool,
}

One JSONL record per API call.

Fields

ts: u64

Unix epoch milliseconds at request completion.

request_id: Option<String>

msg_id: Option<String>

Anthropic message id (msg_...) from message_start.

model: String

attempt: u32

1-based attempt number that succeeded (1 = no retries).

refusal_retries_used: Option<u32>

Number of refusal retries consumed (0 = no refusals). Present only when > 0.

ttft_ms: Option<u64>

Milliseconds from request send to the first parsed model event — the request trace’s outcome.timings.first_model_event_ms. Absent when no event arrived, never 0.

total_ms: u64

Milliseconds from request send to stream close.

stop_reason: Option<String>

usage: UsageRecord

cost_usd: Option<f64>

Estimated USD cost of this call at API list prices (UsageRecord::cost_usd), also for OAuth/subscription auth.

ratelimit: Option<RateLimitRecord>

cache_diag: Option<CacheDiagRecord>

context: ContextRecord

keepwarm: bool

true only on prompt-cache keep-warm pings (task #444) so telemetry can separate pings from real turns. Absent on every turn record.

worker: bool

true when a subagent (worker runtime) made the request, so reports can split delegated traffic from the foreground session. Absent on foreground and internal records.

session_id: Option<String>

Persisted conversation id (20261028-045932-eb8e): the id of ~/.synaps-cli/sessions/<id>.json and synaps daemon sessions. Absent for unkeyed runtimes (workers, tests).

runtime_session_id: Option<String>

Runtime trace session id (session-<pid>-<ms>-<seq>): the session_id of this call’s request-trace.jsonl record. Not the persisted id.

turn_id: Option<String>

Request-trace turn id (turn-<pid>-<n>). Despite the name it is minted per logical request (same counter as trace_request_id), not per user turn.

trace_request_id: Option<String>

Request-trace request id (req-<pid>-<n>), shared by every attempt of one logical request. Not the provider’s request_id.

worker_agent: Option<String>

Worker records: the agent name (spike), or for an inline subagent its sanitized label (model-chosen text, [A-Za-z0-9_-], bounded).

worker_handle: Option<String>

Worker records: the subagent handle (sa_N).

parent_session_id: Option<String>

Worker records: the spawning session’s persisted session_id.

parent_runtime_session_id: Option<String>

Worker records: the spawning session’s runtime_session_id.

rollover_window: Option<u64>

The context window (2, 3, …) this request belongs to after an automatic context rollover, worker or foreground. Absent before the first rollover.

rollover: bool

true only on the first request of a rolled-over window: the request that writes the successor’s prompt cache. Absent otherwise.

Implementations

impl TelemetryRecord

pub fn set_correlation( &mut self, session: &TraceId, ids: Option<(&TraceId, &TraceId, &TraceId)>, )

Fill runtime_session_id / turn_id / trace_request_id from the request trace’s correlation ids. Without a tracer, session alone still names the runtime session.

pub fn now_ms() -> u64

Trait Implementations

impl Clone for TelemetryRecord

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TelemetryRecord

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

Formats the value using the given formatter.

impl Default for TelemetryRecord

fn default() -> Self

Returns the “default value” for a type.

impl Serialize for TelemetryRecord

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

where __S: Serializer,

Serialize this value into the given Serde serializer.