1 Install the New Relic agent as a gem
Select:
Add the gem to your Gemfile:
gem 'newrelic_rpm'
Bundle from your application's directory:
bundle install
Thanks for signing up! Now, let's get started.
New Relic, once installed, will show you your app, server and real user monitoring stats, helping you diagnose and demystify what's happening inside your machines.
We'll poll your server and it'll tell us what's going on — and then we'll show that to you in a dashboard of charts, graphs and data you can combine, hide or rearrange to your heart's content.
Installing the New Relic agent requires that you have administrator access (and you know how to use the command line) and will take between 15 minutes to an hour, depending on your language, framework, operating system and environment.
Please select your language:
I'm pretty smart, just show me the steps.
Installing the Ruby agent (47 second video)
At any point during the installation, additional help is available to get you started (don't worry, these links open in a new browser tab):
If all else fails, try emailing support@newrelic.com and we'll get back to you.
I'm pretty smart, just show me the steps.
Installing the Python agent (1:01 minute video)
At any point during the installation, additional help is available to get you started (don't worry, these links open in a new browser tab):
If all else fails, try emailing support@newrelic.com and we'll get back to you.
I'm pretty smart, just show me the steps.
Installing the Java agent (1:01 minute video)
At any point during the installation, additional help is available to get you started (don't worry, these links open in a new browser tab):
- For manual installation and scripted deployments Download the Agent Archive and read our Java Installation Guide
- Java Installation Troubleshooting
If all else fails, try emailing support@newrelic.com and we'll get back to you.
I'm pretty smart, just show me the steps.
Installing the .NET agent (1:02 minute video)
At any point during the installation, additional help is available to get you started (don't worry, these links open in a new browser tab):
If all else fails, try emailing support@newrelic.com and we'll get back to you.
I'm pretty smart, just show me the steps.
Installing the PHP agent (1:04 minute video)
At any point during the installation, additional help is available to get you started (don't worry, these links open in a new browser tab):
If all else fails, try emailing support@newrelic.com and we'll get back to you.
Installing the New Relic agent for Ruby
2 Download newrelic.yml
Place this file into your app's config directory, replacing the existing one.
Download the newrelic.yml file3 See data in 5 minutes
Now that you've tried your app with our agent, within minutes you should see data on New Relic's side.
If you believe you've correctly installed the agent, click the button below and we'll start looking for your data.
Installing the New Relic agent for Java
1 Download New Relic Java agent (java agent docs)
2 Install the agent
Select:
Unzip the file into your app's home directory:
unzip newrelic_agent2.19.1.zip -d /path/to/appserver/
Run the install command from the newrelic directory:
cd /path/to/appserver/newrelic
java -jar newrelic.jar install
For more info please reference our installation docs
Please follow instructions for your application server
- Tomcat using Windows Service Installer
-
JBoss, GlassFish, Jetty, Tomcat from zip
- Open newrelic_agent.zip
- Copy the newrelic folder to your application server's home folder
- Open a command prompt and navigate to the application server home
Run the install command from the newrelic directory:
cd newrelic
java -jar newrelic.jar install -
Other Application Servers
- Please reference our installation docs
3 Restart your app
- In a few minutes, your application will send data to New Relic
- Once New Relic receives the data, your application will be listed here
- This page will look similar to:
4 That's it!
Data is being collected and you will automatically be upgraded to New Relic PRO for a limited time.
If you believe you've correctly installed the agent, click the button below and we'll start looking for your data.
Installing the New Relic agent for .NET
1 Download the New Relic .NET agent installer
For 64-bit systems:
Download the (64-bit) .NET agentFor 32-bit systems:
Download the (32-bit) .NET agent2 Run the installer and restart IIS
When prompted for your license key, enter:
c7ae9078eb0aa0b6b746f9205f395ae303387992
If you didn't select the option to restart IIS in the installer, you can manually restart it by opening an administrative command prompt and running:
iisreset
3 What's next?
In a few minutes, your application will send data to New Relic and you'll be able to start monitoring your application's performance. You will also be automatically upgraded to New Relic PRO for a limited time.
If you believe you've correctly installed the agent, click the button below and we'll start looking for your data.
Installing the New Relic agent for PHP
1 Follow instructions for your PHP environment (advanced instructions)
Select:
Add the New Relic repository:
[32-bit:]rpm -Uvh http://yum.newrelic.com/pub/newrelic/el5/i386/newrelic-repo-5-3.noarch.rpm
[64-bit:]
rpm -Uvh http://yum.newrelic.com/pub/newrelic/el5/x86_64/newrelic-repo-5-3.noarch.rpm
Install the agent:
yum install newrelic-php5
newrelic-install install
Get the key:
wget -O - http://download.newrelic.com/548C16BF.gpg | apt-key add -
Create this file:
/etc/apt/sources.list.d/newrelic.list
Add this line to the file:
deb http://apt.newrelic.com/debian/ newrelic non-free
Install the agent:
apt-get update
apt-get install newrelic-php5
newrelic-install install
Download the latest tarball from: http://download.newrelic.com/php_agent/release
Unzip and install the agent files
gzip -dc newrelic-php5-X.X.X.X-OS.tar.gz | tar xf -
cd newrelic-php5-X.X.X.X
./newrelic-install install
2 Add your license key
Add your license key to the file you've set up with your New Relic properties: newrelic.ini or php.ini.
You should find the following line and replace "REPLACE_WITH_REAL_KEY" with your key:
newrelic.license="REPLACE_WITH_REAL_KEY"
Your license setting:
newrelic.license="c7ae9078eb0aa0b6b746f9205f395ae303387992"
3 Stop and Start your services
Stop and Start httpd, nginx, php-fpm, etc.
- In a few minutes, your application will send data to New Relic
- Once New Relic receives the data, your application will be listed here
- This page will look similar to:
4 That's it!
Data is being collected and you will automatically be upgraded to New Relic PRO for a limited time.
If you believe you've correctly installed the agent, click the button below and we'll start looking for your data.
Installing the New Relic agent for Python
1 Install the New Relic Python agent
pip install newrelic
2 Generate the configuration using your license key
newrelic-admin generate-config c7ae9078eb0aa0b6b746f9205f395ae303387992 newrelic.ini
3 Start the Python agent
export NEW_RELIC_CONFIG_FILE=newrelic.ini
newrelic-admin run-program gunicorn wsgi:application
- In a few minutes, your application will send data to New Relic
- Once New Relic receives the data, your application will be listed here
- This page will look similar to:
NOTE: If using a different WSGI server see: Self hosted instructions
- Additional documentation: Python Agent Integration
4 That's it!
Data is being collected and you will automatically be upgraded to New Relic PRO for a limited time.
If you believe you've correctly installed the agent, click the button below and we'll start looking for your data.
Coming Soon!
PRO Trial Included
Your account comes with a 14 day free trial of New Relic Pro. The trial begins once your application starts sending us data, after you’ve followed your language specific installation instructions (located to the left).
FREE Server Monitoring
Any New Relic account comes with Server Monitoring, free of charge.
Server Monitoring instructionsSkip to: