サポート情報
Instana Node.js コレクターが現在のセットアップと互換性があることを確認するには、以下のサポート情報のセクションを確認してください。
詳細については、 Instana Node.js コレクターを参照してください。
Node.js アプリケーションの監視の詳細については、 Node.js 監視」を参照してください。
対応プロセッサ・アーキテクチャとオペレーティング・システム
以下の表に、 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 (電力システムについて) |
主な 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仕様に準拠している。
AWS Fargate および Google Cloud Run コンテナ・ベース・イメージのバージョン管理スキームの詳細については、それぞれのセクションを参照のこと:
Node.js コレクターのアップグレードにおける変更点
バージョン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_TRACERSとINSTANA_DISABLE_TRACING、および設定オプションtracing.disabledTracersが削除されます。 設定を更新して、代わりにtracing.disableとINSTANA_TRACING_DISABLEを使用してください。 詳細については、 「すべてのトレースを無効にする」 を参照してください。kafka-avroパッケージのサポートは終了しました。 細については、kafka-avroを参照してください。のサポートは
AWS SDK v2非推奨です。 詳細については、および AWS SDK forAWS 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 以降、非推奨となっている。 以前この機能を使用していた場合は、代わりに異常終了検出機能を使用することができます。 デフォルトでは、プロセスの異常終了検出はオンになっています。コンフィギュレーション・オプション
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 }})を使用してください。 詳しくは、 自動トレースの無効化を参照してください。
対応 Node.js ライブラリとフレームワーク
Instana Node.js コレクターは、特定の Node.js ライブラリとフレームワークを計測し、トレースを可能にする。 詳細については、 「サポート対象の Node.js ライブラリとフレームワーク」 を参照してください。