AWS Sustainability
Use the AWS Sustainability integration to track estimated emissions from AWS usage across your organization.
- Audience: Cloudaware administrators, FinOps teams, and sustainability reporting teams
- Outcome: Monthly AWS carbon emissions reports available in Cloudaware for sustainability reporting
How It Works
- AWS delivers a carbon emissions export to S3 each month with estimated emissions for the previous usage month.
- Cloudaware uses its IAM role in the connected AWS management account to discover the export and read the report files from S3.
- Use the sustainability data to build reports and BI analytics.
Prerequisites
- Connect the AWS management (payer) account to Cloudaware using the AWS Setup Guide. Use the management account to report on the organization and its member accounts.
- Use an AWS identity with permission to manage Data Exports, configure the destination S3 bucket, and update the Cloudaware CloudFormation stack. AWS requires
sustainability:GetCarbonFootprintSummaryin addition to the Data Exports permissions to create a Carbon emissions export. See the AWS Data Exports permissions reference. - The Cloudaware CloudFormation template applied to the management account must include
sustainability:*permission.
Check if the Carbon Emissions Export exists in AWS
- Sign in to the AWS management account and open Billing and Cost Management.
- Under Cost and Usage Analysis in the left menu, select Carbon Emissions.
- Select Reports in the left menu. Review the available reports.
Grant Cloudaware Access to the Export
Use the Cloudaware IAM role in the management account to discover the data export. If the role already has the permissions below, continue to verification.
| Purpose | IAM actions | Resource scope |
|---|---|---|
| Find the export | bcm-data-exports:ListExports | * |
| Read the export definition and destination | bcm-data-exports:GetExport | Carbon emissions export ARN |
| Locate and list files | s3:GetBucketLocation, s3:ListBucket | Destination bucket. Scope listing to the export prefix where possible. |
| Read report files | s3:GetObject | Objects under the export prefix |
Verify if Cloudaware Has Discovered the Export
- In Cloudaware, go to Admin Console.
- Find AWS Sustainability in Other Integrations. Click CONFIGURED.
- In the Cloudaware Admin Console, open the AWS Sustainability integration.
- Check the management account and confirm that the discovered report matches the export you configured in AWS.
Troubleshooting
- The report is missing in Cloudaware. Verify that the management account is connected and that the Cloudaware role can read the data export. See AWS Integration Verification.
- AWS has delivered no files. Check the export status and S3 delivery policy in AWS. See AWS troubleshooting for carbon emissions exports.