Enabling Detailed Billing Reports

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

After you create your cross-account access role, you must enable the DBR to ensure it is associated with the proper S3 bucket and it is accessible to CloudCheckr.

This procedure will show you how to enable the DBR in AWS.


  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.

    The Billing & Cost Management Dashboard opens.
  2. From the Dashboard, click Preferences.

    The Preferences page opens.
  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.

    Follow these steps to edit the S3 bucket properties and add a permission policy granting AWS access to publish your reports:

    1. Click the sample policy link below the S3 Bucket text field.

      The Sample Policy dialog box opens.
    2. Copy the policy in the dialog box and click Close.
    3. From the top of the page, select Services and select S3 from the left side of the console.
    4. From the S3 list, click the name of the new S3 bucket.
    5. Click the Permissions tab.
    6. Click the Bucket Policy button.

      The Bucket Policy editor opens.
    7. Paste the sample policy that you copied into the editor.
    8. 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?