Skip to main content
Before you begin, ensure you have:
  • Detailed Billing Export active in BigQuery
  • Costory service account with view-only access
  • GKE cost allocation enabled (if running GKE workloads)

​
What You Provide

BigQuery Table Path

The fully qualified path to your billing export table (e.g., project.dataset.table)

​
Setup Steps

1

Confirm export is active

Verify your Detailed Billing Export is running in the GCP Console under Billing → Billing Export.
2

Grant service account permissions

Add the Costory service account with the following roles:
  • BigQuery Data Viewer
  • BigQuery Metadata Viewer
3

Create GCP datasource in Costory

Navigate to Settings → Data Sources → Add New and select GCP.
4

Enter table path

Provide the full BigQuery table path for your billing export.

​
FAQ

Direct GCP customers: Only the current month is backfilled automatically.Reseller customers: Contact your reseller to export historical billing data.
Only if you’re running GKE workloads. GKE cost allocation provides granular container-level cost attribution.

​
Next Steps

Add Usage Metrics

Connect usage data to explain cost changes.

Connect Events

Link engineering events for correlation.