Integrating your AWS account(s) with our platform is a two-stage process. First, you will setup Billing Reports for us to ingest cost and usage data (read-only) for each payer account, which also automatically includes all associated linked accounts’ cost and usage data. Second, you’ll setup access to AWS APIs for each linked account.
Stage 1: Add Consolidated Account 15-20 min. setup, 4-24 hrs. until data first appears in Cloudability
- Enable Billing Reports: To generate cost and usage data
- Enable tags for Billing Reports: To give more visibility into spend
- Generate Access Credentials: To allow us to access S3 bucket to ingest the Billing Reports
1. Navigate to Billing Dashboard, select Cost & Usage Reports, and click Create Report.
2. Name your report and be sure both boxes shown here are checked, on the next page be sure to select "Hourly" for the time granularity option
3. Configure or select the S3 bucket you'd like your CUR files in, leave all settings as default - please keep the compression type as "GZIP"
4. Cost allocation tags
a. From the Billing page select Cost allocation tags and press the Activate button. b. Be sure to enable any tags you've defined that you want to use to analyze your spend.
a. As a Cloudability administrator, navigate to the Vendor Credentials page in Cloudability.
b. Click the Add a Credential button on the right. If you've followed steps 1-3 in this document, you're ready to create an IAM Role using our admin console.
c. Enter your payer account ID and the name of the S3 bucket that contains your Billing Reports in the appropriate fields, plus the report and report prefix specified in the Cost and Usage reports section. Once you've entered these fields, the Generate Template button will become active. Click the Generate Template button to create a new Credential placeholder in Cloudability.
d. After a moment, the button will change to read "Download". Click the Download button to download the CloudFormation Template.
e. Navigate to the CloudFormation section of the AWS Management Console, and Create a new Stack.
f. Choose to Upload the template you downloaded from Cloudability, and click Next.
g. Choose a descriptive Stack name (something starting with "Cloudability", for example) and verify the automatically populated Parameters, then click Next.
h. Read and click through the remainder of the confirmation screens. Don't forget to check the acknowledgement before you click Create.
i. Your new Stack will initially have a Status of CREATE_IN_PROGRESS. Once the status changes to CREATE_COMPLETE, you're ready to return to Cloudability to verify the credential was set up properly.
j. Back in Cloudability, click Verify Credentials to verify the new credential you just set up.
k. You'll immediately see the payer account you just set up appear on the Vendor Credentials page. We'll use the permissions you set up to query for the AWS account linked to this payer account. In a few minutes, you'll see the linked accounts if you refresh the page:
Continue to connect AWS API data to your linked accounts.
Note: It takes anywhere from 4 to 24 hours for your cost and usage data first to appear in Cloudability, depending on how long it takes AWS to generate your first billing reports. In the meantime, you'll see a message indicating your data has not yet arrived.