Uninstall integrations

Uninstalling the agent does not directly affect any of your Infrastructure Integrations: if you uninstall the agent, your integrations will remain. Similarly, if you disable or uninstall your integrations, the Infrastructure agent will remain.

To uninstall any of your integrations, follow the procedure corresponding to the type of integration.

Cloud integrations

AWS

You can disable Infrastructure AWS integrations and still retain the connection between your AWS account and New Relic Infrastructure. We recommend not to disable your EC2 and EBS integrations because those add important metadata to your New Relic Infrastructure data.

If you want to... Do this
Disable one or more AWS service integrations

To disable services while keeping your AWS account linked to New Relic Infrastructure:

  1. From infrastructure.newrelic.com, select Integrations > Amazon Web Services > Manage services.
  2. From your Edit AWS account page, clear the checkbox for each active service you want to disable.
  3. Save your changes.

To disconnect your AWS account completely from New Relic Infrastructure, you need to unlink your AWS account. This disables all New Relic integrations associated with that AWS account.

  1. Go to infrastructure.newrelic.com > Integrations > Amazon Web Services > Manage services.
  2. From your Edit AWS account page, select Unlink this account.
  3. Save your changes.
  4. Sign in to AWS and select Services > IAM > Roles.
  5. Select the checkbox for the role you want to delete, then select Role Actions > Delete Role.

Unlinking your AWS account will disable the trust relationship set up via your ARN.

Azure
If you want to... Do this
Disable one or more Azure service integrations

To disable services while keeping your Azure account linked to New Relic Infrastructure:

  1. From infrastructure.newrelic.com, select Integrations > Microsoft Azure > Manage services.
  2. From your Edit Azure account page, clear the checkbox for each active service you want to disable.
  3. Save your changes.

To disconnect your Azure account completely from New Relic Infrastructure, you need to unlink your Azure account. This requires being either the user who registered the app or an administrator. This procedure will disable all New Relic integrations associated with that Azure account.

  1. Go to infrastructure.newrelic.com > Integrations > Microsoft Azure > Manage services.
  2. From your Edit Azure account page, select Unlink this account.
  3. Save your changes.
  4. Sign in to Azure and go into All Services > Identity > App registrations, or go to Azure Active Directory service and select App registrations.

  5. Find the registered app (the recommended name is NewRelic-Integrations). To see the full list of available apps, select the dropdown menu beside the search field and select All apps.
  6. Select the app and, on the panel that opens, select Delete.
Google Cloud Platform (GCP)
If you want to... Do this
Disable one or more GCP service integrations

To disable services while keeping your GCP account linked to New Relic Infrastructure:

  1. From infrastructure.newrelic.com, select Integrations > Google Cloud Platform > Manage services.
  2. From your Edit GCP account page, clear the checkbox for each active service you want to disable.
  3. Save your changes.

To disconnect your GCP account completely from New Relic Infrastructure, you need to unlink your GCP account. This disables all New Relic integrations associated with that GCP account.

If you registered the GCP project using a User account, follow these steps.

  1. Go to infrastructure.newrelic.com > Integrations > Google Cloud Platform > Manage services.
  2. From your Edit GCP account page, select Unlink this account.
  3. Save your changes.

If you registered the GCP project using a Service account, follow these steps. If you are deleting a custom role, be aware that this role may be used for other purposes besides New Relic access.

  1. Sign in to New Relic and go to Infrastructure > Integrations > Google Cloud Platform.
  2. For a standard (non-custom) user role, select Manage Services for the account you want to remove. Copy the value of User and save it.

    OR

    For a custom user role, go to IAM > admin > Roles, search for the role, select it, and select DELETE. You are now finished and can skip the remaining steps.

  3. Standard (non-custom) user role: Sign in to Google Cloud and select the correct project in the Select a project box.
  4. From the navigation menu, select IAM & admin > IAM.
  5. Search for and select the user value you saved, then select REMOVE.

On-host integrations

If you used the integrations package, see the integrations package instructions.

Apache
Package manager Uninstall instructions
apt (Debian or Ubuntu) sudo apt-get remove nri-apache
yum (Amazon Linux, CentOS, or RHEL) sudo yum remove nri-apache
zypper (SLES) sudo zypper -n remove nri-apache
Cassandra
Package manager Uninstall instructions
apt (Debian or Ubuntu) sudo apt-get remove nri-cassandra
yum (Amazon Linux, CentOS, or RHEL) sudo yum remove nri-cassandra
zypper (SLES) sudo zypper -n remove nri-cassandra
Kubernetes

Each cluster will have a single node where kubectl is running. To uninstall the Kubernetes integration, use the following command on each of these nodes:

kubectl delete -f newrelic-infrastructure-k8s-latest.yaml
MySQL
Package manager Uninstall instructions
apt (Debian or Ubuntu) sudo apt-get remove nri-mysql
yum (Amazon Linux, CentOS, or RHEL) sudo yum remove nri-mysql
zypper (SLES) sudo zypper -n remove nri-mysql
NGINX
Package manager Uninstall instructions
apt (Debian or Ubuntu) sudo apt-get remove nri-nginx
yum (Amazon Linux, CentOS, or RHEL) sudo yum remove nri-nginx
zypper (SLES) sudo zypper -n remove nri-nginx
Redis
Package manager Uninstall instructions
apt (Debian or Ubuntu) sudo apt-get remove nri-redis
yum (Amazon Linux, CentOS, or RHEL) sudo yum remove nri-redis
zypper (SLES) sudo zypper -n remove nri-redis
StatsD
  1. cd /path/to/statsd
  2. npm uninstall @newrelic/statsd-infra-backend
  3. From the StatsD config.js, remove the "@newrelic/statsd-infra-backend" entry from the list of backends.
  4. Restart StatsD.

Moving away from the integrations package

While it is still possible to use the integrations package, we recommend removing it completely and working with integrations on an individual basis.

The last integration package contains the following versions of the integrations:

  • Apache 1.1.2
  • Cassandra 2.0.3
  • MySQL 1.1.5
  • Nginx 1.0.2
  • Redis 1.0.1

If you remove the integrations package and want to continue using the related on-host integrations, you will need to install them one by one. To uninstall the package and re-install your integrations:

  1. Remove the integrations package by following these instructions. The config files from the old integrations will not be deleted, so you won’t have to configure them again.
    Uninstall package
    Package manager Uninstall instructions
    apt (Debian or Ubuntu)
    1. sudo apt-get remove newrelic-infra-integrations
    2. sudo apt-get autoremove
    yum (Amazon Linux, CentOS, or RHEL)
    1. sudo yum remove newrelic-infra-integrations
    2. sudo yum autoremove
    zypper (SLES)
    sudo zypper -n remove newrelic-infra-integrations --clean-deps
  2. Install your integrations one by one following these instructions. To replicate the integrations package, you will need to install all the available integrations again.

For more help

Recommendations for learning more: