Node.js Troubleshooting Framework Install

Once you’ve installed the Node agent, you should see data reporting within a few minutes. If you’re having trouble, these are the steps that our support teams take to troubleshoot, and we hope they will help you find and resolve the issue quickly.

  1. Confirm the app is receiving traffic, has been for at least 5 min, and continues to receive traffic during troubleshooting

  2. Run the Diagnostics CLI to collect data then validate the following…

    1. Confirm Node.js and NPM version meets requirements.
    2. Verify host information meets requirements.
    3. Verify the existence of newrelic module in the package.json/package-lock.json
    4. Check top level npm ls dependencies for newrelic module.
    5. Check if the newrelic.js file is copied to the root directory of the application as described in step 3 of our install documentation.
    6. Ensure configuration is valid with a license key and app name.
    7. Check for the existence of agent logs in default path.
    8. Check that agent can connect to the New Relic collector.
    9. Verify agent isn’t an EOL version.
    10. Check for a “reporting to” line in the logs.
    11. Check for High Security Mode configuration mismatches
  3. If there are no logs in the root directory of the application, ensure that the log file path wasn’t changed and that logs are enabled in the agent configuration.

  4. Ensure your application is using a supported Node.js framework.

  5. Check New Relic ENV variables for the application to see if any configuration is being set via ENV variables.

  6. Confirm the set application name is the expected one.

  7. Run npm install newrelic --loglevel=silly to check for and fix any errors shown.

    • It is most common to see an issue with the optional Native Metrics Module (NMM) that comes bundled with the agent. It supplies metrics to the NodeVM page. Requirements and extra troubleshooting for this module can be found in our Node VM documentation.

    • A common error message is with node-gyp needing python.

    • Another common one is needing xcode on a Mac.

  8. Check you are using a package manager other than NPM (Ex: yarn). If you are, try and get the most verbose install logs you can find for that package manager (Ex: yarn install --verbose). Check for errors in the install logs.

  9. Check trace level agent logs for network issues.

    • Ensure your network is not blocking the ranges listed in New Relic’s Network info
    • If you are using a proxy, ensure proxy info is in the agent configuration.
  10. If using a containerized environment, make sure you installed the agent in the container itself.

  11. If you are using Lambda, review our Lambda documentation.

  12. If you are still unable to resolve the issue please reach out to New Relic Global Technical Support by going to Please be sure to mention, in as much detail as possible, the steps you have tried already and details of what you expect to see and what you are seeing.