• EnglishEspañol日本語한국어Português
  • Log inStart now

Connect AWS polling integrations

To start receiving Amazon data with New Relic's AWS integrations, connect your Amazon account to New Relic. If you haven't already, create your free New Relic account below to start monitoring your data today.

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.


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:

  1. Go to one.newrelic.com > All capabilities > Infrastructure > AWS. Click on one of the available service tiles.

  2. From the IAM console, click Roles, click Create role, select AWS account, then select 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).
    • Click Next
  3. Attach the Policy: Search for ReadOnlyAccess in the Permissions policies text box, select the checkbox for the policy named ReadOnlyAccess, then click Next. 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.

  4. For the Role name, enter NewRelicInfrastructure-Integrations, then click Create role.

  5. 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).

  6. Configure a Budgets policy: While viewing the Role summary for your new role, open the Add permissions drop-down and click on Create inline policy.

  7. Open the JSON tab and add the following permission statement:

    "Version": "2012-10-17",
    "Statement": [
    "Effect": "Allow",
    "Action": ["budgets:ViewBudget"],
    "Resource": "*"
  8. Then click Review policy. Enter a policy name, for example NewRelicBudget, and then select Create policy.

  9. Return to the New Relic UI to enter your AWS account name and the ARN for the new role.

  10. 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:

  1. 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.
  2. Follow the instructions to connect your Amazon account to New Relic .
  3. Provide the ARN that contains the ReadOnlyAccess policy.

Once you complete your setup, you can see your integrations at one.newrelic.com > All capabilities > Infrastructure > AWS.

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 within a few minutes, delete the integration and try again:

  1. Go to one.newrelic.com > All capabilities > Infrastructure > AWS.
  2. Click Manage services.
  3. 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

We don't support Chinese AWS regions.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.