One usage record.
Every source is read into the same shape. What is here is everything the ledger knows about one call, seat-day or bill line; what is not here cannot be stored, by a test that fails the build.
Identity
- id
- Stable within the organization; a re-sync never counts a record twice.
- source
- The connector that read it.
- source_record_id
- The vendor's own id for the line, or the hash of it.
- invocation_id
- One call, one id; attempts of the same call share it.
- trace_id
- The trace the call ran in, when the source carries one: the join to an outcome.
When and who
- occurred_at
- The instant, UTC.
- provider_id
- The vendor that served it.
- model_id
- The model, as the vendor names it.
- application_id
- The application or key that made the call.
- agent_id
- The agent, once attribution has given the call one.
- workflow_id
- The workflow, once attribution has given the call one.
- team_id
- The team, from a tag, a rule or the registry.
- project_id · customer_id
- When the vendor or a rule carries them.
How much
- input_tokens · output_tokens · cached_tokens
- By the vendor's own count.
- request_count
- Calls in the line; one for a call, more for a daily bucket.
- metering
- tokens, seats, audio_seconds, images, or bill.
- workload
- The class of use, from a tag, the registry or the call's shape.
How it went
- status
- ok, error or timeout.
- latency_ms
- As the source reports it.
- attempt · retry_count
- Which attempt this was, and how many came before it: the retry line every finding reads.
What it cost
- normalized_cost_micros
- The ledger's figure, in integer millionths of a dollar, from the rate card that applied.
- source_cost_micros
- What the source itself said it cost, when it said.
- pricing_version
- Which rate card priced it; a price never changes without a person reading the diff.
- currency
- USD.
Metadata
- inference_profile · api_key_id · region
- What the vendor attaches; what a rule can match on.
- complexity
- One to five, when the source carries a signal.
- prompt_signature
- A hash of the prompt's shape, never its text: the caching detector reads it.
- person
- A hash of the seat holder, never a login or an email.
Not in the record
There is no field for any of these. A connector that received one would have nowhere to put it, and the shape is held by a test.
- prompts
- completions
- conversations
- transcripts
- documents
- source code
- names
Money
Every amount is an integer number of millionths of a dollar. Sums are exact; every grouping on every screen adds back to the ledger total, and a test holds it for every dimension. A rate card names the version that priced a record; a price never changes without a person reading the diff.