| title | tags | metaDescription | redirects | freshnessValidatedDate | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Remove applications from New Relic |
|
Learn how to stop an application from sending data to New Relic, and how to remove it from the UI. |
|
never |
Applications are automatically removed from New Relic after 93 days without sending data to our platform. You can also remove an application using the UI, once it has stopped sending data. Key metrics will continue to be available via the New Relic REST API, with the application name remaining reserved.
For more information, see our data retention guidelines.
Before attempting to remove an app monitored by New Relic , , or from the UI, keep in mind:
- You can downgrade your New Relic organization to pay less or make it entirely free.
- The ability to remove an app from the UI may be dependent on permissions.
- If an agent is still sending data from an app, you cannot remove that app.
Before you can remove an application monitored by New Relic APM, browser monitoring, or mobile monitoring, the app must first stop reporting data. Do this by disabling the agent (explained below) or by uninstalling the agent completely.
1. Disable an APM agent using these instructions: * [**Go**](/docs/agents/go-agent/instrumentation/go-agent-configuration#enabled): Set `Enabled` to `false`. * [**Java**](/docs/agents/java-agent/configuration/java-agent-configuration-config-file#cfg-agent_enabled): Set `agent_enabled` to `false`. * [**.NET**](/docs/agents/net-agent/installation-configuration/net-agent-configuration#app-cfg-agent-enabled): Set `Newrelic.AgentEnabled` to `false`. * [**Node.js**](/docs/agents/nodejs-agent/installation-configuration/nodejs-agent-configuration#enabled): Set `agent_enabled` to `false`. * [**PHP**](/docs/agents/php-agent/configuration/php-agent-configuration#inivar-enabled): Remove or disable both the `newrelic.so` and [`newrelic-daemon`](/docs/agents/php-agent/getting-started/new-relic-daemon-processes) components. Set `newrelic.enabled` to `false`. * [**Python**](/docs/agents/python-agent/installation-configuration/python-agent-configuration#monitor_mode): Set `monitor_mode` to `false`. * [**Ruby**](/docs/agents/ruby-agent/installation-configuration/ruby-agent-configuration#agent_enabled): Set `agent_enabled` to `false`. 2. Restart the application server and wait up to ten minutes. Verify the color-coded [health status](/docs/accounts-partnerships/education/getting-started-new-relic/glossary#health-status) for the app has turned to gray and is no longer reporting data. 3. To remove the APM application from the UI (and any [associated apps in browser monitoring](/docs/browser/browser-monitoring/installation/install-browser-monitoring-agent/#select-apm-app)), use the following steps: * **Delete the app from the UI.** Go to **[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > APM & services > (select an app/service) > Settings > Application**, and click the **Delete application** button.<Collapser id="remove-browser-apps" title="Browser"
If you've used the [copy/paste method to install the browser agent](/docs/browser/new-relic-browser/installation/install-new-relic-browser-agent#copy-paste-app), remove the JavaScript snippet from your application's pages.
After 93 days, that app will be removed from the UI. If you want to remove it sooner than that, you have several options:
* <DoNotTranslate>**Delete an associated APM app.**</DoNotTranslate> If your browser app is [linked to an APM application](/docs/browser/browser-monitoring/installation/install-browser-monitoring-agent/#select-apm-app), deleting the APM application also removes the browser application. See the [instructions for deleting an APM app](#remove-apm-apps).
* <DoNotTranslate>**Delete it from the UI.**</DoNotTranslate> Go to <DoNotTranslate>**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Browser > (select an app) > Settings > Application settings**</DoNotTranslate>, and click the <DoNotTranslate>**Delete application**</DoNotTranslate> button.
<Collapser id="remove-mobile-apps" title="Mobile"
Remove all references/dependencies to New Relic's mobile monitoring SDK/frameworks, then rebuild the application. For more information, see the [iOS](/docs/mobile-monitoring/new-relic-mobile-ios/installation) and [Android](/docs/mobile-monitoring/new-relic-mobile-android/install-configure) install docs.
After 93 days, the app will be removed from the UI. If you want to remove it sooner than that, you have several options:
* <DoNotTranslate>**Remove it using the UI.**</DoNotTranslate> Go to <DoNotTranslate>**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Mobile > (select an app) > Settings > Application**</DoNotTranslate>, and click <DoNotTranslate>**Delete application**</DoNotTranslate>.
* <DoNotTranslate>**Use NerdGraph to delete an entity.**</DoNotTranslate> If you've done the above and are still seeing that app in the UI, you can [use NerdGraph to delete the relevant entities](/docs/apis/nerdgraph/examples/nerdgraph-entities-api-tutorial/#delete-entities). For how to find entity IDs, see [Entities](/docs/new-relic-one/use-new-relic-one/core-concepts/what-entity-new-relic/#find).
If you have problems removing an app, here are some possible causes and suggested solutions:
If you don't have relevant [permissions](/docs/accounts/accounts-billing/account-structure/factors-affecting-access-features-data), you won't be able to remove an application.<Collapser id="wait-longer" title="You have not waited long enough"
All app data must stop reporting to New Relic before you can remove that entity from New Relic. In most cases, this takes between 10-15 minutes. In rare cases, it can take between 12-24 hours.
<Collapser id="agents-not-disabled" title="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 <DoNotTranslate>**all**</DoNotTranslate> of the agents associated with that entity.
<Collapser id="php-issues" title="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. For more information, see [New Relic daemon processes](/docs/agents/php-agent/getting-started/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](/docs/agents/php-agent/configuration/php-agent-configuration#inivar-appname).
<Collapser id="name-confusion" title="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](/docs/agents/manage-apm-agents/app-naming/rename-your-application). 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 <DoNotTranslate>**[one.newrelic.com](https://one.newrelic.com/all-capabilities)**</DoNotTranslate>, select <DoNotTranslate>**APM**</DoNotTranslate>, then select an application.
2. Scroll down to <DoNotTranslate>**Settings**</DoNotTranslate> and select <DoNotTranslate>**Application.**</DoNotTranslate>
3. Compare the name in the <DoNotTranslate>**Application alias**</DoNotTranslate> field to the name in the <DoNotTranslate>**Your application still reports as**</DoNotTranslate> message directly beneath it.
To get host information about an app you are not familiar with:
4. From <DoNotTranslate>**[one.newrelic.com](https://one.newrelic.com/all-capabilities)**</DoNotTranslate>, select <DoNotTranslate>**APM**</DoNotTranslate>, then select an application.
5. From the summary view, review the <DoNotTranslate>**Servers**</DoNotTranslate> list.
Once you have identified where app data is coming from, you can remove the app from New Relic.
<Collapser id="browser-reporting" title="Browser data is still reporting"
To remove an app from New Relic, all data must have stopped reporting, including browser monitoring data. To verify that you have disabled or uninstalled the APM agent associated with the app:
1. Ensure that [browser monitoring is disabled](/docs/browser/new-relic-browser/installation-configuration/browser-settings-ui-options-browser-monitoring#disabling).
* If your browser monitoring script is inserted by the APM agent, turn it off from inside the UI, in the agent's config file, or in both.
* If you copied and pasted the monitoring JavaScript snippet in certain pages, remove that JavaScript snippet 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 [NRQL query](/docs/query-data/nrql-new-relic-query-language/getting-started/introduction-nrql):
```sql
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. Wait until those caches clear. If your app has internal users, you may be able to identify the users and clear those caches.