# Analytics

> See the conversations one agent handled and the credits it used, on the canvas. Split by source (app, API, Live, channel, routine, space) and by path (API key or channel connection).

**Analytics** is the **Usage** tab of the [canvas](/docs/build/canvas/). The canvas shows what is attached to this agent. The Usage tab adds how many requests came in through each path and what they cost.

## When to use it

- After you turn on Live, to see how many credits visitor chats use.
- To find which API key your integrations call the most.
- To find the day channel or routine usage went up.

To compare every agent at once, use the [usage dashboard](/docs/account/usage/). Analytics looks at one agent.

## Getting there

<Steps>

1. Open the agent's **Studio**.

2. Select the **Usage** tab at the top of the canvas. The **Analytics** cell under the agent card takes you to the same view.

3. Pick a **period** at the top right: 7, 30 or 90 days. The period only exists on the Usage tab.

</Steps>

## Figures on the canvas

On the Usage tab, the nodes in the left column (Requests come in) show figures.

| Node | What it shows |
| --- | --- |
| **Channel, Live, API** header rows | Chats and credits for that source |
| **Channel connection**, **API key**, **Live address** | Chats, replies and credits for that one path |
| **Other requests** | Usage with no path to configure, such as app chats, routines and spaces |

The line into the agent gets thicker with usage. Paths with no usage in the period are drawn as faint dashed lines.

The API header total includes calls made with **account-wide keys**. The canvas only draws keys dedicated to this agent, so the key nodes can add up to less than the header row.

## The chart below

A daily bar chart sits under the canvas. Bars stack by source, and every day in the period gets a slot. Days with no usage are empty.

- The chart header shows the period totals: chats, replies, tokens and credits.
- Choose **Tokens**, **Credits** or **Replies** for the bars.
- Select a source chip below the chart to hide or show that source.
- If you collapse the chart, it stays collapsed next time.

Chats are not drawn as bars. Adding daily chat counts would count a chat that spans several days more than once. Read the period's chat count in the chart header.

## Focusing on a path

Select a node on the Usage tab to open the **Analytics** panel on the right. The chart then shows only that path.

- A **source** (the Channel, Live or API header row, or Other requests) keeps only that source's bars in full color.
- An **API key** or **channel connection** shows that path's daily values against the day's total.

The Analytics panel has two tables.

- **Sources**: chats, replies, tokens, credits and share for all six sources. Sources with no usage stay as rows so you can compare.
- **Paths**: calls, tokens and credits by API key and by channel connection. Keys only show their prefix. Select **›** at the end of a row to open that key's or channel's settings.

The focused path shows as a chip in the chart header and the panel header. Select **×** on the chip to go back to everything.

## Reading the numbers

- **Chats** are conversations this agent answered at least once in the period. Conversations it never answered are not counted.
- **Replies** are the number of times the agent answered.
- **Credits** are the settled cost. One credit is US$1.
- For the same period, the token total matches the Agents tab of the [usage dashboard](/docs/account/usage/).

<Aside type="note" title="'Without a charge' does not mean free">
  Runs on [your own LLM key](/docs/account/bring-your-own-key/) are not billed by endue, so they carry no credits.
  Those tokens are listed separately as **without a charge** instead of being added as zero credits. Check the cost with that LLM provider.
</Aside>

<Aside type="note" title="If you see 'Unlabeled'">
  Usage recorded before sources were tracked was filled in from the conversation it belongs to. Anything still unknown is grouped as **Unlabeled**.
  Older API usage is attributed to the key that first created the conversation.
</Aside>

## Who can see it

Only the agent's owner. Other people don't see the Usage tab or the Analytics cell. When someone else uses this agent, that usage is counted on their account and does not appear here.

## Limits

- Tool calls (connectors and skills) are not counted yet. That is why the right column of the canvas has no figures.
- Device costs (computer and browser) are not included.
- Usage is recorded when a run finishes. A run in progress shows up after it ends.

## Related

<CardGrid>
  <LinkCard title="Canvas" href="/docs/build/canvas/" description="The Setup tab: what is attached." />
  <LinkCard title="Usage dashboard" href="/docs/account/usage/" description="Every agent at once." />
  <LinkCard title="Agent API" href="/docs/build/agent-api/" description="Call your agent with an API key." />
  <LinkCard title="Plans and usage" href="/docs/account/plans-and-usage/" description="How credits and included usage work." />
</CardGrid>