How to: Uninstall the New Relic agent for a Web App
The New Relic agent is a powerful lightweight agent that helps you monitor the performance of your Web Application. Thanks to it you can identify potential problems, measure performance, and deliver a better user experience. So why would you want to uninstall it? Well, in my case I was playing with a bunch of plugins that created a bunch of “apps” out of my main web app. Long term this is desirable as I can measure the performance of my overall deployment but also subsite by subsite I can see how the server is behaving. The only issues is that as I was playing with this functionality I switch the naming of the applications and different plugins created different apps. In one case each subsite had 3 sites: the regular one, the admin one, and I believe an ajax one… too much for me. So at the end of the day like 10 sites, 5 flavors of each…. a nightmare. Now, New Relic won’t let you delete an application that is active and it won’t merge sites… so the only option is to uninstall the New Relic plugin for like an hour so that their site lets you delete your apps.
Uninstalling the agent
Note: Make sure your applications are not reporting any data (their “traffic light” status is gray) before uninstalling the agent.
To remove the Java agent:
- Delete the
newrelicfolder from your app server’s root.
- Delete the New Relic Java options variable from your startup script.
For more information about installation, see New Relic for Java.
To remove the .NET agent:
- Click Start > All Programs > New Relic .NET Agent.
- Click Uninstall the .NET agent.
- Follow the prompts to complete the uninstallation.
This process will leave your
newrelic.config file untouched.
For more information about installation, see New Relic for .NET.
To remove the PHP agent and leave the configuration file intact (in case you want to reinstall the agent), execute the
newrelic-install script (as root):
To fully remove the agent, include the
purge option. This will remove everything from your system:
sudo /usr/bin/newrelic-install purge
To uninstall your Python agent, use one of these methods:
- If installed with PIP:
pip uninstall newrelic/.
- If installed with easy_install:
easy_install -m newrelic.
For more information about installation, see New Relic for Python.
To remove the Ruby agent from your Rails application, remove the
newrelic.yml file from within your
To remove New Relic from your Gemfile:
- Delete this line:
For more information about installation, see New Relic for Ruby.
To uninstall New Relic from your server monitor, use one of these methods as applicable.
|If you are using…||Do this…|
|RedHat and CentOS||Be sure to execute the command as root. For more information about server monitor installation, see RedHat and CentOS.|
|Ubuntu and Debian||Be sure to execute the command as root. For more information about server monitor installation, see Ubuntu and Debian.|
|Windows||For more information about server monitor installation, see Windows.|
|Recommended||Use the Uninstall shortcut that is included in the Windows Start > New Relic Server Monitor folder. Follow the prompts to complete the uninstallation process.|
|Optional||You can also use the command line: