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

# Analytics overview

> Turn what your agents do into reports your team can read, share and download.

Every task your agents run leaves a record: what came in, what the agent decided, what it produced, how long it took, and where a person stepped in.

Analytics is where that becomes something you can look at.

## The three things you work with

Analytics has three building blocks. You will meet them in this order.

<CardGroup cols={3}>
  <Card title="Questions" icon="magnifying-glass">
    A saved query. "How many invoices did we process last month, by country?" You write it once and it stays.
  </Card>

  <Card title="Dashboards" icon="chart-line">
    A page of charts, filters and tables. It reads from your questions and fills itself in with the latest numbers every time someone opens it.
  </Card>

  <Card title="Data sources" icon="database">
    Somewhere to read from besides your agents' own results - a spreadsheet you upload, or a database you connect.
  </Card>
</CardGroup>

How they fit together: a **data source** holds numbers that do not come from your agents. A **question** pulls numbers together, from your agents' results and from your data sources. A **dashboard** shows the answers.

You do not need all three. A dashboard reading one question is a perfectly good report.

## Getting started

<Steps>
  <Step title="Open Analytics">
    Analytics is in the left-hand navigation. You will land on your dashboards.
  </Step>

  <Step title="Make a question">
    Choose **New → Question** and describe what you want to know in plain English. The platform writes the query for you, and you can edit it afterwards.
  </Step>

  <Step title="Make a dashboard">
    Choose **New → Dashboard**, then pick the questions it should read.
  </Step>
</Steps>

## Where the numbers come from, and how fresh they are

A dashboard runs its questions **every time someone opens it**, so what you see is current as of the moment you opened the page. The dashboard says so on screen, next to the refresh button.

Two things are worth knowing before you quote a number from a screen you have had open for a while:

* **A dashboard does not update on its own.** Nothing refreshes in the background. A tab left open all morning shows this morning's numbers until you refresh it.
* **Finished tasks take a few seconds to appear.** Results are collected in the background, so a task that completed moments ago may not be counted yet.

If a dashboard shows numbers that were built into the page rather than pulled live, it is labelled **Fixed numbers, not live** so nobody mistakes one for the other.

## Who can see and change what

Analytics is an add-on. Once it is enabled for your workspace, two permissions control it:

| Permission         | What it allows                                                                                |
| ------------------ | --------------------------------------------------------------------------------------------- |
| **View analytics** | Open dashboards, run questions, download exports.                                             |
| **Edit analytics** | Everything above, plus creating, editing and deleting dashboards, questions and data sources. |

Everything you see is scoped to your workspace. A dashboard, question or data source in one workspace is never visible from another.

## Next

<CardGroup cols={2}>
  <Card title="Dashboards" icon="chart-line" href="/docs/guide/dashboards">
    Build one, share it, export it as PDF or Excel.
  </Card>

  <Card title="Data sources" icon="database" href="/docs/guide/data-sources">
    Upload a spreadsheet or connect a database.
  </Card>
</CardGroup>