# Dashboard tour

Follow this tour to learn where each surface lives and the loop the dashboard is
built for: scan many runs, chart a metric, open one run, then compare
candidates.

## Navigate the dashboard

The left rail groups surfaces into three sections:

| Group | Surfaces |
| --- | --- |
| Operate | Runs, Metrics, Distributed |
| Data | Datasets, Artifacts, Insights |
| System | Run Health, Reports, Agent |

Two surfaces are reachable without a rail item:

- **Run Detail** — open any run from the Runs workspace.
- **Compare** — select two or more runs in the Runs **Table** view.

Settings is not in the rail. Open the profile menu in the top right and choose
**Workspace settings** to open it as a centered modal. The same menu holds
**New workspace**, the light/dark theme toggle, and **Sign out**; billing lives
inside the Workspace settings modal as its own section.

## Scan runs in the Runs workspace

![Runs workspace showing the run rail and metric panels](/docs/assets/images/product/dashboard-runs.png)

Runs is the broadest view of a project. Filter by project, status, search text,
and sort mode, then select runs from the rail. Toggle between **Panels** (run
selector plus chart canvas) and **Table** (a flat, sortable run list with an
embedded comparison). The **Runs actions** menu exports selected runs as CSV
and reviews stop requests. Save a named view when a layout should survive a
reload. See [Runs workspace](/docs/dashboard/runs-workspace.md) for panel types,
search syntax, and shortcuts.

## Switch workspaces

![Organization workspace switcher](/docs/assets/images/product/dashboard-org-workspaces.png)

The top-right account menu shows the active workspace and switches between your
personal and organization workspaces. It also creates new workspaces and opens
the Workspace settings modal. See
[Organizations and workspaces](/docs/dashboard/organizations-workspaces.md) for
hierarchy and roles.

## Chart metrics

![Metrics dashboard](/docs/assets/images/product/dashboard-metrics.png)

Metrics is line-chart first. A metric browser on the left groups logged keys by
namespace. The chart supports smoothing, a step/time x-axis, a linear/log
y-axis, and grouped averages, with a series table for showing, hiding, and
pinning runs. Export downloads the plotted CSV sample or an SVG of the visible
graph.

## Inspect one run

![Run detail page](/docs/assets/images/product/dashboard-run-detail.png)

Run Detail focuses on a single run. A KPI cockpit summarizes step progress, the
headline eval metric, loss, throughput, GPU util, and ETA. Header actions fork
the newest checkpoint, jump to Compare, or request a stop. Local sections cover
summary, data, traces, logs, files, system context, and graph lineage.

![Run Detail traces section](/docs/assets/images/product/dashboard-run-detail-traces.png)

The Traces section fetches recent traces only when opened. Each row links to the
full trace tree with the exact run, trace, and root span selected.

## Traces

![Traces workspace](/docs/assets/images/product/dashboard-traces.png)

Traces is a run-scoped debugger for rollout, model, tool, retrieval, reward, and
evaluator spans. Filter by run/status/kind/search text, expand child spans
without loading the full tree up front, and inspect redacted previews,
attributes, metrics, and links in the side panel.

![Run Detail Files section showing checkpoints and evaluation evidence](/docs/assets/images/product/dashboard-artifacts-evidence.png)

The Files section lists checkpoints, rich objects, evaluation bundles, media,
and artifact metadata without loading those payloads on the initial summary
view.

## Compare candidates

![Compare view embedded in the Runs Table](/docs/assets/images/product/dashboard-compare.png)

Comparison lives at the top of the Runs **Table** view. Select two or more runs
and they render side by side with a reference run, goal-aware deltas, and
addable metric columns. Use it after Runs has narrowed the candidate set.

## Analyze distributed runs and Insights

![Distributed dashboard](/docs/assets/images/product/dashboard-distributed.png)

Distributed is a rank-aware view for one selected run: reducer lines, rank
coverage, per-rank snapshots, heatmaps, and outliers from metrics logged with
`run.log_rank_metrics(...)`.

![Insights dashboard](/docs/assets/images/product/dashboard-insights.png)

Insights has two views — **GPU & System** usage and **Run Analysis** (grouped
reducers, hyperparameter scatter, k-means clusters, evaluation summary cards,
and parallel-coordinate sweep traces). Both operate over the loaded or selected
run summaries.

## Fork checkpoints and trace lineage

![Checkpoint fork modal](/docs/assets/images/product/dashboard-checkpoint-fork.png)

Checkpoint rows expose download, resume-code, and fork actions. Forking creates
a linked child run record only; training starts when a user or script attaches
to that run and logs new data.

![Lineage graph showing a forked child run with no direct children yet](/docs/assets/images/product/dashboard-lineage-graph.png)

The Lineage tab shows the selected run's direct parent, checkpoint, and bounded
child context.

## Browse artifacts

![Artifacts workspace showing a versioned model collection with aliases, manifest, and lineage](/docs/assets/images/product/dashboard-artifacts-browser.png)

The Artifacts workspace shows versioned collections first: aliases such as
`latest` and `best`, manifest entries, retention/delete controls for owners and
admins, and bounded producer/consumer lineage. Raw run files and media stay in
the Run Detail Artifacts tab.

## Write reports

![Reports editor](/docs/assets/images/product/dashboard-reports-editor.png)

