Knowledge Base: How do I add/remove hosts?

To add a host for monitoring, install the agent and start up your application. The host running the application will be identified to RPM and will automatically appear on the RPM site after a few minutes.

To remove a host, uninstall the agent, or disable it by editing or removing the newrelic.yml configuration file. Make sure that all application server instances (Passenger, mongrel, Jetty, etc.) have been fully restarted after disabling the agent.

Occasionally, rogue application server processes will linger on and continue reporting data. This can cause a problem when moving hosts when at the maximum host limit for your subscription; the old host holds the last license and prevents the new one from connecting. In this case, an error message like this may appear in your newrelic_agent.log file:

ERROR : You have exceeded your maximum host limit for this account of 1 host. Hosts with licenses currently assigned to them: production01.example.com

Once all reporting applications are shut down on the old host, it may take up to 10 minutes for the old host to disappear from the RPM site and the new one to show up.