• Log inFree account

Monitor your React Native application

With our React Native agent, your team can monitor the performance of its hybrid apps and identify code errors. Our agent collects crash data, network traffic, and other information for hybrid apps using native components. This allows your team to understand the health of your hybrid app regardless of the platform. We empower your team to make more informed development choices by providing insight into Javascript errors, distributed tracing, network instrumentation, and more.

Install the React Native agent


Before you install the React Native agent, ensure your app meets these requirements:

Step one of install

To install the agent:

  1. Run this yarn command:
    yarn add newrelic-react-native-agent
  2. Run the following:
    npm i newrelic-react-native-agent

Step two of install

To set up the React Native agent, you need to start it with index.js. AppToken is platform-specific so you will need to generate the separate token for Android and iOS apps. Open your index.js and add the following code to launch NewRelic:

import NewRelic from 'newrelic-react-native-agent';
import * as appVersion from './package.json';
import {Platform} from 'react-native';
let appToken;
if (Platform.OS === 'ios') {
appToken = '<IOS-APP-TOKEN>';
} else {
appToken = '<ANDROID-APP-TOKEN>';

Step three: Android setup

To ensure that the React Native agent is compatible with Android, install the Android specific agent:

  1. Install the New Relic native Android agent using these instructions .

  2. Update build.gradle:

    buildscript {
    repositories {
    dependencies {
    classpath "com.newrelic.agent.android:agent-gradle-plugin:6.4.1"
  3. Update app/build.gradle:

    apply plugin: "com.android.application"
    apply plugin: 'newrelic' // <-- add this
  4. Make sure your app requests INTERNET and ACCESS_NETWORK_STATE permissions by adding these lines to your AndroidManifest.xml:

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Step four: XCFramework setup

To ensure that the React Native agent is compatible with all iOS frameworks, install the New Relic XCFramework agent:

  1. Install the New Relic XCFramework agent:

    npx pod-install

Optional: Expo integration

Integration with Expo is possible in both bare workflow and custom managed workflow via config plugins.

  • Bare workflow: Please follow the above installation steps instead.
  • Managed workflow: After installing our package, add the config plugin to the plugins array of your app.json or app.config.js.

For the managed work flow, you need to use the expo prebuild --clean command as described in the Adding custom native code guide to rebuild your app with the plugin changes. If this command is not running, you'll get errors when starting the New Relic agent.

Modify and understand your data

API calls

Our React Native agent utilizes the same API calls as our iOS and Android SDK agents. Please refer to New Relic iOS SDK doc or Android SDK.

JavaScript errors

You can see JavaScript errors under the custom events section and you can also query them using NRQL.

This is an image of React Native JavaScript errors recorded under custom events

You can also build a dashboard for errors using this query:

SELECT jsAppVersion,name,Message,errorStack,isFatal FROM `JS Errors` SINCE 24 hours ago

If you need help getting started with dashboards, see Introduction to dashboards.

Copyright © 2022 New Relic Inc.