Troubleshooting Browser instrumentation in Node.js

Problem

If you have problems instrumenting New Relic Browser via your New Relic Node.js agent , follow the standard troubleshooting procedures. Here are some additional tips for Node.js.

Solution

Error codes will automatically appear in the site source code and in your Node.js agent logs. Search for NREUM to find these codes.

Error code Description
0 Browser monitoring has been explicitly disabled. This was done either in the newrelic.js or with an environment variable. (NEW_RELIC_BROWSER_MONITOR_ENABLE defaults to true.)
1 The Browser agent was called outside of a web transaction. This may occur if you tried to generate the Browser data once and then cache it, or if you called it in a background task.
2 Something unexpected occurred.
3 The transaction is unnamed. If you are not using Express or Restify and you did not explicitly name the transaction, this error appears. This is to avoid rolling the transaction name into /*. For more information, see naming your transactions.
4

The Node.js agent has not yet done a "handshake" with the collector. The app was started and a user hit the site before the collector could talk to the agent. This may occur because:

  • The browser page loaded before the agent made its initial connection to New Relic.
  • The license key is invalid.
  • Some other problem occurred that would prevent the application ID from being available.

If these errors persist longer than 1 minute, check your license key. Otherwise, the errors should disappear on their own.

5 Browser monitoring has been disabled on the collector side. For example, the collector did not return enough data for Browser to be enabled. This is a collector issue, because server-side configuration for Node.js currently is not available.

For more help

Additional documentation resources include:

Join the discussion about Node.js monitoring in the New Relic Online Technical Community! The Technical Community is a public platform to discuss and troubleshoot your New Relic toolset.

If you need additional help, get support at support.newrelic.com.