> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pangolin.net/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Usage Analytics

> 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="https://mintcdn.com/fossorial/k1mH62o3m6aJnQ5R/images/ai/analytics-overview.png?fit=max&auto=format&n=k1mH62o3m6aJnQ5R&q=85&s=cbbbbb84bc6b478ba3f7eca7dfca7f55" alt="Usage analytics overview with cost, token, and request charts" centered width="3836" height="2154" data-path="images/ai/analytics-overview.png" />
</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.