New Relic

Send your event data from RudderStack to New Relic.

New Relic is a leading observability platform that lets you monitor, debug, and enhance your tech stack.

RudderStack supports New Relic as a destination to which you can seamlessly send your event data.

info
Find the open source code for this destination in the GitHub repository.

Getting started

Before configuring New Relic as a destination in RudderStack, verify if the source platform is supported by New Relic by referring to the table below:

Connection ModeWebMobileServer
Device mode---
Cloud modeSupportedSupportedSupported
info
To learn more about the difference between cloud mode and device mode in RudderStack, refer to the RudderStack Connection Modes guide.

Once you have confirmed that the source platform supports sending events to New Relic, follow these steps:

  1. From your RudderStack dashboard, add a source. Then, from the list of destinations, select New Relic.
  2. Assign a name to the destination and click Continue.

Connection settings

To successfully configure New Relic as a destination, you will need to configure the following settings:

New Relic connection settings
info
For more information on finding the account ID based on your New Relic user model, refer to the FAQ section below.
  • Insert Key: Enter your New Relic insert key.
info
For more information on getting your New Relic insert key, refer to the FAQ section below.
  • Data Center: Choose the data center associated with your New Relic account. By default, it is set to US.
  • Custom Default Event Type: Use this field to define any custom eventType for any unmapped track calls. By default, RudderStack sets the eventType as rudderstack.
  • Send Device Context: If this setting is enabled, RudderStack flattens all contextual fields delimited by a period (.) before sending them to New Relic.
success
Enabling this setting is recommended as getting rich device context is very useful in New Relic.
  • Send User ID and Anonymous ID: Enable this option to send userId and anonymousId in your events to New Relic.

Track

The track method lets you capture user events along with the properties associated with them.

RudderStack uses the track calls to send custom events to New Relic via the Event API.

A sample track call is shown below:

rudderanalytics.track(
  "Email Opened", {
    subject: "Resume validation",
    sendtime: "2022-01-01",
    sendlocation: "alex@example.com"
  }, {
    context: {
      traits: {
        email: "alex@example.com"
      }
    }
  }
);

RudderStack applies the following rules to the event properties before sending them to New Relic:

FAQ

Where can I find the New Relic account ID?

To find the New Relic account ID, log into your New Relic dashboard.

Depending on your user model, the steps are listed below:

  • New Relic One user model: In the top right section of the dashboard, go to your account settings and navigate to Administration > Organization and access > Accounts. You can find your account ID here.
  • Original user model: In the top right section of your New Relic dashboard, go to your account settings and click API keys. Your account ID will be displayed here.

Where can I find the New Relic insert key?

To find your New Relic insert key, follow these steps:

  1. Log into your New Relic dashboard.
  2. Go to API Keys.
  3. Find the key of type INGEST-LICENSE (used as insert key):
New Relic insert key

Questions? Contact us by email or on Slack