Skip to main content

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:GetCarbonFootprintSummary in 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​

  1. Sign in to the AWS management account and open Billing and Cost Management.
  2. Under Cost and Usage Analysis in the left menu, select Carbon Emissions.
  3. 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.

PurposeIAM actionsResource scope
Find the exportbcm-data-exports:ListExports*
Read the export definition and destinationbcm-data-exports:GetExportCarbon emissions export ARN
Locate and list filess3:GetBucketLocation, s3:ListBucketDestination bucket. Scope listing to the export prefix where possible.
Read report filess3:GetObjectObjects under the export prefix

Verify if Cloudaware Has Discovered the Export​

  1. In Cloudaware, go to Admin Console.
  2. Find AWS Sustainability in Other Integrations. Click CONFIGURED.
  3. In the Cloudaware Admin Console, open the AWS Sustainability integration.
  4. Check the management account and confirm that the discovered report matches the export you configured in AWS.

Troubleshooting​