サポート情報

Instana Node.js の監視については、 Node.js に掲載されている公式の長期サポート（LTS）およびサポート終了（EOL）のスケジュールを準拠しています。

Node.js のバージョンがサポート終了日を迎えた場合、 少なくとも1 年間の追加サポートを受けることができます。 問題の発生を防ぐため、 Node.js のバージョンを定期的に更新してください。

Instana Node.js コレクターは、アプリケーションが Node.js のサポート終了版で実行されている場合に、 イシューイベントを送信します。

バージョン6では、以下の互換性のない変更が導入されています。 詳細については、 GitHub の変更履歴をご覧ください

• 設定の優先順位が更新されました。 新しい設定の優先順位は次のとおりです：

  1. 環境変数（最優先）
  2. コード内設定
  3. エージェントの構成
  4. デフォルト値

• INSTANA_TRACING_TRANSMISSION_DELAY環境変数 INSTANA_DEV_MIN_DELAY_BEFORE_SENDING_SPANS は に置き換えられます。

以下の項目に対するサポートは終了しました。 バージョン 5 の互換性破りの変更に関する詳細については、 GitHub の変更履歴をご覧ください。

• Node.js 18.19.0 より以前のバージョンは、サポート対象外となりました。 Node.js 18.19.0 以降にアップグレードする必要があります。

• と --experimental-loader を使用する従来の esm-loader.mjs ESMサポートは削除されました。 コレクターの初期化スクリプトでは、必ず esm-register.mjs と --import を使用してください。 詳細については、 「Collector のインストール – ECMAScript」 を参照してください。

• 環境変数 INSTANA_DISABLED_TRACERS および INSTANA_DISABLE_TRACING、ならびに設定オプション tracing.disabledTracers が削除されます。 設定を更新し、代わりに tracing.disable と INSTANA_TRACING_DISABLE を使用するようにしてください。 詳細については、 「すべてのトレースを無効にする」 を参照してください。

• kafka-avro パッケージのサポートは終了しました。 細については、 kafka-avroを参照してください。

• のサポートは AWS SDK v2 非推奨となっています。 詳細については、および AWS SDK for JavaScriptAWS SDK v2 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 を取得するには、 Instanaconfiguration.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 以降にアップグレードしてください。

• Instana AutoTrace の Webhook から、内部スクリプトが /opt/instana/instrumentation/nodejs/runtime-version-switch 削除されました。 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 }}) を使用してください。 詳しくは、 自動トレースの無効化を参照してください。