
Support Matrix
Click a datasource to jump to the right setup steps.CSV
Upload usage metrics as a flat or columnar CSV.
Google Sheet
Sync metrics directly from a Google Sheet.
Datadog
Query Datadog metrics with rollups.
Datadog CI
Pull CI visibility metrics from Datadog.
BigQuery
Import metrics stored in BigQuery tables.
GCS Inventory
Use GCS inventory Parquet exports.
Amplitude
Bring product analytics metrics into Costory.
S3 Parquet
Import Parquet metrics files from S3.
CSV
- Manual setup
- Terraform
- Prepare a CSV file in flat or columnar format.
- Date column in
YYYY-MM-DD - Metric values are numeric
- Date column in
- In Costory, go to Metrics > Import new metrics datasource > CSV.
- Upload the file, choose the orientation, and map columns.
- Define the metric names, aggregation, and gap-filling rules.
Google Sheet
- Manual setup
- Terraform
- Share the sheet with
importer-sheets@costory.io. - Ensure the first row contains headers (date + metric columns).
- In Costory, go to Metrics > Import new metrics datasource > Google Sheet.
- Provide the Google Sheet ID and map the columns.
Datadog
- Manual setup
- Terraform
- Create a Datadog integration in Integrations (API key, application key, region).
- In Costory, go to Metrics > Import new metrics datasource > Datadog.
- Select the Datadog configuration.
- Provide a metric query with a rollup (example):
avg:system.cpu.user{*} by {host}.rollup(avg, daily, 'UTC')
- Validate and finalize the metrics definition.
Datadog CI Visibility
- Manual setup
- Terraform
- Create a Datadog integration in Integrations with CI Visibility access.
- In Costory, go to Metrics > Import new metrics datasource > Datadog CI Visibility.
- Provide the CI Visibility query, aggregation, and optional group-by fields.
BigQuery
- Manual setup
- Terraform
- Share your dataset with the Costory service account:
costory-<org-slug>@costory-production.iam.gserviceaccount.com
- In Costory, go to Metrics > Import new metrics datasource > BigQuery.
- Provide the BigQuery table path and map the columns (flat or columnar format).
GCS Inventory (Parquet)
- Manual setup
- Terraform
- Share your GCS inventory bucket with the Costory service account:
costory-<org-slug>@costory-production.iam.gserviceaccount.com
- In Costory, go to Metrics > Import new metrics datasource > GCS Inventory.
- Provide the inventory file path (e.g.,
gs://bucket/path/to/data), bucket name, and search pattern. - Validate and finalize the metrics definition.
Amplitude
- Manual setup
- Terraform
- Get your Amplitude API key and secret key (Project settings).
- In Costory, go to Metrics > Import new metrics datasource > Amplitude.
- Provide the API key, secret key, and region.
- Costory syncs the last 12 months of data automatically.
Parquet file (AWS S3)
- Manual setup
- Terraform
- Store your metrics parquet files in S3.
- Create an IAM role with read-only S3 access and a web identity trust for Costory.
- In Costory, go to Metrics > Import new metrics datasource > Parquet file (AWS S3).
- Provide the bucket name, prefix, role ARN, and configure metric definitions (value column, date column, aggregation, gap-filling, dimensions, unit).
