stonks-oracle/dashboards/operational/README.md

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.