Struct UsageRecord 

pub struct UsageRecord {
    pub id: Uuid,
    pub session_id: Uuid,
    pub message_id: Uuid,
    pub provider: String,
    pub model: String,
    pub input_tokens: u64,
    pub output_tokens: u64,
    pub total_tokens: u64,
    pub created_at: DateTime<Utc>,
}

Detailed token usage record for a single provider interaction.

Tracks per-request token consumption broken down by provider, model, session, and message for cost accounting and analytics.

Fields

id: Uuid

Unique record identifier.

session_id: Uuid

Session this usage belongs to.

message_id: Uuid

Message that produced this usage.

provider: String

Provider that served the request.

model: String

Model that served the request.

input_tokens: u64

Number of input (prompt) tokens consumed.

output_tokens: u64

Number of output (completion) tokens consumed.

total_tokens: u64

Total token count.

created_at: DateTime<Utc>

When the usage was recorded.

Implementations

impl UsageRecord

pub fn new( session_id: Uuid, message_id: Uuid, provider: impl Into<String>, model: impl Into<String>, usage: TokenUsage, ) -> Self

Creates a usage record from a provider response with a generated UUIDv7 ID and current timestamp.

The token counts are extracted from the given TokenUsage struct.

Trait Implementations

impl Clone for UsageRecord

fn clone(&self) -> UsageRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UsageRecord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for UsageRecord

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for UsageRecord

fn eq(&self, other: &UsageRecord) -> 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 UsageRecord

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for UsageRecord