
Runs
The runs list shows recent pipeline executions, newest first.
- Run ID — opaque identifier, click to drill in
- Started / finished — timestamps
- Status —
running,succeeded,failed,partial - Definitions — how many assignment / fact / metric definitions were touched
- Bytes scanned — total cost (BigQuery especially)
- Duration — wall-clock time
partial run means some definitions succeeded and others failed. The failures don’t block the rest of the pipeline.
Run detail
Click a run to see per-definition results.
- The SQL that was executed (with template variables already substituted)
- Rows returned
- Duration
- Bytes scanned (where the warehouse reports it)
- Any error with a stack-like trace
Freshness
The Freshness page shows, per definition, how recent the latest computed data is.
- Last successful run — when did this definition last complete?
- Lag — gap between now and last success
- Next scheduled run — when it’ll run next
- Status —
healthy,stale,failing
stale or failing, click through to recent runs to see why. Common causes: warehouse credential rotated, table renamed in a migration, schema column changed type.
Cost monitoring
The runs list shows bytes scanned per run. For BigQuery, this maps directly to cost. For Snowflake, Databricks, and ClickHouse, query costs come from compute/warehouse uptime which is reported separately by the warehouse. If a particular definition is expensive:- Click into a recent run.
- Look at the rendered SQL.
- Check whether it’s scanning the partitioned column. If
WHERE event_time BETWEEN ...isn’t hitting a partition, the table needs partitioning (or the SQL needs to use the partition column). - Consider sampling — for sanity-check metrics on very large tables, you can
TABLESAMPLEor query a downsampled view.
Manual runs
You can trigger a manual pipeline run from the Runs page. Useful for:- Re-running after fixing a broken definition
- Pulling in late-arriving data after a backfill
- Verifying a freshly-saved definition works against real data
Schedules
Each project has a default pipeline schedule (typically every 15 minutes for active definitions, less often for archived ones). Adjust in Settings → Pipeline schedule if you need different cadences.Next steps
Definitions
Where the SQL is authored.
Connectors
Performance tuning per warehouse.
Metrics
What the pipeline ultimately produces.