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
What if I don't have historical data yet?
What if I don't have historical data yet?
Direct GCP customers: Only the current month is backfilled automatically.Reseller customers: Contact your reseller to export historical billing data.
Do I need GKE cost allocation?
Do I need GKE cost allocation?
Only if you’re running GKE workloads. GKE cost allocation provides granular container-level cost attribution.