Manual integration from AWS console

Prerequisites

Before you begin integrating your AWS account with New Relic, ensure that you meet the following prerequisites:

• A New Relic Ingest - license key and a User key: You'll need these keys to connect your AWS services to your New Relic account.
• Permissions to deploy new AWS resources and IAM roles: You'll need this permission for your AWS account.
• Permissions for cloud integrations: You'll need these permissions for your New Relic account.

Create a Kinesis Data Firehose delivery stream

In the AWS console, set the following destination parameters for the delivery stream:

• Source: Direct PUT or other sources
• Destination: New Relic
• Data transformation: Disabled
• Record format conversion: Disabled
• Ensure the following settings are defined:
  • New Relic configuration (Destination Settings):
    • HTTP endpoint URL:
      • US Datacenter: https://aws-api.newrelic.com/cloudwatch-metrics/v1
      • EU Datacenter: https://aws-api.eu01.nr-data.net/cloudwatch-metrics/v1
      • JP Datacenter: https://aws-api.jp.nr-data.net/cloudwatch-metrics/v1
    • API key: Enter your license key
    • Content encoding: GZIP
    • Retry duration: 60
    • New Relic buffer conditions:
      • Buffer size: 1 MB
      • Buffer interval: 60 (seconds)
  • S3 backup mode: Failed data only
  • S3 backup bucket: Select a bucket or create a new one to store metrics that failed to be sent.
  • Advanced settings:
    • Service access: Provide permissions for IAM role:

      • Create or update IAM role

Create a CloudWatch metric stream

1. In the AWS console, go to CloudWatch service, select Streams under the Metrics menu, and click Create metric stream.
2. To control which AWS services send metrics to New Relic, configure inclusion and exclusion filters.
3. From the Firehose delivery stream list, select the stream you created, then enter a meaningful name for the metric stream, for example, newrelic-metric-stream.
4. In the output format field, select Open Telemetry 0.7 or Open Telemetry 1.0. JSON isn't supported.

Connect your AWS account to New Relic

1. In New Relic, go to Infrastructure > AWS.

2. Select the correct account.

3. Click Set up integration.

4. On each screen, fill in the fields that apply to you. For this integration, choose the following options:

   • Choose Data type(s): Metrics
   • Choose a setup method: Manually integrate your AWS account

5. On the Select services screen, toggle Show resources not supported by CloudWatch Metric Streams if needed, select the services you want to monitor, and continue.

6. On the Choose data integration type screen, choose from the following options:

   • Real-time AWS monitoring (Recommended): This option is for services that support CloudWatch Metric Streams.
   • API Polling: This option is for services not supported by CloudWatch Metric Streams.

7. From the Create role page to the Configure budgets policy page, follow the on-screen instructions and complete the steps in the AWS console.

Validate your data

To confirm you're receiving data from Metric Streams:

1. In New Relic, go to one.newrelic.com > All capabilities > Infrastructure > AWS, search for your connected AWS account, and look for Stream accounts.
2. In the account status dashboard, confirm that New Relic is receiving metric data, including errors and the number of namespaces and metrics ingested.
3. To explore specific metrics, write queries for the sets of metrics you want to analyze.

It may take a few minutes for New Relic to detect new resources and synthesize them as entities.