Troubleshoot your Node.js installation

To minimize the amount of bandwidth the Node.js agent consumes, New Relic only reports data once per minute. If you add the agent to tests that take less than a minute to run, it will not have time to report data to New Relic.

If you do not see transaction traces or other data after deploying the agent, this may be due to configuration, framework, or Apdex settings. Use New Relic Diagnostics to try to automatically identify the issue.

The Node.js agent writes its log to the newrelic_agent.log file in the application directory, unless you have changed the logging settings. If the agent does not send data or crashes your app, you can generate a troubleshooting log file to accompany bug reports and support requests.

The agent can collect VM metrics related to garbage collection (GC), memory, and CPU. Some of these metrics require an additional native module to be installed.

Here are some common problems and their solutions:

Problem

During installation, npm shows one of the following error messages:

gyp ERR! configure error
gyp ERR! stack Error: Can't find Python executable "python", you can set the PYTHON env variable.

gyp ERR! build error
gyp ERR! stack Error: not found: make

make: g++: Command not found

Solution

Ensure that the prerequisites for the node-gyp module are installed. On Debian/Ubuntu platforms, use this command:

apt-get install build-essential

For more information, see Node.js VM measurements.