# NewRelic

## About the integration

New Relic One is an observability platform built to help engineers create more perfect software. From monoliths to serverless, you can instrument everything, then analyze, troubleshoot, and optimize your entire software stack. Before you start, you should already have a NewRelic account and your environment setup and running. If not, head over to NewRelic to get things started. Once you're done, return to Sleuth so you can complete setup of the integration.

## Setting up the integration

To add the Sleuth NewRelic integration:

* Click **Integrations** in the sidebar.
* Click the *Metric Trackers* tab, then **enable** in the NewRelic card.
* Enter your NewRelic User key and account ID in the corresponding fields.
* If your NewRelic servers' are in the EU, enable the *My New Relic servers are in EU* checkbox. Leave this unchecked if you are unsure.
* Press **Save**.

{% hint style="info" %}
The NewRelic User key and account ID can be found under **Preferences > API Keys**, as shown below. Or, you can click on the **generate** link, which will take you directly to the API Keys page in your NewRelic console, where you can then generate the keys Sleuth needs to complete the integration.
{% endhint %}

![](https://2832637360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1bR_-Od0islbiOl4G0%2Fuploads%2Fgit-blob-07e310143b7fdcce1a1d9bad717865b4e2b024d4%2FAPI%20keys%20%3C%20New%20Relic%20One%202021-01-26%2013-30-08.png?alt=media)

![](https://2832637360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1bR_-Od0islbiOl4G0%2Fuploads%2Fgit-blob-3be3eba6af2cf4e9b3be247e4c86180e17a61651%2FIntegrations%20-%20Sleuth%202021-01-26%2013-31-09.png?alt=media)

* Once the NewRelic integration is successful, you will see **NewRelic enabled** displayed in the integration card (as shown below).

![](https://2832637360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1bR_-Od0islbiOl4G0%2Fuploads%2Fgit-blob-0d150f6849e7b77c389d7e87037f7dd8b0166c06%2FIntegrations%20-%20Sleuth%202021-01-26%2013-32-34.png?alt=media)

## Configuring the integration

* Click \*\*Add metric \*\*and select a Sleuth project that will collect the metrics NewRelic generates. All projects within your organization will be displayed in the dropdown.

![](https://2832637360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M1bR_-Od0islbiOl4G0%2Fuploads%2Fgit-blob-d8d2d0ca07a25ff609b68d3786d88796002f2f58%2FIntegrations%20-%20Sleuth%202021-01-26%2013-34-10.png?alt=media)

{% hint style="info" %}
Integrations are made at the Sleuth organization level, and are available for all projects within that organization. Individual settings for an integration are made at the project level.
{% endhint %}

That's it! Sleuth will now start verifying your deploys health by tracking the values from your NewRelic metric. Head over to the Dashboard to start seeing your data in action in the project and deploy health graphs.

## Removing the integration

#### To dissolve the **NewRelic** integration for the organization:

1. Click on **Integrations** in the left sidebar, then on **Metric Trackers**.
2. In the NewRelic integration card, click **disable**.

The NewRelic integration is disconnected and no longer available to any projects within that organization. Any project-level modifications you made to the NewRelic integration will be lost.