Adding, renaming, and removing hosts

You can add and remove hosts for your applications. You cannot rename an existing host, but you can create applications named after a host or cluster.

Adding hosts

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

Renaming hosts

It is not possible to change the host name. However, you can create applications named after a host or cluster. For example, if hosts ey01-s00057 and ey01-s00058 are both part of a production tier, you can create an application called "App - Production" and have those two hosts report to it.

Removing hosts

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

Occasionally, rogue application server processes will continue reporting data. In this situation your app's "traffic light" status will appear green, even though you shut the agent down and verified that no data is reporting. Check your web server for stray processes, or get support at

Once all reporting applications are shut down on the old host, it may take up to ten minutes for the old host to disappear from the New Relic list and the new one to appear.

For more help

Additional documentation resources include:

  • Connecting hosts to your account (using your agent config file to control which hosts connect to your New Relic account)
  • Security (using your agent config file to define proxy settings, including hosts)

If you need additional help, get support at