Tracking Usage
Learn how to track usage events in your application
Track usage events to monitor AI consumption across your application.
Basic Tracking
await client.track.trackUsage({
customerId: 'customer_123',
eventType: 'model_call',
model: 'gpt-4',
provider: 'openai',
inputTokens: 100,
outputTokens: 50,
totalTokens: 150,
});await client.track.track_usage(
customer_id="customer_123",
event_type="model_call",
model="gpt-4",
provider="openai",
input_tokens=100,
output_tokens=50,
total_tokens=150,
)Advanced Tracking
Add custom properties and metadata to your events.
await client.track.trackUsage({
customerId: 'customer_123',
eventType: 'model_call',
model: 'gpt-4',
provider: 'openai',
inputTokens: 100,
outputTokens: 50,
totalTokens: 150,
costCents: 25,
latencyMs: 1200,
properties: {
user_id: 'user_456',
team_id: 'team_eng',
feature: 'chat',
},
idempotencyKey: 'req_abc123',
});await client.track.track_usage(
customer_id="customer_123",
event_type="model_call",
model="gpt-4",
provider="openai",
input_tokens=100,
output_tokens=50,
total_tokens=150,
cost_cents=25,
latency_ms=1200,
properties={
"user_id": "user_456",
"team_id": "team_eng",
"feature": "chat",
},
idempotency_key="req_abc123",
)Next Steps
- Setting Quotas - Enforce usage limits
- Usage Analytics - Analyze usage data