Node.js

Node.js is a server-side framework based on the V8 JavaScript engine by Google. Node.js has an asynchronous execution model and is frequently used for gluing or as a proxy tier within enterprise environments.

Capabilities

Dynatrace provides extensive Node.js monitoring capabilities:

  • Heap and process metrics
  • Heap dumps
  • CPU sampling (see known limitations)
  • Event loop metrics
  • Insights into inbound and outbound HTTP calls
  • Dedicated support for a variety of databases (includes query capture)
  • OneAgent SDK for custom tracing

See our supported technologies matrix for details about supported technologies that will be used in conjunction with Node.js.

Support & desupport

Node.js follows an LTS release model.

Each odd-numbered version reaches EOL shortly after each new even-numbered version is released. Each even-numbered version eventually becomes an LTS release. For enterprise production environments, we recommended that you stick to LTS releases.

Whenever a new Node.js major version (even or uneven) is released, we add support for that version.

Dynatrace will follow this support model, but will support each Node.js version at least half a year longer to give our customers time for upgrades.

Node.js version Vendor released Vendor EOL Supported by Dynatrace until Last supported OneAgent Version
0.10 Mar 11, 2013 Oct 31, 2016 Oct 2017 1.129
0.12 Feb 6, 2015 Dec 31, 2016 Oct 2017 1.129
4 Sep 8, 2015 Apr 31, 2018 Dec 2018 1.157
5 Oct 29, 2015 Jun 30, 2016 Oct 2017 1.129
6 Apr 26, 2016 Apr 2019 Oct 2019
7 Oct 25, 2016 Jun 30, 2017 Nov 2017 1.131
8 May 30, 2017 Dec 2019 Jun 2020
9 Oct 1, 2017 Jun 30, 2018 Dec 2018 1.157
10 Apr 24, 2018 Apr 2021 Oct 2021
11 Oct 23, 2018 Jun 2019 Dec 2019

Known limitations

  • Due to platform limitations of JavaScript and Node.js, code-level visibility is limited compared to .NET or Java.

  • In conjunction with unsupported third-party modules, context can be lost in asynchronous callbacks. In such cases, please contact support.

  • Google V8 is affected by a series of memory and CPU overhead issues, which is a blocker for production-level background CPU profiling. Therefore, CPU profiling will be disabled in the future. For now, if you run into this issue, please disable it in the deep monitoring settings.

  • Ambient sampling is disabled by default as of OneAgent version 1.157
    Node.js version 4 is not supported due to sporadic crashes.

    Linux:
    Ambient sampling can be enabled for the following Node.js versions:

    • Node.js version 6
    • Node.js versions ^8.9.4 (8.9.4 <= node.js < 9.0.0)
    • Node.js version 9.3.0 or later

    Windows:
    Ambient sampling is disabled by default because it causes 100% CPU usage for one CPU.

    OneAgent records a log entry for each unsupported version it detects:
    AmbientSampling: <unsupported platform> / <node version>

Further reading