Analyze Cost and Usage
The Cost and usage page is the spending report for your Agentic Data Plane, where every LLM call the gateway routes is recorded, priced, and summarized. Use it to see what you spend and how that compares with the period before. Break the total down to find which agent, model, provider, or user drives it, then export the numbers for reporting.
After reading this page, you will be able to:
-
Read gateway spend, requests, and tokens for a time window against the period before it
-
Break down spend by agent, model, provider, user, or tag and chart one resource against the gateway total
-
Export the breakdown table or the full spending report as CSV
Prerequisites
The report needs traffic through at least one LLM provider. With no provider configured, the page shows a No providers configured notice with an Add an LLM provider button in place of the report. With a provider but no traffic in the window, the figures read zero.
| Dollar values come from per-model pricing for the provider that served the call: that provider’s built-in catalog rates, or the overrides you set on it. A model offered by more than one provider is priced separately for each. Cost reporting works without any pricing setup. See Override per-model pricing. |
Open the report
Open Cost and usage in the sidebar. The page has two tabs:
-
Cost & usage: The spending report. Headline figures, spend charts, and a spend breakdown for one time window, with CSV export.
-
Activity: The live view. The agents active right now, with a drill-down into their recent conversations.
The report header names its scope, All gateway traffic, and the selected range, next to the date-range picker and the Export menu. The footer repeats the range and notes that the figures are in USD, aggregated by day (or by hour for a window of 24 hours or less) in UTC, and cover model costs only.
Choose the time window
The date-range picker offers last 7 days (the default), last 14 days, last 30 days, last 90 days, month to date, quarter to date, year to date, and a custom range. Every figure on the tab, including each comparison with the previous period, follows this one window.
When you open the report without a range in the URL, it starts on the default. If that range holds no traffic, the report checks the wider rolling presets and switches in one step to the smallest one that does, up to last 90 days. The picker always names the range actually in use. Choosing a range yourself, including a custom one, stops the switch for the rest of the visit, and it doesn’t add a browser history entry. The Activity tab widens its own window too, one preset at a time.
A custom range sets an exact start and end time, to the minute and interpreted in UTC, rather than a relative period. It writes customStart and customEnd ISO-8601 timestamps to the page URL, so the view is shareable. Copy the URL after picking a custom range, and any teammate who opens it lands on the same window.
A link from another page, such as the gateway traffic card on the home page, can open the report on a one-day window that the picker itself doesn’t offer. The report then uses hourly buckets, and the spend chart is titled Hourly spend instead of Daily spend. A custom range of 24 hours or less also uses hourly buckets.
Read the headline numbers
Four figures summarize all gateway traffic in the window:
-
Total spend shows what the window cost, with its change against the previous period.
-
Model requests counts the individual calls to a model.
-
Cost / 1k requests averages spend per thousand requests across all models.
-
Tokens counts input, output, and cached tokens.
The previous period is the window of the same length that ends where the selected window starts. For a 7-day range, that is the 7 days before it. For a one-day range, it is the 24 hours before. The same comparison draws the dashed line in the spend chart and fills the Change column of the breakdown table. When the previous period had no spend, Total spend shows no percentage change.
Compare a resource against the gateway
The report has two spend charts:
-
The spend chart, titled Daily spend or Hourly spend, plots spend for all gateway traffic. A filled area shows this period and a dashed line shows the previous period.
-
The Resource spend chart plots one agent, model, provider, or user on the same dollar scale, so its share of the total reads straight off the axis. The resource’s spend is part of the gateway total, not separate from it. Until you choose a resource, the panel explains how to fill it.
To fill the resource chart, pick a resource with the Choose a resource picker on the Resource spend chart, or click Compare trend on a row of the breakdown table. The picker searches the agents, models, providers, and users with spend in the window. Clear selection empties the chart again. While a resource is charted, the panel header shows its spend and its share of gateway spend.
The two charts share a hover cursor. Point at a bucket in either chart and both highlight the same bucket. The spend chart’s tooltip shows this period’s value, the previous period’s value and date, and the change between them. The resource chart’s tooltip shows the resource’s value for that bucket.
The page URL records the charted resource, so a compared view is shareable. Copy the URL, and a teammate lands on the same chart. Tag values are the exception. You can chart one from its row’s details in the breakdown table, but you can’t pick it here, and it isn’t kept in the URL.
Break down spend
The Spend breakdown table lists every agent, model, provider, or user with spend in the window, sorted by spend. Switch the grouping with the table’s Agents, Models, Providers, and Users tabs. When cost-allocation tags are available, a Tags tab appears as well. Pick a tag key next to it to group by that key’s values. See Track Spend by Tag.
Grouping applies to this table only. The headline figures and the spend chart always cover all gateway traffic, and the resource chart keeps whatever you charted.
Each row shows the resource’s spend, its change against the previous period, its request count, and its cost per thousand requests. Click a column header to sort by it, and use the search box to narrow the rows by name. Some rows stand for spend that has no resource of that kind. Direct usage collects calls that didn’t run through an agent, Unattributed collects calls with no user recorded, and Untagged collects calls without a value for the chosen tag key. A user row that belongs to an agent’s service account says so under the name, and a provider that has since been deleted keeps its row, marked Deleted provider, so history stays complete. When the window holds more resources than the table loaded, the table says so and suggests a narrower range.
Click a row to see its details:
-
Four figures give the resource’s spend, its share of gateway spend, its requests with the failed count and rate, and its cost per thousand requests next to the gateway average.
-
A Spend over time chart plots this resource alone. Rows that stand for unattributed usage have no chart.
-
A Tokens list splits the resource’s tokens into input, output, cached read, cache write, reasoning, and tool use, with each bucket’s share.
-
Compare trend closes the details and charts the resource against the gateway, and Open agent or Open provider opens the resource’s own page where it has one.
Export the report as CSV
The Export menu in the report header offers two CSV downloads:
-
Breakdown table as shown (CSV) saves the breakdown table with its current grouping, search, and sort order. Each row carries the resource, its key, its spend and previous-period spend in USD, requests, failed requests, and tokens.
-
Full report, every row (CSV) saves the complete, untruncated dataset for the window. It always covers all gateway traffic, whatever the table groups by or the chart focuses on.
Two settings in the same menu shape the full report. Under Full report time bucket, choose Hourly, Daily (the default), Monthly, or Total (no time column). Under Full report rows, choose any combination of Provider, Model, User, and Agent to decide which columns the rows are grouped by. Clearing all four gives one row per time bucket.
Use the breakdown export to share the view you have on screen, and the full report when you need the whole dataset for a spreadsheet or a chargeback pipeline.
See which agents are active now
The Activity tab answers a different question from the report: instead of what something cost, it shows what’s running right now. It ranks the agents with traffic over a window of the last hour (the default), the last 24 hours, or the last 7 days, and shows each agent’s change against the previous window. Select an agent to see its recent requests and open a conversation.