# Dashboard (/docs/dashboard)



The dashboard at [app.tokenpolice.ai](https://app.tokenpolice.ai) is where you read what your app
spent and control what the firewall does about it. This section walks through every screen.

## What it's for [#what-its-for]

Everything your SDK reports lands here within seconds — per call, per run, per user. The
left sidebar holds the settings screens; the analytics screens are tabs inside one page.

## The sidebar [#the-sidebar]

| Group                        | Entries                                                                              |
| ---------------------------- | ------------------------------------------------------------------------------------ |
| **Current Project**          | Dashboard · Firewall & Budgets · API Keys · Notification Settings · Project Settings |
| **Workspace (All projects)** | Get started · Notification Channels · Billing · General Settings                     |

At the top of every page: a breadcrumb with your workspace name, a **project switcher** (search,
environment labels, and *Create New Project*), the setup pill, and the notification bell.

## The analytics tabs [#the-analytics-tabs]

Inside **Dashboard**, twelve screens sit on one in-page tab bar:

**Overview · Model Log · Workflows · Sessions · Traces · Audit · Notifications · Users · Models ·
Routing · Dry-run · Unpriced**

Every analytics tab shares one **time-range control** — `1h`, `24h`, `7d`, `30d` (default `24h`),
plus a **Custom** picker up to 90 days, and a refresh button. It's a sliding window relative to
now, and chart granularity follows it: 5-minute buckets at 1h, hourly at 24h, daily at 7d and 30d.

## Three things to know before you read any number [#three-things-to-know-before-you-read-any-number]

<Callout type="info">
  **1. Two switches decide whether anything is stopped.** A call is only blocked or rerouted when
  the rule says **Enforce** *and* your app initialized the SDK with `firewall: "enforce"`. The
  [Audit log](/docs/dashboard/audit-log) labels the counterfactuals — *Would deny*, *Would
  reroute* — with a chip naming exactly which switch was open.
</Callout>

<Callout type="info">
  **2. A dash means unknown, never zero.*&#x2A; Panels don't fake numbers. A panel that failed to load
  says &#x2A;"Couldn't load"* with a retry, and a panel with genuinely no data in the range says so.
</Callout>

<Callout type="info">
  **3. Cost is measured at provider list prices.** Anything we couldn't fully price is listed on
  the [Unpriced calls tab](/docs/dashboard/models-and-unpriced) rather than silently dropped —
  which is why a spend total can be a floor rather than a bill.
</Callout>

## Every screen [#every-screen]

<Cards>
  <Card title="Get started" href="/docs/dashboard/get-started" description="The three-step checklist and what signup sets up for you." />

  <Card title="API Keys" href="/docs/dashboard/api-keys" description="Generate, replace and delete the key your app sends." />

  <Card title="Overview" href="/docs/dashboard/overview" description="The KPI row, spend trend, anomalies and loop panels." />

  <Card title="Model Log" href="/docs/dashboard/model-log" description="Every model call, newest first." />

  <Card title="Workflows, Sessions & Traces" href="/docs/dashboard/workflows-sessions-traces" description="Agent runs, conversations, and the per-call waterfall." />

  <Card title="Users" href="/docs/dashboard/users" description="Spend per end user, and what anonymous means." />

  <Card title="Audit log" href="/docs/dashboard/audit-log" description="Every firewall decision, real and would-be." />

  <Card title="Dry-run & Routing" href="/docs/dashboard/dry-run-and-routing" description="What watching rules would do, and every model swap." />

  <Card title="Models & Unpriced" href="/docs/dashboard/models-and-unpriced" description="Spend by model, and calls with no complete cost." />

  <Card title="Notifications" href="/docs/dashboard/notifications" description="The always-on inbox and your email preferences." />

  <Card title="Settings & Billing" href="/docs/dashboard/settings-and-billing" description="Project settings, the emergency stop, workspace settings." />

  <Card title="Firewall & Budgets" href="/docs/rules/overview" description="The rules page itself — filters, limits, actions and modes." />
</Cards>