Enabling Detailed Billing Reports

CloudCheckr uses the AWS Detailed Billing Report (DBR) to generate cost reports.

This article explains how to enable the DBR within AWS, as well as set up an S3 bucket to house the DBR and lastly, provide CloudCheckr access to that S3 bucket so we can start processing your billing data and giving you insights into your deployment's cost.


  1. Login to the AWS Billing Console.

    You can also login to the AWS Management Console, go to the menu bar and right-click your account name, and select My Billing Dashboard from the fly-out menu.

  2. From the Dashboard, click Preferences.

  3. Under the Cost Management Preferences section, select the Receive Billing Reports checkbox.

  4. To receive billing reports, you have to choose the S3 bucket where they will be stored. Type the name of an S3 bucket.

    1. From the AWS Management Console, select Storage > S3.
    2. Create an S3 bucket. See the AWS topic, Create a Bucket, for more information.
    3. Type the exact name of the new S3 bucket in the S3 Bucket text field.
    4. Next, you'll have to edit the S3 bucket properties and add a permission policy granting AWS access to publish your DBR:

    5. Click the sample policy link below the S3 Bucket text field.
    6. Copy the policy in the dialog box and click Close.
    7. From the top of the page, select Services and select S3 from the left side of the console.
    8. From the S3 list, click the name of the new S3 bucket.
    9. Click the Permissions tab.
    10. Click the Bucket Policy button.
    11. Paste the sample policy that you copied into the editor.
    12. Click Save.
  5. Click Verify next to the S3 Bucket text field to validate that AWS saved the correct bucket policy.

    A green checkbox indicates that the bucket is configured correctly.

  6. On the Preferences page, scroll down to the Report section, and choose the billing reports that you would like to receive.

    We highly recommend that you select Detailed billing report with resources and tags. If you only select Detailed billing report, the application will not be able to show your bill by resources.

    To get the most out of CloudCheckr, we recommend that you enable all reports.
  7. Click Save preferences.
  8. It can take a few days for AWS to build these reports. Once they are available within AWS, CloudCheckr will use the data to build your cost reports.

Changing the S3 Bucket

If you decide at later date that you want to use a different S3 bucket to collect the DBR information from AWS, follow these steps:

  1. In AWS, identify or create an S3 bucket where you want the DBR to be stored.
  2. Make sure that CloudCheckr has permissions to access this bucket.
  3. Launch CloudCheckr.

  4. From the left navigation pane, choose Account Settings > Detailed Billing Bucket.

    The Edit Detailed Billing Bucket page opens.

  5. In the S3 Bucket section, replace the name of the existing S3 bucket with the exact name of the new S3 bucket.

How did we do?