reference deployment

New Relic Infrastructure–Amazon EC2 Integration on AWS

Report EC2 performance, status, and other data to New Relic products

New Relic Infrastructure Amazon Elastic Compute Cloud (Amazon EC2) Integration is used for reporting metadata from Amazon EC2 instances to New Relic products. 

This Partner Solution automates the process of deploying and managing the New Relic infrastructure agent on Amazon EC2 instances across various operating systems and architectures. After the New Relic infrastructure agent is installed on each Amazon EC2 instance, customers can get a comprehensive, real-time view of the performance and status of those instances. 

The Partner Solution supports multiple methods for launching Amazon EC2 instances in the AWS Cloud. Customers can deploy it into a single AWS account and Region or into multiple accounts and Regions using AWS CloudFormation StackSets.

New Relic logo

This Partner Solution was developed by New Relic in collaboration with AWS. New Relic is an AWS Partner.  

  •  What you'll build
  • The Partner Solution sets up the following:

    • (Optional) Amazon EC2 instance profile with a linked AWS Identity and Access Management (IAM) role used for granting access to AWS Systems Manager service functionality within the Amazon EC2 instance.*  
    • An AWS Systems Manager Automation execution IAM role to allow the Amazon EC2 instances to run the AWS Systems Manager Automation runbook.
    • In the Region:
      • An Amazon EventBridge rule that filters the Amazon EC2 instances for the matching instance ID, which is then passed to AWS Systems Manager. 
      • An AWS Systems Manager Automation runbook with instructions for retrieving the New Relic license key and installing the New Relic infrastructure agent on Amazon EC2 instances with matching tags. 
      • An AWS Systems Manager Command document to run the installation commands listed in the Automation runbook. 
    • IAM configurations that include groups, roles, and instance profiles as well as customizable IAM policies.
    • Amazon Eventbridge for providing the filtering rule.
    • AWS Systems Manager for providing the Automation runbook and Command document.
    • AWS Secrets Manager for storing the New Relic license key.

    * The template prompts you for your New Relic license key and asks if you want to create a new AWS Systems Manager instance profile for your Amazon EC2 instances.

  •  How to deploy
  • To deploy New Relic Infrastructure Amazon EC2 integration, follow the instructions in the deployment guide. A standard deployment takes about 5 minutes and includes these steps:

    1. If you don't already have an AWS account, sign up at, and sign in to your account.
    2. Launch the Partner Solution by choosing one of the following options. If creating a single stack, be sure to choose the Region from the top toolbar before creating the stack. 
    3. Test the deployment. 

    Amazon may share user-deployment information with the AWS Partner that collaborated with AWS on this solution.  

  •  Cost and licenses
  • This Partner Solution requires a New Relic license key, which is available with your New Relic account. 
    You are responsible for the cost of the AWS services and any third-party licenses used while running this Partner Solution reference deployment. There is no additional cost for using the Partner Solution.

    The AWS CloudFormation templates for this Partner Solution include configuration parameters that you can customize. Some of these settings, such as instance type, affect the cost of deployment. For cost estimates, refer to the pricing pages for each AWS service you use. Prices are subject to change.

    Tip: After you deploy the Partner Solution, create AWS Cost and Usage Reports to track costs associated with the Partner Solution. These reports deliver billing metrics to an Amazon Simple Storage Service (Amazon S3) bucket in your account. They provide cost estimates based on usage throughout each month and aggregate the data at the end of the month. For more information, refer to  What are AWS Cost and Usage Reports?