Skip to main content
Connect Parquet files from S3 as external metrics. On Add integration, the AWS tile is CloudWatch metrics / Parquet files from S3. Choose S3 metrics on that tile. For CloudWatch, see AWS CloudWatch. Costory mirrors Parquet files under a prefix and exposes each as a metric in Advanced Explorer. Files are mirrored to Google Cloud Storage and exposed through BigQuery external tables. You can trigger a sync manually at any time. Costory scans only the prefix root plus one directory level. A directory of part-*.parquet files counts as one metric. Every other .parquet file is its own metric, including dated snapshots. Hive partitions (dt=2026-08-01/) are not supported. The maximum is 50 metrics per bucket.
Connect an S3 bucket form with scan rules, Role ARN, bucket name, and optional prefix

Connect an S3 bucket: how files become metrics, then Role ARN, bucket, and prefix

Lower half of Connect an S3 bucket with the S3 read policy, Force validate, Validate, and Save connection

S3 metrics connect screen: S3 read policy, prefix, Force validate, and Save connection

1

Store Parquet files in S3

Put metric files under a bucket prefix. Keep the layout to the prefix root and one directory. Do not rely on Hive-style partitions (dt=2026-08-01/...).
2

Create a read-only IAM role

Create an IAM role with read-only S3 access on that bucket and prefix, plus a web identity trust for Costory. Use the same federated trust as AWS billing. Copy the trust policy from the Costory connect screen.
3

Open the AWS tile

Go to Integrations, click + Add integration, then under External metric choose AWS. Pick S3 metrics.
4

Enter connection details

Fill Connection name, Role ARN, and Bucket name. Prefix is optional. Click Validate, then Save connection. Use Force validate if you need to re-check the role and bucket after a failed attempt.
5

Query in Advanced Explorer

Click Explore your data, switch to Advanced, then + Add Metric. Open integrations and pick the S3 source. See Query after you connect.
Save connection stays disabled until validation succeeds. Hive partitions are not supported. Costory stops at 50 metrics per bucket.

How files become metrics

AWS CloudWatch

Connect CloudWatch on the same AWS tile.

Metrics Correlation

Query external metrics in Advanced Explorer.

Google Sheets

Connect numeric columns from a spreadsheet instead.
Last modified on August 20, 2026