# Operational Dashboard

Superset dashboard definitions for Stonks Oracle operational monitoring.

## Dashboards
- Ingestion Throughput — documents ingested per hour by source type, success/failure rates
- Model Extraction Quality — extraction success rates, latency percentiles, validation failures
- Source Coverage Gaps — symbols missing source types, stale sources with no recent data

## Data Sources
These dashboards query the Query API operational endpoints:
- `/api/ops/ingestion/throughput` — time-bucketed ingestion metrics
- `/api/ops/ingestion/summary` — aggregate ingestion stats
- `/api/ops/model/failures` — recent extraction failures
- `/api/ops/model/performance` — model performance summary
- `/api/ops/pipeline/health` — pipeline stage health
- `/api/ops/sources/coverage-gaps` — source coverage analysis

## Setup
Import the dashboard JSON files into Superset via the Superset UI or CLI.
The dashboards use the Trino `lakehouse` catalog as their primary datasource,
with supplementary queries against the Query API for real-time operational data.
