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

# Dashboards

> Browse the dashboards in your project, then filter, group, and drill into aggregated metrics across your logs and experiments over time.

A dashboard aggregates metrics across the logs and experiments in a project. Use dashboards to track request counts, latency, token usage, costs, scores, topics, and custom metrics over time.

Dashboards are scoped to a project. Every project starts with a built-in dashboard called **Cost and quality**, so you can explore your data before building anything of your own.

<img src="https://mintcdn.com/braintrust/SX2mi9f0YsPt6ry_/images/observe/cost-quality-dashboard.png?fit=max&auto=format&n=SX2mi9f0YsPt6ry_&q=85&s=a2e3e7e2f78c8b7cda834b732881f58f" alt="Dashboards page" width="2708" height="1592" data-path="images/observe/cost-quality-dashboard.png" />

## Browse dashboards

The [**<Icon icon="chart-no-axes-column" /> Dashboards**](https://www.braintrust.dev/app/~/dashboards) page lists every dashboard in the project. Select a row to open that dashboard on its own page.

Each row shows:

* **Name**: The dashboard's name. Rows you cannot edit, such as the built-in dashboard, are not selectable.
* **Type**: Whether the dashboard aggregates **Logs** or **Experiments**.
* **Created by** and **Created**: Who added the dashboard, and when.
* **Last updated at**: When the dashboard's charts or settings last changed.
* **Charts**: How many charts the dashboard holds.

Search the list by name, or narrow it with the time range filter to find dashboards created in a given period.

To keep a dashboard close at hand, click <Icon icon="ellipsis" /> **Dashboard actions** > **Star dashboard**. Starred dashboards are marked in the star column. Without edit access, you can see which dashboards are starred but cannot change them.

## Filter and group data

Apply filters and groupings at the top of a dashboard to affect all of its charts at once. This lets you focus on a subset of your data or compare segments side by side.

Filters apply to entire traces with any span match, while groups are only per span.

<img src="https://mintcdn.com/braintrust/SX2mi9f0YsPt6ry_/images/observe/filter-group-dashboard.png?fit=max&auto=format&n=SX2mi9f0YsPt6ry_&q=85&s=5e2144159dd7455a72d669ecafd07b0f" alt="Filter and group dashboard data" width="2674" height="802" data-path="images/observe/filter-group-dashboard.png" />

On a dashboard you created, filter and grouping changes save automatically. The built-in **Cost and quality** dashboard is read-only, so changes there last only for your current session.

## Select timeframes

Choose from preset timeframes, or click and drag horizontally on a time series chart to zoom into a specific period. Double-click to zoom out.

<Tip>
  To refresh charts automatically as new data arrives, toggle **LIVE updates** on in the time range selector dropdown. When live mode is off, click the <Icon icon="refresh-cw" /> refresh button next to the time range selector to reload all charts.
</Tip>

<img src="https://mintcdn.com/braintrust/SX2mi9f0YsPt6ry_/images/observe/timeframes-dashboard.png?fit=max&auto=format&n=SX2mi9f0YsPt6ry_&q=85&s=a8d0f7aca23c9bd74866a0373eb7ef72" alt="Dashboard timeframe selector" width="2656" height="814" data-path="images/observe/timeframes-dashboard.png" />

## View traces

Select any data point on a chart to open the logs or experiments page, filtered to the corresponding time range and series. Use this to move from an aggregate trend to the individual traces behind it.

## Next steps

* [Create dashboards](/docs/observe/dashboards/create) of your own, or copy one between projects.
* [Build charts](/docs/observe/dashboards/build-charts) to plot the metrics you care about.
* [Set up alerts](/docs/observe/alerts) to be notified when a metric crosses a threshold.
* [Use Loop](/docs/loop) to ask questions about your data in natural language.
