Support information

Instana follows the official Long-term support (LTS) and end-of-life (EOL) timeline from Node.js for monitoring Node.js.

When a Node.js version reaches its EOL date, it is offered to receive at least one year of additional support. To avoid potential issues, update your Node.js version regularly.

The Instana Node.js collector sends an issue event when applications are running under an EOL version of Node.js.

The support for the following items is discontinued. For more information about version 5 breaking changes, see GitHub changelog.

• Node.js versions earlier to 18.19.0 are no longer supported. You must upgrade to Node.js 18.19.0 or later.

• The legacy ESM support that uses --experimental-loader and esm-loader.mjs is removed. Ensure that you use --import with esm-register.mjs in your collector initialization script. For more information, see Collector installation – ECMAScript.

• The environment variables INSTANA_DISABLED_TRACERS and INSTANA_DISABLE_TRACING, and the configuration option tracing.disabledTracers are removed. Update your configuration to use INSTANA_TRACING_DISABLE and tracing.disable instead. For more information, see Disabling all tracing.

• The support for the kafka-avro package is discontinued. For more information, see kafka-avro.

• The support for AWS SDK v2 is deprecated. For more information, see AWS SDK v2 and AWS SDK for JavaScript v3.

• In Instana AutoTrace webhook, the autotrace.nodejs.application_type configuration option no longer supports the legacy module_v1 value. Use module_v2 instead. For more information, see the Node.js ECMAScript modules section.

The support for the following technologies is discontinued. For more information about version 3 breaking changes, see GitHub changelog.

• The support for Node.js 14 and 16 is discontinued. You must upgrade to Node.js 18.0.0 or later.

• The support for Node.js Lambda runtimes v14 and v16 is discontinued.

• The option to configure the Kafka header format is removed, and headers are now sent in the string format, which eliminates support for the binary format. Remove any references to the environment variable INSTANA_KAFKA_HEADER_FORMAT or the in-code configuration option for tracing: { kafka: { headerFormat: .... }}}. For more information about Kafka migration, see kafka-header-migration phase 2.

• The support for the X-Instana-Service header is discontinued. To capture the X-Instana-Service header, you must configure it in the Instana agent configuration file configuration.yaml. For more information, see Capturing custom HTTP headers.

• The environment variables INSTANA_URL and INSTANA_KEY is removed. Replace any references to these with INSTANA_ENDPOINT_URL and INSTANA_AGENT_KEY .

• The support for disabling AWS SDK instrumentation through aws-sdk/v2/index is dropped; instead, use aws-sdk/v2. For more information, see disabling tracer.

• The support for the q package is discontinued. For more information, see q .

• The support for the kafka-avro package is deprecated. For more information, see kafka-avro .

The support for the following technologies is discontinued. For more information about version 3 breaking changes, see GitHub changelog.

• The support for Node.js 10 and 12 is discontinued. Upgrade to Node.js 14.0.0 or later.

• The /opt/instana/instrumentation/nodejs/runtime-version-switch internal script is removed from the Instana AutoTrace webhook. If you get the runtime-version-switch module not found error message, see Troubleshooting.

• The support for the Elasticsearch library is removed.

  Before you update to version 3, you must migrate to @elastic/elasticsearch.

• The support for the gRPC library is removed.

  Before you update to version 3, you must migrate to @grpc/grpc-js.

• The support for node-redis 0 is discontinued. For more information, see node-redis.

• The support for MSSQL 8 is discontinued. For more information, see node-mssql.

• The support for GraphQL 14 is discontinued. For more information, see graphql-js.

• The kafka-node library is officially deprecated.

• The support for fastify 1 is discontinued.

For more information about version 2 breaking changes, see GitHub changelog.

• The support for Node 6 and 8 is dropped with version 2.0.0 of all Instana npm packages (@instana/collector, @instana/aws-fargate, @instana/aws-lambda, and @instana/google-cloud-run). Upgrade your Node.js version to at least 10.4.0.

• The support for reportUncaughtException is removed. This feature is deprecated since version 1.112.0. If you used this feature previously, you can rely on the abnormal process termination detection feature instead. Abnormal process termination detection is on by default.

• The configuration option timeBetweenHealthcheckCalls is moved from instana({ tracing: { timeBetweenHealthcheckCalls: Boolean }}) to instana({ tracing: { metrics: { timeBetweenHealthcheckCalls }}}). For more information, see full configuration reference.

• The configuration option for logger is removed. You can no longer use instana({logger: logger}). Use instana.setLogger(logger) instead. For more information, see setting the logger after initialization.

• The configuration option disableAutomaticTracing is removed. You can no longer use instana({ tracing: { disableAutomaticTracing: Boolean }}). Use instana({ tracing: { automaticTracingEnabled: Boolean }}) instead. For more information, see disabling automatic tracing.