New Relic's Node.js agent is publicly available on the Node Package Manager (npm) repository as well as on New Relic's GitHub repo for Node.js. Before you install the Node.js agent, make sure your application meets the following system requirements.
For best performance, New Relic recommends using the latest LTS version of Node.js. New Relic's Node.js agent is tested on and supports the following Node.js versions as noted. Unstable versions of Node.js are not supported.
|6 or higher||
This includes the latest Node.js version.
Supported Node.js frameworks
- Express 4.6.0 or higher
- Connect v1 and v2 (router not supported)
- Koa 2.0.0 or higher (external module loaded with the agent)
If you are using a supported framework with default routers, New Relic's Node.js agent can read these frameworks' route names as-is. However, if you want more specific names than are provided by your framework, you may want to use one or more of the tools New Relic provides with the Node.js transaction naming API.
- Mac OSX 10.7 and higher
- Windows Server 2008 and higher
The Node.js agent monitors the performance of Node.js application calls to these datastores:
- MySQL (via mysql and mysql2 packages)
New Relic collects instance details for a variety of databases and database drivers. The ability to view specific instances and the types of database information in New Relic APM depends on your New Relic agent version.
New Relic's Node.js agent version 1.31.0 or higher supports the following:
||Minimum module version||Minimum agent version|
To request instance-level information from datastores currently not listed for your New Relic agent, get support at support.newrelic.com.
For other message queue libraries, use custom instrumentation.
In general, process managers that handle starting, stopping, and restarting of Node.js (like Forever) should be compatible with the Node.js agent. If you are using PM2, the minimum supported version of PM2 is 2.0.
As a standard security measure for data collection, your app server must support SHA-2 (256-bit). SHA-1 is not supported.
Connect the agent to other New Relic products
The Node.js agent integrates with other New Relic products to give you end-to-end visibility:
|New Relic Infrastructure||When you install the Infrastructure and APM agents on the same host, they automatically detect one another. You can then view a list of hosts in the APM UI, and filter your Infrastructure hosts by APM app in the Infrastructure UI. For more information, see New Relic APM data in Infrastructure.|
|New Relic Insights||The Node.js agent sends default events and attributes to Insights for NRQL queries. You can also record custom events for advanced analysis.|
|New Relic Synthetics||Synthetic transaction traces connect requests from Synthetics monitors to the underlying APM transaction.|