Install the .NET agent on AWS Elastic Beanstalk

Amazon Web Services (AWS) Elastic Beanstalk is a dynamic service that allows easy deployment and scalability for your applications. Follow these instructions to deploy the .NET agent to the instances launched with your .NET AWS Elastic Beanstalk applications. You may also want to install the New Relic Infrastructure agent on your Elastic Beanstalk instances; refer to Configure the infrastructure agent on AWS Elastic Beanstalk for more details.

Requirements

Make sure you have a supported Amazon Web Services account. In addition, for any New Relic installation, you will need your license key. This is a 40-character hexadecimal string that New Relic provides when you sign up for your account.

Install the .NET agent

To install the .NET agent for ASP.NET Core web applications deployed to AWS Elastic Beanstalk, follow these steps. You can also find working example projects for both Windows and Linux in our .NET agent samples repository.

1. Create a .ebextensions folder at the root of your application and create a file named newrelic-dotnet-agent-install.config. (The exact filename isn't important, but it must have a .config extension.)

2. Based on the operating system for your .NET application, add the following content to the file:

   • Replace YOUR_LICENSE_KEY with your New Relic license key.
   • Replace YOUR_APP_NAME with your application name.

   Windows

   packages:  
       msi:
         # install the latest version of the New Relic .NET agent
         # To install a specific version, update the path to the msi
         dotnet: https://download.newrelic.com/dot_net_agent/latest_release/NewRelicDotNetAgent_x64.msi
   option_settings:
       aws:elasticbeanstalk:application:environment:
         CORECLR_ENABLE_PROFILING: '1'
         NEW_RELIC_LICENSE_KEY: 'YOUR_LICENSE_KEY'
         NEW_RELIC_APP_NAME: 'YOUR_APP_NAME'

   Copy

   The license key and app name aren't required environment variables; they can be set in other ways.

   For more details on these variables, as well as correct values for other installation scenarios, please see understanding .NET agent environment variables.

   Amazon Linux 2023

   commands: 
     install_dotnet_agent:
       command: |
         sudo curl -o /etc/yum.repos.d/newrelic-dotnet-agent.repo https://download.newrelic.com/dot_net_agent/yum/newrelic-dotnet-agent.repo
         sudo yum -q makecache -y --disablerepo='*' --enablerepo='newrelic-dotnet-agent-repo'
         # this command installs the latest version of the dotnet agent.
         sudo yum install newrelic-dotnet-agent -y
         # to install a specific version, use something like the following:
         # sudo yum install newrelic-dotnet-agent-10.24.0-1.x86_64
   option_settings:
     aws:elasticbeanstalk:application:environment:
       CORECLR_ENABLE_PROFILING: '1'
       CORECLR_PROFILER: '{36032161-FFC0-4B61-B559-F6C5D41BAE5A}'
       CORECLR_NEWRELIC_HOME: '/usr/local/newrelic-dotnet-agent'
       CORECLR_PROFILER_PATH: '/usr/local/newrelic-dotnet-agent/libNewRelicProfiler.so'
       NEW_RELIC_LICENSE_KEY: 'YOUR_LICENSE_KEY'
       NEW_RELIC_APP_NAME: 'YOUR_APP_NAME'

   Copy

   The license key and app name aren't required environment variables; they can be set in other ways.

   For more details on these variables, as well as correct values for other installation scenarios, please see understanding .NET agent environment variables.

3. Deploy your application using the latest version of the AWS Toolkit for Visual Studio. You can also use the AWS CLI to deploy the application.

If your application is receiving traffic, data should appear within a few minutes. If it doesn't, see No data appears.