Lab complete!
Now that you have completed this lab, make sure to update your Well-Architected review if you have implemented these changes in your workload.
Click here to access the Well-Architected Tool
There are two primary method for deploying CUDOS, KPI and Cost Intelligence Dashboard listed below; basic and advanced. Both methods use CloudFormation templates to automate the setup. If you wish to use a command line tool or to deploy manually, see the alternative deployment methods section.
If you want to deploy CUDOS, KPI and Cost Intelligence Dashboard into your Management (Payer) Account, follow these steps.
The Cost & Usage Report is the foundation for multiple CID Dashboards. CID requires Cost & Usage Report to be created with the following format:
This step will create a new CUR for you. You can request a backfill after finishing this lab to have data in your dashboards from the past 7 months or more.
Login to the Management (Payer) Account in the region of your choice.
Click the Launch CloudFormation button below to open the pre-populated stack template in your CloudFormation console and select Next.
Make sure CreateCUR set to true.
Enter your Management (Payer) Account ID. Leave Source Account Empty.
Review the configuration, click I acknowledge that AWS CloudFormation might create IAM resources, and click Create stack.
You will see the stack will start with CREATE_IN_PROGRESS.
NOTE: This step can take 5-15mins |
---|
Once complete, the stack will show CREATE_COMPLETE.
You will now need to wait 24 hours for your first CUR to be deployed into S3. Before that dasbhoards will be empty.
We also recommend creating a Support Case in Service=Billing and category=Invoices and Reporting, requesting a backfill of your CUR (name=cid) with 12 months of data.
QuickSight is the AWS Business Intelligence tool that will allow you to not only view the Standard AWS provided insights into all of your accounts, but will also allow to produce new versions of the Dashboards we provide or create something entirely customized to you.
If you are already a regular QuickSight user you will need to make sure you have an enterprise license and add permissions for QuickSight to read your CUR bucket. You can accomplish this by going to the persona icon in the upper right hand corner of QuickSight, clicking Manage Quicksight, clicking on Security and Permissions, clicking on managing QuickSight access to AWS Service, selecting S3, then selecting the CUR bucket from the list of S3 buckets. If you are new to QuickSight, complete the steps below.
Log into your AWS Account and search for QuickSight in the list of Services
You will be asked to sign up before you will be able to use it
After pressing the Sign up button you will be presented with 2 options, please ensure you select the Enterprise Edition during this step
Select continue and you will need to fill in a series of options in order to finish creating your account.
Ensure you select the region that is most appropriate based on where your S3 Bucket is located containing your Cost & Usage Report file.
Enable the Amazon S3 option and select the bucket where your Cost & Usage Report is stored, as well as your Athena query bucket
Click Finish and wait for the congratulations screen to display
Click Go to Amazon QuickSight
Click on the persona icon on the top right and select manage QuickSight.
Click on the SPICE Capacity option. Purchase enough SPICE capacity so that the total is roughly 40GB. If you get SPICE capacity errors later, you can come back here to purchase more. If you’ve purchased too much you can also release it after you’ve deployed the dashboards.
Login into your Management (Payer) Account
Click the Launch CloudFormation button below to open the pre-populated stack template in your CloudFormation console and select Next
Enter a Stack name for your template such as Cloud-Intelligence-Dashboards
Review Common Parameters and confirm prerequisites before specifying the other parameters. You must answer ‘yes’ to both prerequisites questions.
Copy and paste your QuicksightUserName into the parameter text box To find your QuickSight username:
Update your CURBucketPath if needed.
s3://cid-1234567890123-shared/cur/
s3://cid-1234567890123-shared/prefix/name/name/
(double check this path, you must see /year=xxxx partitions in there)Select the Dashboards you want to install. We recommend deploying all three: Cost Intelligence Dashboard, CUDOS, and the KPI Dashboard.
Review the configuration, click I acknowledge that AWS CloudFormation might create IAM resources, and click Create stack.
You will see the stack will start in CREATE_IN_PROGRESS
NOTE: This step can take up to 7 minutes. |
---|
Once complete, the stack will show CREATE_COMPLETE
While this is working, head back to QuickSight and click on manage Quicksight from the person icon on the top right.
aws-athena-query-results-cid-1234567890123-us-east-1
). If you do not see this bucket, please check if it is created by the CloudFormation stack.NOTE: Stack can take 5-7 mins. |
---|
If you see no data please check the following:
aws-athena-query-results-cid-1234567890123-us-east-1
Failed
, you can click it to see more info).If you want to deploy CUDOS, KPI and Cost Intelligence Dashboard in an account other than your Management (Payer) Account, or wish to deploy the dashboards on top of multiple Management (Payer) Accounts or multiple linked accounts, use this method.
Advanced deployment supports multiple scenarios:
You will be deploying CloudFormation templates into two different types of places: your Source Accounts (typically management or payer account, but can be also a linked account as well) and your Destination or Data Collection Account (where you will deploy dashboards). You can create a new Linked Account or use an existing one.
There will be 3 steps related to CloudFormation deployment:
cid-{accountid}-shared
.As a result of first 2 steps, in Data Collection Account you will have an S3 bucket with the following structure:
s3://<prefix>-<destination-accountid>-shared/
cur/<src-account1>/cid/cid/year=XXXX/month=YY/*.parquet
cur/<src-account2>/cid/cid/year=XXXX/month=YY/*.parquet
cur/<src-account3>/cid/cid/year=XXXX/month=YY/*.parquet
Here we will deploy the CFN template but setting the CFN parameters for a Destination Account.
Login to the Destination account in the region of your choice. I can be any account inside or outside your AWS Organization.
Click the Launch CloudFormation button below to open the pre-populated stack template in your CloudFormation console and select Next.
Enter your Destination Account Id (Current Account).
NOTE: Please note this Account ID, we will need it later when we will deploy this same stack in your management (payer)/source accounts.
Disable CUR creation by entering False as the parameter value if you are replicating CURs from management (payer) accounts. You will only need to activate this if you are replicating CURs from linked accounts (not management payer accounts) and you want to have cost and usage data for this Destination account as well.
Enter your Source Account(s) IDs, using commas to separate multiple Account IDs.
Review the configuration, click I acknowledge that AWS CloudFormation might create IAM resources, and click Create stack.
You will see the stack will start with CREATE_IN_PROGRESS.
NOTE: This step can take 5-15mins |
---|
Once complete, the stack will show CREATE_COMPLETE.
Login to your Source Account (can be management account or linked account if you’re using member CURs ).
Click the Launch CloudFormation button below to open the stack template in your CloudFormation console and select Next.
Enter a Stack name for your template such as CID-CUR-Replication.
Enter your Desitnation AWS Account ID as a parameter (Your Data Collection Account, where you will deploy dashboards).
Review the configuration, click I acknowledge that AWS CloudFormation might create IAM resources, and click Create stack.
You will see the stack will start with CREATE_IN_PROGRESS .
NOTE: This step can take 5-15mins |
---|
Once complete, the stack will show CREATE_COMPLETE.
NOTE: It takes 24 hours for your first CUR to be delivered |
---|
It will take about 24 hours for your CUR to populate and replicate to your destination (data collection) account where you will deploy the dashboards. Return to this step after 24 hours. We also recommend creating a Support Case in Service=Billing and category=Invoices and Reporting, requesting a backfill of your CUR (name=cid) with 12 months of data. Case must be created from your Source Account (Management/Payer account).
The guide in this section will only work if you have already deployed the CUR replication setup using the CloudFormation template above.
Login to the Destination Account.
Find your existing template and choose Update
Check Use current template then choose Next
Update the AWS Account IDs list to modify CUR aggregation (ADD or DELETE)
Select Next at the bottom of Specify stack details and then select Next again on the Configure stack options page
Review the configuration, click I acknowledge that AWS CloudFormation might create IAM resources, and click Create stack.
You will see the stack will start with UPDATE_IN_PROGRESS
NOTE: This step can take up to 5mins |
---|
Once complete, the stack will show UPDATE_COMPLETE
QuickSight is the AWS Business Intelligence tool that will allow you to not only view the Standard AWS provided insights into all of your accounts, but will also allow to produce new versions of the Dashboards we provide or create something entirely customized to you. If you are already a regular QuickSight user you can skip these steps and move on to the next step. If not, complete the steps below.
Log into your Destination Linked Account and search for QuickSight in the list of Services
You will be asked to sign up before you will be able to use it
After pressing the Sign up button you will be presented with 2 options, please ensure you select the Enterprise Edition during this step
Select continue and you will need to fill in a series of options in order to finish creating your account.
Ensure you select the region that is most appropriate based on where your S3 Bucket is located containing your Cost & Usage Report file.
Enable the Amazon S3 option and select the bucket where your Cost & Usage Report is stored, as well as your Athena query bucket
Click Finish and wait for the congratulations screen to display
Click Go to Amazon QuickSight
Click on the persona icon on the top right and select manage QuickSight.
Click on the SPICE Capacity option. Purchase enough SPICE capacity so that the total is roughly 40GB. If you get SPICE capacity errors later, you can come back here to purchase more. If you’ve purchased too much you can also release it after you’ve deployed the dashboards.
In this option we use guide you through using a CloudFormation template that will deploy all needed resources. You will cut and paste some parameters (An S3 path to CUR data, A QuickSight user that will be the owner of the QuickSight assets, and which dashboards you want to deploy) into the template and click run.
All other resources are created automatically: Athena Workgroup and bucket, Glue table, Crawler, QS dataset, and finally the dashboards. The template uses a custom resource (a Lambda with this CLI tool ) to create, delete, or update assets.
Login into your Linked (Data Collection) Account
Click the Launch CloudFormation button below to open the pre-populated stack template in your CloudFormation console and select Next
Enter a Stack name for your template such as Cloud-Intelligence-Dashboards
Review Common Parameters and confirm prerequisites before specifying the other parameters. You must answer ‘yes’ to both prerequisites questions.
Copy and paste your QuicksightUserName into the parameter text box. To find your QuickSight username:
Update your CURBucketPath if needed.
s3://cid-1234567890123-shared/cur/
s3://cid-1234567890123-shared/prefix/name/name/
(double check this path, you must see /year=xxxx partitions in there).Please note that CURBucketPath parameter currently cannot be updated once the stack is created. If you need to change it you can delete and re-create the stack.
Select the Dashboards you want to install. We recommend deploying all three: Cost Intelligence Dashboard, CUDOS, and the KPI Dashboard.
Review the configuration, click I acknowledge that AWS CloudFormation might create IAM resources, and click Create stack.
You will see the stack will start in CREATE_IN_PROGRESS
NOTE: This step can take 5mins |
---|
Once complete, the stack will show CREATE_COMPLETE
While this is working, head back to QuickSight and click on manage Quicksight from the person icon on the top right.
aws-athena-query-results-cid-1234567890123-us-east-1
). If you do not see this bucket, please check if it is created by the CloudFormation stack.NOTE: This Output Section will be available once the Stack is Completed |
---|
If you see no data in QuickSight Dahsboards, plase check the following:
Failed
, you can click it to see more info).If you do not want to use CloudFormation to setup your dashboards, you have the option of using our command line tool or deploying manually.
Visit GuideNow that you have completed this lab, make sure to update your Well-Architected review if you have implemented these changes in your workload.
Click here to access the Well-Architected Tool