Skip to content
New Relic reporting for React Native
Branch: master
Clone or download
Latest commit 8d1441d Jan 3, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
android upgrade to RN 51 Jan 2, 2018
ios Update iOS header path - RN 0.40 Feb 13, 2017
lib update some really old code Apr 6, 2017
scripts update some really old code Apr 6, 2017
src fixed lint errors Jan 3, 2018
test fix test May 15, 2016
.eslintrc update some really old code Apr 6, 2017
.gitignore Initial Android implementation Jun 29, 2016
.npmignore added .npmignore + version bump May 30, 2016
LICENSE Create LICENSE Apr 6, 2017 Update Apr 7, 2017
index.js rename to RNNewRelic May 3, 2016
package.json 1.1.1 Jan 2, 2018
wallaby.js initial commit May 3, 2016
yarn.lock update some really old code Apr 6, 2017


New Relic event reporting for react native.

also check out


  • overrideConsole will send all console.log, warn and errors to New Relic.
  • reportUncaughtExceptions will send uncaught Javascript exceptions to New Relic.

More to come!


Install react-native-newrelic

npm install react-native-newrelic --save


1. Install New RelicAgent in your project as a pod

In the Podfile for your project, add the following line: pod 'NewRelicAgent' Make sure Xcode is closed and run: pod install

2. Add the project to Xcode

In the project navigator:

  • Right click Libraries
  • Add Files to [your project's name]
  • Go to node_modules/react-native-newrelic
  • Add the .xcodeproj file In the project navigator, select your project.
  • Add the libRNNewRelic.a to your project's Build Phases ➜ Link Binary With Libraries
  • Click .xcodeproj file you added before in the project navigator and go the Build Settings tab. Make sure 'All' is toggled on (instead of 'Basic').

3. In your AppDelegate.m

Add the following:

  NSString* token;
  if(isDebug) {
    token = @"<your new relic dev token (optional)>";
  } else {
    token = @"<your new relic production token";
  [NewRelicAgent startWithApplicationToken:token];

And add the following line to the top of your didFinishLaunchingWithOptions function:

  [self setupNewRelic];

4. Add a prefix header to your iOS project

Add a PrefixHeader.pch file as explained here Your file should look like this:

#ifdef __OBJC__ 

#import <NewRelicAgent/NewRelic.h>


Android (gradle only)

1. Add NewRelic agent to your Android project

This link describes how to add the original NewRelic agent to your project. This guide only requires a part of the original steps (some of the steps are already integrated in react-native-newrelic:

In import Newrelic and override the following method:


public class MainApplication extends Application implements ReactApplication {


public void onCreate() {



Create in your root android dir:

com.newrelic.application_token= yourApplicationToken

Get your application token from

2. Add the react-native-newrelic module to your Android project

In settings.gradle:

include ':react-native-newrelic'
project(':react-native-newrelic').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-newrelic/android')

In your project level build.gradle:

dependencies {
	classpath ""

In your app level build.gradle:

apply plugin: 'newrelic'

dependencies {
	compile project(":react-native-newrelic")
	compile fileTree(dir: "node_modules/react-native-newrelic/android/libs", include: ["*.jar"])

Add new RNNewRelicPackage() to your list of packages in getPackages() in :

public List<ReactPackage> getPackages() {
  return Arrays.<ReactPackage>asList(... new RNNewRelicPackage());


Add the following to your app root (e.g. app.ios.js ):

import {default as newRelic} from 'react-native-newrelic';
  overrideConsole: true,
  reportUncaughtExceptions: true,
    globalAttributes: {
      'this-string': 'will be sent with every event that is being reported'

Credits to @DanielZlotin for the initial version

You can’t perform that action at this time.