Connect AWS polling integrations | New Relic Documentation

To start receiving Amazon data with New Relic's AWS integrations, connect your Amazon account to New Relic. If you don't have one already, create a New Relic account. It's free, forever.

AWS CloudWatch metric streams is now the recommended solution to monitor AWS services. Learn more in New Relic's CloudWatch solution and AWS CloudWatch blog posts.

Follow the steps documented in the AWS CloudWatch metric stream integration to ingest all available CloudWatch metrics.

Tip

You can use Terraform to automate the process of enabling cloud integrations. Read how in the Terraform official documentation site.

Connect individual AWS integrations to New Relic

To connect additional API Polling integrations to New Relic:

Go to one.newrelic.com > Infrastructure > AWS. Click on one of the available service tiles.
From the IAM console, click Create role, then click Another AWS account.
- For Account ID, use 754728514883.
- Check the Require external ID box.
- For External ID, enter your New Relic account ID.
- Don't enable the setting to Require MFA (multi-factor authentication).
Attach the Policy: Search for ReadOnlyAccess, select the checkbox for the policy named ReadOnlyAccess, then click Next: Review. Alternatively, you can create your own managed policy and limit the permissions you grant New Relic according to the AWS services you want to monitor.
For the Role name, enter NewRelicInfrastructure-Integrations, then click Create role.
Select the newly created role from the listed roles. On the Role summary page, select and copy the entire Role ARN (required later in this procedure).
Configure a Budgets policy: While viewing the Role summary for your new role, select Add inline policy.
Create a Custom policy: Enter a policy name, for example NewRelicBudget, add the following permission statement, and then select Apply policy.
```
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["budgets:ViewBudget"],
      "Resource": "*"
    }
  ]
}
```
Return to the New Relic UI to enter your AWS account name and the ARN for the new role.
Select the Amazon Web Services to be monitored with New Relic infrastructure integrations, then Save.

It may take few minutes until new resources are detected and synthesized as entities. See Cloud integrations system limits for more information.

Connect multiple AWS integrations

To connect multiple AWS integrations to a single New Relic account:

If you previously set up an ARN with the more restrictive AmazonEC2ReadOnlyAccess policy, first unlink your existing integration, then create a new one with a broader policy.
Follow the instructions to connect your Amazon account to New Relic .
Provide the ARN that contains the ReadOnlyAccess policy.

Once setup is complete, select the integrations you want to monitor:

Go to one.newrelic.com > Infrastructure > AWS.
Select the edit icon.
Select the checkbox for each integration you want to monitor.

Connect multiple AWS accounts

By default, the Amazon EC2 AmazonEC2ReadOnlyAccess permission grants New Relic access to all EC2 instances in the individual Amazon account you specify during the setup steps. If you have multiple AWS accounts, follow the steps to connect an AWS account for each AWS account you want to associate with New Relic.

Add or edit custom tags

New Relic automatically imports custom tags you have added or edited for your AWS resources. Most metrics received via CloudWatch metric streams will have custom tags as dimensions.

For API Polling integrations, if you don't see any tags in the Add filter menu of the Filter sets sidebar within a few minutes, delete the integration and try again:

Go to one.newrelic.com > Infrastructure > AWS.
Select the edit icon.
Remove individual integrations or the entire account linkage as needed.

Note that not all integrations support tags collection. You can enable (and disable) tags collection in the integration settings.

Disconnect your AWS integrations

You can disable one or more integrations anytime and still keep your AWS account connected to New Relic. However, New Relic recommends that you do not disable EC2 or EBS monitoring. These two integrations add important metadata to your EC2 instances and EBS volumes in New Relic.

To uninstall your services completely from New Relic infrastructure Integrations, unlink your AWS account.

Regional support

China regions are not supported.