# Run Detail

Open Run Detail — by clicking a run in the Runs workspace — when you need to
slow down and inspect a single run.

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

## Read the header and KPI cockpit

The header shows run identity and live status:

- Breadcrumb back to Runs plus the short run id.
- Run name and a status chip (Live, Finished, Failed, or stopping/stopped).
- Forked-from context, seed, owner, and start time when available.
- Header actions to **Fork** the newest checkpoint, jump to **Compare**, or
  **Request stop** on a running run (when your role allows it).

Below the header, a KPI cockpit summarizes the run from its own logged metrics.
Cards appear only when the underlying signal exists:

- **Step** progress, with a meter when the run declared a target step count.
- The **headline eval metric**, flagged "best yet" when the latest value is the
  run's extreme.
- **Loss**, with a per-1k-step slope.
- **Throughput** and **GPU util** when system metrics are logged.
- **ETA**, estimated from the recent step rate for running runs with a target.

## Move between sections

Run Detail has its own tabs, separate from the global dashboard navigation. The
Data and Files sections carry count badges when the run has logged metric rows
or evidence.

| Tab | Use |
| --- | --- |
| Summary | KPI cockpit, headline charts, checkpoints, alerts, tags, notes, and timeline |
| Data | Metric curve chart and the metric summary table |
| Traces | Recent product traces for this run, linked into the full Traces workspace |
| Logs | Stdout/stderr style logs for the selected run |
| Files | Artifact, checkpoint, media, table, histogram, and evaluation evidence |
| System | Config plus source/system metadata captured by the SDK |
| Graph | Parent, checkpoint, and child-run lineage when graph data exists |

Logs, traces, objects, and lineage load only when the relevant section is
opened. User-facing metric summaries cover logged training metrics; internal SDK
telemetry (`system/instantml/*`) lives on the System section.

## Traces

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

The Traces section lists the latest traces for the selected run. It fetches
`GET /api/traces?run_id=...&limit=20` only after you open the section, then
links each trace to the full Traces workspace with the exact `run_id`,
`trace_id`, and root `span_id`.

Above the list, a **trace activity timeline** puts one run metric and per-step
trace activity on a shared step axis, so you can see where a metric moved and
where traces ran or failed in a single view:

- The metric line at the top plots one key; pick it with the **Metric**
  selector in the panel head.
- The lane below the axis draws one marker per step bucket. Marker size scales
  with the number of traces at that step, and color encodes health: normal,
  running-only, or errored. A shaded danger band spans contiguous steps that
  contain errored traces.
- The panel head reports run-wide totals — total traces and errored traces
  across the whole run, plus the covered step range.
- Click a step to pin the list below to that step: a filter chip appears and the
  list refetches only the traces anchored there. Click the chip to clear it.

The totals in the panel head are always run-wide and include traces logged
without a step, so they can be larger than the sum of the visible buckets — the
lane only shows stepped traces, and the list under a pinned step shows only that
step's traces. Runs that log no stepped traces skip the lane and note the
stepless count instead. The lane is capped at the first 2,000 distinct steps
(see [`GET /api/runs/:run_id/traces/steps`](/docs/architecture/current-api.md));
longer runs show a truncation note.

Use this section when you are already inspecting one run and want to jump from a
metric regression or failed checkpoint to the execution tree that produced it.

## Edit tags and notes

Use the small editor to update tags and notes without leaving the run. These
fields are searchable and appear in Compare.

## Review files and evaluation evidence

The Files section previews checkpoints, uploaded files, media objects, tables,
histograms, and binary classification evaluation bundles through existing
artifact and object routes. Classification eval previews render PR/ROC curves,
a confusion matrix, per-class metrics, and optional prediction rows from typed
rich-object data rather than screenshots. Download actions go through the API
rather than exposing raw storage URLs.

## Next steps

- [Compare runs](/docs/dashboard/compare-runs.md)
- [Checkpoints and forking](/docs/dashboard/checkpoints.md)
- [Artifacts and files](/docs/dashboard/artifacts-files.md)
- [Rich objects](/docs/sdk/rich-objects.md)
- [Runs workspace](/docs/dashboard/runs-workspace.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)
- [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) (current page)
- [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)
