支持信息

Instana 遵循 Node.js 上的官方长期支持 (LTS) 和生命周期结束 (EOL) 时间表，用于监控 Node.js。

当 Node.js 的某个版本达到其生命周期结束（EOL）日期时，将提供至少一年的额外支持。 为避免潜在问题，请定期更新您的 Node.js 版本。

当应用程序在已停止维护的 Node.js 版本下运行时， Instana Node.js 收集器会触发一个问题事件。

版本 6 引入了以下兼容性变更。 如需了解更多信息，请参阅 GitHub 变更日志

• 配置优先级已更新。 新的配置优先级顺序如下：

  1. 环境变量（优先级最高）
  2. 代码内配置
  3. 代理配置
  4. 缺省值

• 环境变量 INSTANA_DEV_MIN_DELAY_BEFORE_SENDING_SPANS 被替换为 INSTANA_TRACING_TRANSMISSION_DELAY。

以下项目已停止支持。 有关版本 5 的重大变更的更多信息，请参阅 GitHub 中的变更日志。

• Node.js 18.19.0 之前的版本不再受支持。 您必须升级至 Node.js 18.19.0 或更高版本。

• 已移除使用 --experimental-loaderesm-loader.mjs 和 的旧版 ESM 支持。 请确保在收集器初始化脚本中使用 --import esm-register.mjs 与。 如需更多信息，请参阅 “Collector 安装 – ECMAScript ”。

• 环境变量 INSTANA_DISABLED_TRACERS 和 INSTANA_DISABLE_TRACING，以及配置选项 tracing.disabledTracers 已被移除。 请更新您的配置，改用 INSTANA_TRACING_DISABLE 和 tracing.disable 。 如需更多信息，请参阅 “禁用所有跟踪 ”。

• kafka-avro 软件包的支持服务已终止。 有关更多信息，请参阅 kafka-avro。

• 对 的支持 AWS SDK v2 已弃用。 如需了解更多信息，请参阅 AWS SDK v2 以及 AWS 适用于 JavaScript 的 SDK v3。

• 在 Instana AutoTrace 的 webhook 中，该 autotrace.nodejs.application_type 配置选项不再支持旧版 module_v1 值。 请 module_v2 改用。 如需更多信息，请参阅 Node.js 中的 ECMAScript 模块部分。

  注意： 当前的配置优先级将在下一个主要版本中发生变化。

以下技术支持已终止。 有关版本3重大变更的更多信息，请参阅 GitHub 更新日志。

• Node.js 14和16的支持已终止。 您必须升级到 Node.js 18.0.0 或更高版本。

• Node.js 运行v14 和 v16 的支持已终止。

• Kafka 报头格式的配置选项已被删除，报头现在以 string 格式发送，不再支持 binary 格式。 删除所有提及环境变量 INSTANA_KAFKA_HEADER_FORMAT 或代码内配置选项的内容 tracing: { kafka: { headerFormat: .... }}}。 有关 Kafka 迁移的更多信息，请参见 kafka-header-migration阶段2。

• X-Instana-Service 标头支持已终止。 要捕获该 X-Instana-Service 标头，您必须在 Instana 代理配置文件中进行 configuration.yaml配置。 如需了解更多信息，请参阅 《捕获自定义 HTTP 标头》。

• 环境变量 INSTANA_URL 和 INSTANA_KEY 已被删除。 将所有提及这些内容的表述替换为 INSTANA_ENDPOINT_URL 和 INSTANA_AGENT_KEY 。

• 通过 aws-sdk/v2/index 禁用 AWS SDK工具的支持已取消；请改用 aws-sdk/v2 。 更多信息，请参阅禁用跟踪器。

• q 软件包的支持服务已终止。 如需了解更多信息，请参阅 q 。

• kafka-avro 软件包的支持已弃用。 如需了解更多信息，请参阅 kafka-avro 。

以下技术支持已终止。 有关版本3重大变更的更多信息，请参阅 GitHub 更新日志。

• Node.js 10和12的支持已终止。 升级到 Node.js 14.0.0 或更高版本。

• /opt/instana/instrumentation/nodejs/runtime-version-switch 已从 Instana AutoTrace 的 webhook 中移除了 内部脚本。 如果您收到 runtime-version-switch module not found 错误信息，请参阅故障排除。

• 不再 Elasticsearch。

  在更新到版本3之前，必须迁移到 @elastic/elasticsearch。

• gRPC的支持已取消。

  在更新到版本3之前，必须迁移到 @grpc/grpc-js。

• 对redis 的支持已终止。 更多信息，请参见 redis。

• 对MSSQL 8的支持已终止。 更多信息，请参见 node-mssql。

• GraphQL 的支持已终止。 更多信息，请参阅 graphql-js。

• kafka-node库已正式弃用。

• 对fastify 1 的支持已终止。

有关版本2重大变更的更多信息，请参阅 GitHub 更新日志。

• 随着所有 Instana npm 包（@instana/collector, @instana/aws-fargate, @instana/aws-lambda, 和 @instana/google-cloud-run）的版本升级至 2.0.0 ，对 Node 6 和 8 的支持已被移除。 请将您的 Node.js 版本升级至 10.4.0 或更高版本。

• 对 reportUncaughtException 的支持已取消。 1.112.0起，此功能已弃用。 如果您之前使用过此功能，则可以改用异常进程终止检测功能。 缺省情况下，“异常进程终止检测”处于开启状态。

• 配置选项 timeBetweenHealthcheckCalls 已从 instana({ tracing: { timeBetweenHealthcheckCalls: Boolean }}) 移至 instana({ tracing: { metrics: { timeBetweenHealthcheckCalls }}}) 。 有关更多信息，请参阅完整配置参考。

• logger 的配置选项已删除。 您无法再使用 instana({logger: logger})。 请改为使用 instana.setLogger(logger)。 有关更多信息，请参阅在初始化后设置记录器。

• 配置选项 disableAutomaticTracing 已删除。 您无法再使用 instana({ tracing: { disableAutomaticTracing: Boolean }})。 请改为使用 instana({ tracing: { automaticTracingEnabled: Boolean }})。 有关更多信息，请参阅禁用自动跟踪。