In this tutorial, you use the Wavefront Amazon Web Services (AWS) integration to:
- Send data of the applications and services that run on your AWS account to Wavefront.
- Visualize the data and identify problem areas once the data is in Wavefront.
It’s an easy setup. You don’t have to install anything or make changes to your application code.
Wavefront supports other cloud integrations, such as Google Cloud Platform (GCP), Microsoft Azure, and many other integrations. See List of Wavefront Integrations.
Step 1: Log In To Wavefront
Follow these steps:
- In your web browser, go to your Wavefront cluster (https://www.<enter_cluster_name>.waverfront.com), and log in.
If you don’t have a cluster, sign up for a free trial. - From the taskbar, click Integrations.
- Select the Amazon Web Services (AWS) tile.
- Click the Setup tab and click Add Integration.
You need the Account ID and External ID printed under How to get Role ARN for the next step.
Step 2: Create a Wavefront ReadOnly Role in Your AWS Account
For this step, you need to log in to your AWS account. Create a new AWS account if you don’t have one.
Follow these steps:
- On a web browser tab, log in to your AWS account.
- Search for the IAM (AWS Identity and Access Management) service and click it to open the service.
- Click Roles on the left panel and click Create role.
- Create an AWS account:
- Select Another AWS Account.
- Enter the Account ID: Copy the Account ID value shown in the Wavefront AWS integration instructions and paste it here.
- Select Require external ID.
- Enter the External ID. Copy the External ID value shown in the Wavefront AWS integration instructions and paste it here.
- Click Next: Permissions.
- Set Permissions:
- Search for the ReadOnlyAccess permission and select it.
Note: You get many results when you search for ReadOnlyAccess. Scroll down until you find ReadOnlyAccess, as shown in the screenshot below.
- Click Next: Tags. You don’t have to set any tags.
- Search for the ReadOnlyAccess permission and select it.
- Click Next: Review.
- Set the Role Name as wavefront.
- Click Create role.
- Once the list of roles appears, click on wavefront (the role you just created), and copy the Role ARN value.
Step 3: Configure the Wavefront AWS Integration
Go back to the Wavefront cluster where you opened the AWS integration tile previously, and follow these steps:
- Paste the Role ARN value you copied in the previous step as the value for “Role ARN” from Amazon IAM.
- Click Register.
Wavefront can now connect to your AWS account and get data. Once the data starts flowing to Wavefront, you can visualize them. It will take a few minutes for the data to show in Wavefront.
Step 4: (Optional) Launch an EC2 Instance
Don’t have an application running on your AWS account? Follow the steps given below. If you already have an application running on the AWS account, move to the next step and see how you can visualize your data.
- Go back to your AWS account, search for the EC2 service, and click it to open the service.
- Follow the AWS documentation on Launching an Amazon EC2 Instance.
Once the instance is launched, you start to see the data in Wavefront after a few minutes.
Step 5: See Metrics and Visualize Data
Once the data starts flowing into Wavefront, you can see metrics and visualize data on dashboards:
View Metrics
- On the Wavefront Cluster, go to the AWS integration.
- Select the Metrics tab.
You see charts with the metrics collected from your AWS account.
Example:
View Data on Dashboards
Wavefront includes pre-defined dashboards for AWS that help you analyze and gather data.
- Click Dashboards, to see a list of dashboards.
- Click AWS: Summary. From the Summary dashboard, you can easily navigate to all other AWS dashboards.
Note: You need to configure your AWS account preferences to send billing metrics to Wavefront. See Configuring CloudWatch Billing Metrics.
Next Steps
- For more information on the AWS integration, see Amazon Web Services Integration.
- Try out the Dashboards and Alerts Tutorial.
- Learn about the metrics that help you monitor CloudWatch requests, API requests, the point rate, and events coming in from your AWS integration.