Cost and Usage Report Requirements

Your AWS Cost and Usage Report (CUR) is the source of billing data that CloudZero uses to show your AWS costs. If your account already has a CUR, verify it matches the settings below. An existing report is preferred because CloudZero can access your historical cost data. If you have an existing report with historical data in a different format, reach out to your account manager to bring that data into CloudZero.

The automated setup detects a compatible Cost and Usage Report and connects to it. If it can't find one, it creates a new report for you.

Required settings

CloudZero supports both CUR 2.0 (Data Exports) and CUR 1.0 (Legacy CUR export). For new connections, AWS and CloudZero both recommend CUR 2.0, which provides a more consistent schema and more detailed cost and usage data.

ℹ️

If you create a new Cost and Usage Report, it can take up to 24 hours before AWS publishes billing data to the report.

CUR 2.0 (Data Exports)

To create a CUR 2.0 export, configure it in AWS Billing and Cost Management > Data Exports with these settings. For a walkthrough, see Creating a standard data export in the AWS documentation.

SettingRequired value
Export typeStandard data export
TableCUR 2.0
Time granularityHourly
Compression typeParquet
Include resource IDsOn
Split cost allocation dataOn
Include caller identity (IAM principal) allocation dataOn

CUR 1.0 (Legacy CUR export)

If you have an existing CUR 1.0 report, verify it uses these settings. For details on creating or modifying a Legacy CUR, see Creating reports in the AWS documentation.

SettingRequired value
Report typeLegacy CUR export
Time granularityHourly
Report versioningCreate new report version
Export formatCSV with GZIP compression, or Parquet
Include Resource IDsOn
Data refresh settingsAutomatic
Split Cost Allocation DataOff

Recommended S3 settings

These settings are not required but help keep your S3 bucket organized:

SettingRecommended value
S3 bucket name<your-company-name>-billing
Report path prefixhourly-billing

Tag normalization in Parquet

Parquet CUR files (required for CUR 2.0, optional for CUR 1.0) normalize tag column names by converting them to lowercase and replacing non-alphanumeric characters with underscores. If you have multiple active cost allocation tags that differ only by capitalization or punctuation (for example, Environment and environment), they collapse into a single column in the Parquet file. CloudZero ingests the file as-is, and you can use Dimensions to normalize inconsistent tag variations into a single business category.

To avoid tag collisions, standardize your tag keys in AWS so each concept uses one consistent form. For details on how Parquet normalization works, see Cost allocation tags in the AWS documentation.

ℹ️

Have questions or feedback? Reach out to your account manager.