Struct ProviderRequestRecord 

pub struct ProviderRequestRecord {
    pub provider: String,
    pub model: String,
    pub timestamp: DateTime<Utc>,
    pub prompt_tokens: u64,
    pub completion_tokens: u64,
    pub input_tokens: u64,
    pub output_tokens: u64,
    pub latency_ms: u64,
    pub ttft_ms: Option<u64>,
    pub success: bool,
}

One LLM provider request. Push into super::ProviderMetrics via super::ProviderMetrics::record.

Note: prompt_tokens / completion_tokens and input_tokens / output_tokens carry the same numbers — the duplication exists because different downstream consumers were written against different field names.

Examples

use codetether_agent::telemetry::ProviderRequestRecord;
use chrono::Utc;

let r = ProviderRequestRecord {
    provider: "anthropic".into(),
    model: "claude-sonnet-4".into(),
    timestamp: Utc::now(),
    prompt_tokens: 1_000,
    completion_tokens: 500,
    input_tokens: 1_000,
    output_tokens: 500,
    latency_ms: 2_000,
    ttft_ms: Some(300),
    success: true,
};
assert!((r.tokens_per_second() - 250.0).abs() < 1e-6);

Fields

provider: String

Provider name (e.g. "anthropic", "openai").

model: String

Model id (e.g. "claude-sonnet-4").

timestamp: DateTime<Utc>

When the request started (or completed — callers are consistent).

prompt_tokens: u64

Input tokens (provider’s prompt_tokens field).

completion_tokens: u64

Output tokens (provider’s completion_tokens field).

input_tokens: u64

Duplicate of prompt_tokens under the wire-format name.

output_tokens: u64

Duplicate of completion_tokens under the wire-format name.

latency_ms: u64

End-to-end latency in milliseconds.

ttft_ms: Option<u64>

Time-to-first-token in milliseconds, when the provider streamed.

success: bool

true iff the provider returned a non-error response.

Implementations

impl ProviderRequestRecord

pub fn tokens_per_second(&self) -> f64

Output tokens per second over the full request latency. Returns 0.0 when latency_ms is zero, never panics.

Trait Implementations

impl Clone for ProviderRequestRecord

fn clone(&self) -> ProviderRequestRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderRequestRecord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ProviderRequestRecord

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ProviderRequestRecord

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

where __S: Serializer,

Serialize this value into the given Serde serializer.