https://github.com/mizcausevic-dev/bigquery-query-cost-watch
BigQuery operator surface for query-cost governance, slot pressure, attribution hygiene, and optimization sequencing.
https://github.com/mizcausevic-dev/bigquery-query-cost-watch
bigquery data-platform finops google-cloud query-governance typescript
Last synced: 21 days ago
JSON representation
BigQuery operator surface for query-cost governance, slot pressure, attribution hygiene, and optimization sequencing.
- Host: GitHub
- URL: https://github.com/mizcausevic-dev/bigquery-query-cost-watch
- Owner: mizcausevic-dev
- License: agpl-3.0
- Created: 2026-05-28T01:21:59.000Z (25 days ago)
- Default Branch: main
- Last Pushed: 2026-05-28T03:36:33.000Z (25 days ago)
- Last Synced: 2026-05-28T05:04:05.642Z (25 days ago)
- Topics: bigquery, data-platform, finops, google-cloud, query-governance, typescript
- Language: TypeScript
- Homepage: https://bigquery.kineticgain.com/
- Size: 431 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# bigquery-query-cost-watch
[](https://github.com/mizcausevic-dev/bigquery-query-cost-watch/actions/workflows/ci.yml)
[](https://github.com/mizcausevic-dev/bigquery-query-cost-watch/actions/workflows/pages.yml)
Operator control plane for BigQuery query-cost posture, bytes-scanned spikes, slot pressure, attribution drift, telemetry gaps, and optimization sequencing.
## Production status
| Aspect | Status |
|--------|--------|
| Deploy | Static prerender -> **https://bigquery.kineticgain.com/** |
| Data posture | Synthetic INFORMATION_SCHEMA and billing-export samples only; no project identifiers, dataset IDs, or live query logs are committed |
## Why this matters
- BigQuery spend gets dangerous when scan spikes, partition misses, slot contention, and unlabeled workloads stay trapped in raw exports instead of one operator-readable surface.
- Recruiters looking for `BigQuery / FinOps / data platform / optimization` proof should see a real operator dashboard, not a keyword page.
- This repo turns BigQuery usage and optimization drift into a control plane for scan containment, reservation hygiene, attribution trust, telemetry continuity, and workload-rightsizing posture.
## Why this matters (KG Embedded tie-back)
This repo demonstrates the query-cost and optimization-control-plane primitive for Kinetic Gain Embedded: workload snapshots, bytes-scanned evidence, attribution hygiene, and remediation packets in one operator surface. Kinetic Gain Embedded extends this pattern into productized in-app dashboards where platform, FinOps, and analytics teams need evidence-rich cost governance without exposing raw admin consoles or live warehouse credentials.
## What it shows
- `query-lane` visibility for scan efficiency, slot governance, attribution hygiene, and telemetry freshness
- `cost-risks` detection for bytes-scanned spikes, partition misses, reservation drift, stale snapshots, and export gaps
- `optimization-posture` packets that tie owner, blocker, timing, and completeness together
- offline-safe analysis of captured BigQuery usage exports
- recruiter-facing BigQuery / FinOps / data-platform proof that complements the Microsoft, AWS, GCP, and reporting lanes
## Routes
- `/`
- `/query-lane`
- `/cost-risks`
- `/optimization-posture`
- `/verification`
- `/docs`
## API
- `/api/dashboard/summary`
- `/api/query-lane`
- `/api/cost-risks`
- `/api/optimization-posture`
- `/api/verification`
- `/api/sample`
## Screenshots
## CLI
```powershell
npx bigquery-query-cost-watch fixtures/bigquery-query-hotspots.json `
--format markdown `
--fail-on-high
```
## Validation
- `npm run verify`
- `npm run prerender`
- `npm run render:assets`
## Local development
```powershell
cd bigquery-query-cost-watch
npm install
npm run dev
```
Then open:
- [http://127.0.0.1:5524/](http://127.0.0.1:5524/)
- [http://127.0.0.1:5524/query-lane](http://127.0.0.1:5524/query-lane)
- [http://127.0.0.1:5524/cost-risks](http://127.0.0.1:5524/cost-risks)
- [http://127.0.0.1:5524/optimization-posture](http://127.0.0.1:5524/optimization-posture)
## Packaging
| Item | Value |
|---|---|
| License | `AGPL-3.0-or-later` |
| CNAME | `bigquery.kineticgain.com` |
| Live site | [https://bigquery.kineticgain.com/](https://bigquery.kineticgain.com/) |
| Deploy | Static prerender -> GitHub Pages |
## Docs
- [docs/KINETIC_GAIN_EMBEDDED.md](./docs/KINETIC_GAIN_EMBEDDED.md)
## Related
- [**`gcp-billing-anomaly-router`**](https://github.com/mizcausevic-dev/gcp-billing-anomaly-router) — GCP cost anomaly routing lane
- [**`regulatory-reporting-mart`**](https://github.com/mizcausevic-dev/regulatory-reporting-mart) — reporting and warehouse proof
- [**`snowflake-cost-governance-studio`**](https://github.com/mizcausevic-dev/snowflake-cost-governance-studio) — warehouse cost governance on Snowflake
## Part of the Kinetic Gain Suite
Operator surface in the [Kinetic Gain Suite](https://suite.kineticgain.com/) — a portfolio of buyer-readable control planes spanning security posture, compliance evidence, data-platform governance, FinOps, and operator workflows. See the suite index for related surfaces. Apex: [kineticgain.com](https://kineticgain.com/).