Skip to content

Commit

Permalink
Merge pull request #3900 from newrelic/Add-nerdgraph-procedure-to-'de…
Browse files Browse the repository at this point in the history
…lete-app'-instructions

Fix: add nerdgraph task to 'remove apps' docs
  • Loading branch information
zuluecho9 committed Sep 14, 2021
2 parents a7ca458 + 5a33bb6 commit 8d86589
Showing 1 changed file with 22 additions and 28 deletions.
Expand Up @@ -27,22 +27,22 @@ For more information, see [Inactive apps in New Relic One](/docs/new-relic-one/u

## Before attempting to remove an app [#requirements]

Before attempting to remove an APM, browser, or mobile app from the New Relic UI, keep in mind:
Before attempting to remove an app monitored by New Relic APM, browser monitoring, or mobile monitoring from the UI, keep in mind:

* You can [downgrade your account](/docs/accounts/accounts-billing/account-setup/downgradecancel-account) to pay less or make it entirely free.
* To remove an app, you must have a [user role](/docs/accounts/accounts-billing/new-relic-one-pricing-users/users-roles) with that capability.
* If an agent is still sending data from an app, you cannot remove an app.
* The ability to remove an app from the UI may be dependent on [permissions](/docs/accounts/accounts-billing/account-structure/factors-affecting-access-features-data/#user-permissions).
* If an agent is still sending data from an app, you cannot remove that app.

## Remove an application from New Relic [#remove]

Before removing an APM, browser, or mobile application from New Relic, stop the application from sending data either by disabling the agent or by [uninstalling it completely](/docs/agents/manage-apm-agents/installation/uninstall-agent).
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](/docs/agents/manage-apm-agents/installation/uninstall-agent).

<CollapserGroup>
<Collapser
id="remove-apm-apps"
title="APM applications"
>
1. Disable the APM agent:
1. Disable an APM agent using these instructions:
* [**C SDK**](/docs/agents/c-sdk/install-configure/uninstall-remove-c-sdk#disable): Do a quick recompile and deploy. For example, surround your instrumentation in `#ifdef`, and set the value of `YOURNAMESPACE_NEWRELIC_ENABLED` with your build system.
* [**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`.
Expand All @@ -51,40 +51,34 @@ Before removing an APM, browser, or mobile application from New Relic, stop the
* [**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](https://github.com/newrelic/go-agent/blob/master/GUIDE.md#config-and-application) 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 and any browser applications linked to it, you have two options:
* Click the **Delete application** button on the APM application/service's **Settings** page. Go to **[one.newrelic.com](https://one.newrelic.com) > APM > (select an app/service) > Settings > Application**.
* Or, call the [`/applications/delete`](https://rpm.newrelic.com/api/explore/applications/delete) endpoint of the New Relic REST API. For example:

```
curl -X DELETE 'https://api.newrelic.com/v2/applications/<a href="/docs/apis/rest-api-v2/application-examples-v2/list-your-app-id-metric-timeslice-data-v2"><var>YOUR_APP_ID</var></a>.json' \
-H 'X-Api-Key:<a href="/docs/apis/get-started/intro-apis/types-new-relic-api-keys#personal-api-key"><var>YOUR_API_KEY</var></a>' -i
```
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)), you have a few options:
* **Delete the app from the UI.** Go to **[one.newrelic.com](https://one.newrelic.com) > APM > (select an app/service) > Settings > Application**, and click the **Delete application** button.
* **Use NerdGraph to delete an entity.** 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).
</Collapser>

<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, the application will be removed from New Relic.

<Callout variant="tip">
If browser data continues to be reported, see our [suggestions](#browser-reporting) below.
</Callout>
* Once your browser application has stopped reporting, you have two ways to remove it:
* If your browser application is linked to an APM application, deleting the APM application also removes the browser application. See the instructions for deleting an APM application/service above for details.
* Or, click the **Delete application** button on the browser application's **Application settings** page. Go to **[one.newrelic.com](https://one.newrelic.com) > Browser > (select an app) > Settings > Application settings **.
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:
* **Delete an associated APM app.** 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).
* **Delete it from the UI.** Go to **[one.newrelic.com](https://one.newrelic.com) > Browser > (select an app) > Settings > Application settings**, and click the **Delete application** button.
* **Use NerdGraph to delete an entity.** 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).

</Collapser>

<Collapser
id="remove-mobile-apps"
title="Mobile"
>
* Remove all references/dependencies to the New Relic's mobile 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.
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 application will be removed from New Relic.
* Or, once your mobile application has stopped reporting, you can also remove it manually:
* Click the **Delete application** button on the mobile application's **Settings** page. Go to **[one.newrelic.com](https://one.newrelic.com) > Mobile > (select an app) > Settings > Application **.
After 93 days, the app will be removed from the UI. If you want to remove it sooner than that, you have several options:
* **Remove it using the UI.** Go to **[one.newrelic.com](https://one.newrelic.com) > Mobile > (select an app) > Settings > Application**, and click **Delete application**.
* **Use NerdGraph to delete an entity.** 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).
</Collapser>
</CollapserGroup>

Expand All @@ -95,9 +89,9 @@ If you have problems removing an app, here are some possible causes and suggeste
<CollapserGroup>
<Collapser
id="not-owner-admin"
title="You are not an admin on your full user account"
title="You lack permissions"
>
If you don't have proper permissions, you won't be able to remove an application.
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>

<Collapser
Expand Down

0 comments on commit 8d86589

Please sign in to comment.