Reports are block-based writeups with live panel grids, share links, and
Markdown export. Start one from the Reports surface with **New report** or
**Start from template**.

## Next steps

- [Runs workspace](/docs/dashboard/runs-workspace.md)
- [Metrics and charts](/docs/dashboard/metrics-charts.md)
- [Run Detail](/docs/dashboard/run-detail.md)
- [Compare runs](/docs/dashboard/compare-runs.md)
- [Organizations and workspaces](/docs/dashboard/organizations-workspaces.md)

## Agent navigation

- [Docs index](/llms.txt)
- [Full docs bundle](/llms-full.txt)

### Get Started

- [Overview](/docs/index.md)
- [Quickstart](/docs/quickstart.md)
- [Core Concepts](/docs/concepts/core-concepts.md)
- [Pricing](/docs/pricing.md)
- [Benchmarks](/docs/benchmarks.md)
- [Examples](/docs/guides/examples.md)
- [Troubleshooting](/docs/troubleshooting.md)

### SDK

- [Installation Auth](/docs/sdk/installation-auth.md)
- [Logging](/docs/sdk/logging.md)
- [Tracing](/docs/sdk/tracing.md)
- [Metrics Steps](/docs/sdk/metrics-steps.md)
- [Config Tags Notes](/docs/sdk/config-tags-notes.md)
- [Artifacts Checkpoints](/docs/sdk/artifacts-checkpoints.md)
- [Rich Objects](/docs/sdk/rich-objects.md)
- [Distributed Training](/docs/sdk/distributed-training.md)
- [Console System Integrations](/docs/sdk/console-system-integrations.md)
- [Reliability](/docs/sdk/reliability.md)
- [Cli Login](/docs/sdk/cli-login.md)
- [Querying Data](/docs/sdk/querying-data.md)
- [Agent Mcp](/docs/sdk/agent-mcp.md)
- [Examples Patterns](/docs/sdk/examples-patterns.md)

### Integrations

- [Overview](/docs/integrations/overview.md)
- [Pytorch Lightning](/docs/integrations/pytorch-lightning.md)
- [Huggingface Transformers](/docs/integrations/huggingface-transformers.md)
- [Keras](/docs/integrations/keras.md)
- [Wandb](/docs/integrations/wandb.md)

### Dashboard

- [Tour](/docs/dashboard/tour.md) (current page)
- [Organizations Workspaces](/docs/dashboard/organizations-workspaces.md)
- [Runs Workspace](/docs/dashboard/runs-workspace.md)
- [Metrics Charts](/docs/dashboard/metrics-charts.md)
- [Run Detail](/docs/dashboard/run-detail.md)
- [Traces](/docs/dashboard/traces.md)
- [Compare Runs](/docs/dashboard/compare-runs.md)
- [Research Dashboards](/docs/dashboard/research-dashboards.md)
- [Artifacts Files](/docs/dashboard/artifacts-files.md)
- [Run Health](/docs/dashboard/alerts.md)
- [Datasets](/docs/dashboard/datasets.md)
- [Checkpoints](/docs/dashboard/checkpoints.md)
- [Reports](/docs/dashboard/reports.md)
- [Settings Api Keys](/docs/dashboard/settings-api-keys.md)
- [Api Tab](/docs/dashboard/api-tab.md)
- [Onboarding Team Billing](/docs/dashboard/onboarding-team-billing.md)

### Data

- [Imports](/docs/guides/imports.md)
- [W&B alternative](/docs/guides/wandb-alternative.md)
- [InstantML vs MLflow](/docs/guides/instantml-vs-mlflow.md)
- [W&B import guide](/docs/guides/wandb-import-guide.md)
- [W&B and Neptune imports](/docs/guides/wandb-neptune-imports.md)
- [Export Usage Limits](/docs/guides/export-usage-limits.md)
- [Pricing Limits Billing](/docs/guides/pricing-limits-billing.md)
- [Auth Billing Storage](/docs/guides/auth-billing-storage.md)
- [Customer Owned Clickhouse](/docs/guides/customer-owned-clickhouse.md)
- [Observability](/docs/guides/observability.md)

### API

**Practical API guides**

- [Authentication](/docs/api/authentication.md)
- [Errors And Limits](/docs/api/errors-and-limits.md)
- [Health Observability](/docs/api/health-observability.md)
- [Projects Runs](/docs/api/projects-runs.md)
- [Metrics Series](/docs/api/metrics-series.md)
- [Attributes Objects](/docs/api/attributes-objects.md)
- [Artifacts](/docs/api/artifacts.md)
- [Reports](/docs/api/reports.md)
- [Iframe Embeds](/docs/api/iframe-embeds.md)
- [Import Export Usage](/docs/api/import-export-usage.md)
- [Dashboard Control State](/docs/api/dashboard-control-state.md)
**Architecture**

- [System Overview](/docs/architecture/system-overview.md)
- [Service Planes](/docs/architecture/service-planes.md)
- [Storage Model](/docs/architecture/storage-model.md)
- [Google Clickhouse](/docs/architecture/google-clickhouse.md)
- [Auth Tenancy](/docs/architecture/auth-tenancy.md)
- [Schema Reference](/docs/architecture/schema-reference.md)

### API Reference

- [API Reference](/docs/api-reference.md)
