mirror of
https://github.com/fosrl/docs-v2.git
synced 2026-08-31 03:01:30 +02:00
42 lines
2.0 KiB
Plaintext
42 lines
2.0 KiB
Plaintext
---
|
|
title: "AI Usage Analytics"
|
|
description: "Cost, token usage, and request volume across providers, resources, roles, users, and keys"
|
|
---
|
|
|
|
Usage analytics rolls up every AI Gateway call: how many requests ran, how many tokens they used, and estimated USD. Open **AI Gateway → Usage Analytics**. The numbers come from the same recorded usage that [budgets](/manage/ai/budgets) enforce.
|
|
|
|
<Frame>
|
|
<img src="/images/ai/analytics-overview.png" alt="Usage analytics overview with cost, token, and request charts" centered />
|
|
</Frame>
|
|
|
|
These records are independent of session log retention. For prompt and response text, see [Session Logs](/manage/ai/session-logs). The two share a session id per call.
|
|
|
|
## How Numbers Are Calculated
|
|
|
|
USD uses [catalog](/manage/ai/model-catalog) rates (`in`, `out`, `cache`, `reasoning`) when the model id is known. Unknown models have no USD amount. Tokens still sum.
|
|
|
|
Token buckets are prompt, cache-read, cache-write, completion, and reasoning. If the upstream omits usage, Pangolin estimates tokens from the request and response. Overview shows **Estimated**: the share of requests that used that path.
|
|
|
|
A non-2xx response from the provider still counts as a request with zero tokens, so volume charts include failed attempts.
|
|
|
|
These figures are estimates for the dashboard and for budgets, not a copy of the vendor invoice. See [Budgets](/manage/ai/budgets) for the same calculation used at enforcement time.
|
|
|
|
## Filters
|
|
|
|
Every tab uses the same filters. The default date range is the last seven days.
|
|
|
|
- Provider
|
|
- Model
|
|
- Resource
|
|
- Role
|
|
- User
|
|
- Virtual API key
|
|
|
|
## Tabs
|
|
|
|
**Overview** shows totals for requests, tokens, cost, and estimated percent, daily charts for each, and top models by cost.
|
|
|
|
**Providers**, **Resources**, **Roles**, **Users**, and **Virtual API Keys** each show cost and token trends plus a ranked list for that dimension.
|
|
|
|
Role is derived from the caller's org roles. Usage rows store the user id, not the role. A [manual key](/manage/ai/virtual-api-keys#manual-keys) with no attributed user appears as an unknown user.
|