ODOCK.AI
ObservabilityUsage Records

Record details

The single-pane view of one gateway request.

Record details

Clicking a row in the Usage Records table opens the detail page for that request. It is the single-pane view of one call — header fields at the top, a routing section, and breakdown cards below.

Usage record detail page

The top of the page is a read-only grid of the most useful fields:

FieldUse it for
Request IDCorrelating with your application logs and support tickets.
Provider / ModelConfirming which target served the call.
HTTP StatusThe final outcome returned to your application.
LatencyTotal wall-clock duration.
Billable tokens / CostWhat you were charged.
Provider Request IDThe id assigned by the upstream provider — useful when filing a ticket with the provider.
API Key / Team / UserThe principal that signed the request.
TimestampWhen the call completed.

Usage record details

Routing Section

If smart routing is enabled, a card shows the attempt chain in the order it ran:

  • a Direct badge when the originally requested target served the call,
  • a Rerouted badge when a fallback took over,
  • one row per attempt with the provider, the model, the outcome (success, failed), and the error string for failed attempts.

Routing card on a usage record showing two attempts

The provider and model in the header always reflect the attempt that actually answered. When the card says Rerouted, the original target is in the attempt chain, not the header.

Breakdown Cards

Below the routing section, breakdown cards render the structured payloads attached to the record:

CardWhat it shows
BillingThe cost breakdown the calculator produced, with per-token-class amounts and cache discounts when applicable.
TokensNormalized totals plus any per-class breakdown returned by the provider (input, output, cached, reasoning, audio, image, tool).
ProviderUsageThe provider's own usage payload as returned. The same numbers the provider would show in its console.
RoutingThe routing payload in raw form. The card above this is the structured view of the same data.
MetadataGateway traceability — plugin executions and durations, safety decisions, and rate-limit stage outcomes.

Each card hides itself when it has nothing to show. A call that failed at auth, for example, has no token, billing, or routing data, so only the metadata card will appear.

Typical Investigation

You are debugging...Open...
A user-reported slow callThe Routing section and the Metadata card. Plugin durations there often explain a regression.
A 4xx your user did not expectThe Metadata card. It records which gate denied the request.
A cost that looks wrongThe Billing and Tokens cards.
A provider-side issueThe Provider Request ID in the header — pass it to provider support.

Tips

Copy the Request ID when filing an internal ticket. It is the single id that ties together the persisted record, your application logs, and any platform-side trace.

On this page