Remove applications from the New Relic UI

Owner, Admins, or Add-on Managers

You must be an Owner, Admin, or APM add-on manager on your account to remove an application. Also, if a New Relic agent is still sending data, you cannot remove your app from the user interface.

Removing an application will cause you to lose all associated historical data.

Remove an app

To remove an application from the New Relic user interface:

  1. Stop the New Relic agent from sending data either by disabling it or by uninstalling it completely. To disable the agent without uninstalling it:

    • Go: Set Enabled to false.
    • Java: Set agent_enabled to false.
    • .NET: Set Newrelic.AgentEnabled to false.
    • Node.js: Set agent_enabled to false.
    • PHP: Remove or disable both the newrelic.so and newrelic-daemon components. Set newrelic.enabled to false.
    • Python: Set monitor_mode to false.
    • Ruby: Set agent_enabled to false.
  2. Restart the application server.
  3. Wait up to ten minutes, then verify the color-coded health status for the app has turned to gray and is no longer reporting data.
  4. Owners, Admins, or APM add-on manager: To delete the app after you have verified that no data is being reported: From rpm.newrelic.com, select APM.
  5. From the Applications index, select the app's gear gear icon, then select trash Delete app.

Troubleshooting

If you have problems removing an app from the New Relic UI, here are some possible causes and suggested solutions:

You are not an Owner or Admin on your account.

If you are not an Owner, Admin, or APM add-on manager on your account, the Delete app option will not be available. Contact your New Relic account's Owner or an Admin to have the app removed.

You have not waited long enough.

All app data must stop reporting to New Relic before you can remove that entity from the New Relic UI. In most cases, this takes between 10-15 minutes. In rare cases, it can take a few minutes longer.

Not all agents are disabled.

If you have multiple agents reporting data under the same UI name, then you must make sure you disable or uninstall all of the agents associated with that entity.

You have problems removing your PHP app.

If you have a PHP app and aren't able to remove it from the UI, possible causes include:

  • You have not disabled both components of the PHP agent. You must stop or uninstall both newrelic.so and newrelic-daemon in order to be able to remove a PHP app from the UI. For more information, see New Relic daemon processes.
  • You have set up per-directory monitoring of your PHP app, and unexpected PHP data is reporting as the default PHP application in the New Relic UI. To fix this, change the default app name in the PHP agent config.
You don't know where the app's data is coming from.

If you don't know where an app's data is coming from, it may be because the app's name has been changed. When an app name is changed in the UI, it does not change the underlying app name being reported; it only changes how the app name appears in the UI.

To see if there is a difference between the reported name and the displayed name:

  1. From rpm.newrelic.com, select APM > Applications, then select the app's gear gear icon.
  2. Select Change settings.
  3. Compare the name in the Name field to the name in the Your application still reports as message directly beneath it.

To get host information about an app you are not familiar with:

  1. From rpm.newrelic.com, select APM > Applications > (selected app).
  2. From the selected app's Overview page, review the Servers list.

Once you have identified where app data is coming from, you can remove the app from the New Relic UI.

Browser data is still reporting.

To remove an app from the UI, all data must have stopped reporting, including New Relic Browser data. To verify that you have disabled or uninstalled the APM agent associated with the app:

  1. Ensure that Browser monitoring is disabled.
    • If your Browser script is inserted by the New Relic APM agent, turn it off from inside the UI, in the agent's config file, or in both.
    • If you copied and pasted the Browser JavaScript in certain pages, remove that JavaScript manually.
  2. Ensure all caches have been cleared that the application uses, such as host caches, CDNs, or anything else that caches built pages.
  3. Optional: To see a count of how many page views report from each domain, use this Insights query:

    SELECT count(*) FROM PageView WHERE appName = 'YOUR_BROWSER_APP_NAME' FACET domain

If these steps don't resolve the issue, it is likely due to an end-user's browser cache that hasn't yet cleared. You must wait until those caches clear. If your app has internal users, you may be able to identify the users and clear those caches.

For more help

Recommendations for learning more: