サポート情報

対応プロセッサ・アーキテクチャとオペレーティング・システム

以下の表に、 Node.js コレクタのサポート環境の概要を示します:

アーキテクチャー オペレーティング・システム
x86_64 (AMD64) Linux ( Red Hat を含む)、 macOS, Windows、および FreeBSD
AArch64 (ARM64) Linux ( Red Hat を含む)、 macOS, Windows、および FreeBSD
IBM Z (s390x) LinuxONE ( Linux on IBM Z ) および z/OS
IBM パワー ( ppc64 ) AIX
IBM パワー ( ppc64le ) pLinux ( Linux on Power)
パワーISA ( IBM i ) IBM i (電力システムについて)
注: プレビルド・バイナリは、メインストリーム・アーキテクチャと長期サポート(LTS)バージョンの Node.js に対してのみ提供されます。 詳細については、 ネイティブ・アドオンのセクションを参照してください。

主な Node.js コレクター・バージョン

Instana Node.js コレクターの主なリリースは以下の通り:

  • 現在のメジャーバージョン: バージョン5
  • 以前のメジャーバージョン: バージョン4
注: 以前のメジャーバージョンでは、重大性の高いセキュリティとバグの修正のみがリリースされています。 最新のメジャーバージョンにアップデートして、完全なサポートをご利用ください。

詳細については、 Node.js コレクターのバージョン管理および Node.js コレクターのアップグレードにおける互換性のない変更を参照してください。

サポート対象の Node.js のバージョン

以下の表に、Instana Node.js コレクタがサポートする Node.js バージョンの概 要を示します:

Node.js バージョン コレクターのバージョン
25.0.0 その後 4.27.0 - 最新
24.0.0 その後 4.13.0 - 最新
23.0.0 その後 3.21.0 - 最新
22.0.0 その後 3.7.0 - 最新
21.0.0 その後 3.0.0 - 最新
20.3.0 その後 2.26.0 - 最新
18.19.0 そして後で 2.4.0 - 最新
18.0.0 その後 2.4.0 - 4.31.0
16.0.0 その後 1.125.0 - 3.21.1
14.0.0 その後 1.97.0 - 3.21.1
12.0.0 その後 1.67.0 - 2.36.1
10.4.0 その後 1.38.0 - 2.36.1
8.2.1 その後 1.28.0 - 1.x
6.0.0 その後 1.0.0 - 1.x
4.5 その後 1.0.0 - 1.103.0
5.10 その後 1.0.0 - 1.103.0

Node.js LTSおよびEOLバージョンのサポート

Instana は、 Node.js 監視に関して、 Node.js の公式の長期サポート (LTS) およびサポート終了 (EOL) のタイムラインに従います。

Node.js バージョンがEOLに達した場合、 少なくとも1年間の追加サポートが提供される。 潜在的な問題を避けるため、 Node.js のバージョンを定期的に更新してください。

以下の表に、古いメジャーバージョンで Node.js コレクタがサポートする EOL Node.js バージョンの概要を示します。 これらのバージョンはメンテナンスが終了しており、アップデートはありません。

EOL Node.js バージョン 対応コレクターバージョン
< Node.js 18.19.0 @instana/collector@v4-latest
< Node.js 18 @instana/collector@v3-latest
< Node.js 14 @instana/collector@v2-latest

Node.js の EOL バージョンに関する警告

1.136.0 以降、 Node.js の EOL バージョンでアプリケーションが実行されている場合、コレクターは issue イベントを送信します。

EOL Node.js バージョンではアップデートが提供されなくなるため、アプリケーションはセキュリティ上の問題にさらされやすくなり、CPUやメモリ消費量の最適化など、ランタイムの重要な改善点を見逃すことになる。

これらのバージョンに依存している場合は、 Node.js の有効なバージョンに更新して、完全なサポートを受けてください。

積極的にメンテナンスされているランタイムを使用することが推奨されているにもかかわらず、インスタナは古いバージョンの Node.js をサポートしている。

Node.js コレクター・バージョニング

Instana npmパッケージは、 semver仕様に準拠している。

注記: npm install @ instana/collector@latest は常に最新のメジャーバージョンをインストールします。 package.json ファイルでコレクターのバージョンを固定するには、バージョン範囲を使用します。例: @instana/collector: ^4.x.y コレクターのバージョンを固定することで、新機能(マイナーリリース)とバグ修正(パッチリリース)を自動的に受け取ることができます。 しかし、バージョン3から4へのメジャーバージョンアップの場合は、手動での設定が必要だ。 詳細については、 変更点の一覧を参照してください。

AWS Fargate および Google Cloud Run コンテナ・ベース・イメージのバージョン管理スキームの詳細については、それぞれのセクションを参照のこと:

Node.js コレクターのアップグレードにおける変更点

注: 各バージョンの変更点の詳細なリスト(メジャーバージョンの変更点を含む)は、 GitHub の changelog でもご覧いただけます。

バージョン4から5へのアップグレード

以下のアイテムのサポートは終了しました。 バージョン5の互換性のない変更点の詳細については、 変更履歴 GitHub を参照してください。

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

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

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

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

  • のサポートは AWS SDK v2 非推奨です。 詳細については、および AWS SDK for AWS SDK v2 を参照してください JavaScriptv3。

  • Instanaの AutoTrace ウェブフックにおいて、設定 autotrace.nodejs.application_type オプションはレガシー module_v1 値を不再サポートします。 代わりに module_v2 を使用してください。 詳細については、 ECMAScriptモジュ Node.js ールのセクションを参照してください。

バージョン3から4へのアップグレード

以下の技術のサポートは終了しました。 バージョン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 phase 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 .

バージョン2から3へのアップグレード

以下の技術のサポートは終了しました。 バージョン3の変更点の詳細については、 GitHub チェンジログをご覧ください。

  • Node.js 10と12のサポートは終了しました。 Node.js 14.0.0 以降にアップグレードしてください。

  • 内部 /opt/instana/instrumentation/nodejs/runtime-version-switch スクリプトは、Instana の AutoTrace ウェブフックから削除されました。 runtime-version-switch module not found のエラーメッセージが表示された場合は、「 トラブルシューティング 」を参照してください。

  • Elasticsearch ライブラリのサポートが削除された。

    バージョン3にアップデートする前に、 @elastic/elasticsearchに移行する必要があります。

  • gRPC ライブラリのサポートが削除された。

    バージョン3にアップデートする前に、 @grpc/grpc-jsに移行する必要があります。

  • node- redis 0 のサポートは終了しました。 詳しくは、 node- redis を参照。

  • MSSQL 8のサポートは終了しました。 詳細は node-mssqlを参照のこと。

  • GraphQL 14のサポートは終了しました。 詳細は graphql-jsを参照。

  • kafka-nodeライブラリは正式に非推奨となりました。

  • fastify 1のサポートは終了しました。

バージョン1から2へのアップグレード

バージョン2の変更点の詳細については、 GitHub changelog を参照のこと。

  • Node 6および8のサポートは、すべてのInstana npmパッケージ(@instana/collector, @instana/aws-fargate, @instana/aws-lambda, @instana/google-cloud-run )のバージョン 2.0.0。 Node.js のバージョンを少なくとも 10.4.0 にアップグレードしてください。

  • reportUncaughtException 。 この機能はバージョン 1.112.0 以降、非推奨となっている。 以前この機能を使用していた場合は、代わりに異常終了検出機能を使用することができます。 デフォルトでは、プロセスの異常終了検出はオンになっています。

  • コンフィギュレーション・オプション timeBetweenHealthcheckCallsinstana({ tracing: { timeBetweenHealthcheckCalls: Boolean }}) から instana({ tracing: { metrics: { timeBetweenHealthcheckCalls }}}) に移動した。 詳しくは、 完全な構成リファレンスを参照してください。

  • logger の設定オプションが削除された。 instana({logger: logger})を使用できなくなりました。 代わりに instana.setLogger(logger) を使用してください。 詳しくは、 初期化後のロガーの設定を参照してください。

  • 設定オプション disableAutomaticTracing は削除された。 instana({ tracing: { disableAutomaticTracing: Boolean }})を使用できなくなりました。 代わりに instana({ tracing: { automaticTracingEnabled: Boolean }}) を使用してください。 詳しくは、 自動トレースの無効化を参照してください。