Node.jsのライブラリとフレームワークをサポート
Instana Node.js のTracerパッケージは、以下の Node.js ライブラリおよびフレームワークのトレース機能をサポートしています。
Node.js アプリケーションの監視に関する詳細については、 「 Node.js の監視」 を参照してください。
「 npm パッケージのバージョン」列には、特定のライブラリやフレームワークに必要な Instana Node.js Tracerパッケージの最小バージョンが示されています。 詳細については、 GitHub の変更履歴をご覧ください。
HTTP
次の表は、 Instana Node.js Tracer パッケージがサポートする HTTP ライブラリの概要を示しています：
| ライブラリー | サポート・ポリシー | Instana および npm の最低必要バージョン | 計測機器識別子 [1] |
|---|---|---|---|
| express のエラー処理とパステンプレート | 45 日間 | 1.32.0, 1.43.0 | express |
| fastify | 45 日間 | 1.44.0 | fastify |
| HTTP | 0日 | 1.10.0 | httpClient,httpServer |
| HTTPS | 0日 | 1.10.0 | httpClient,httpServer |
| http2 | 0日 | 1.103.0 | http2Client, http2Server |
| node-fetch | 0日 | 3.9.0 | node-fetch |
| @hapi/hapi パステンプレート | 45 日間 | 1.68.0 | hapi |
| コアウルータのパステンプレート | 45 日間 | 1.56.0 | koa |
| スーパーエージェント | 45 日間 | 1.102.0 | superagent |
| フェッチ | 0日 | 2.15.0 | nativefetch |
| TSOA | 45 日間 | 1.140.0 | tsoa |
RPC
次の表は、 Instana Node.js Tracer パッケージがサポートする RPC ライブラリの概要を示しています：
| ライブラリー | サポート・ポリシー | Instana および npm の最低必要バージョン | 計測器識別子 [1:1] |
|---|---|---|---|
| @apollo/federation [2] | 非推奨 | 1.87.0 | graphql |
| @apollo/server | 45 日間 | 4.12.0 | graphql |
| @apollo/subgraph | 45 日間 | 3.1.2 | graphql |
| @grpc/grpc-js | 45 日間 | 1.5.7 | grpc |
| graphql | 45 日間 | 1.69.0 | graphql |
データベース
以下の表は、 Instana Node.js トレーサーでサポートされているデータベースライブラリの概要を示しています：
| ライブラリー | サポート・ポリシー | Instana および npm の最低必要バージョン | 計測器識別子 [1:2] |
|---|---|---|---|
| @elastic/elasticsearch | 45 日間 | 1.96.0 | elasticsearch |
| memcached （バージョン 2.2.2 以降） | 45 日間 | 1.126.0 | memcached |
| MongoDB （バージョン 2.2 以降） | 45 日間 | 1.13.0 | mongodb |
| マングース | 45 日間 | 1.13.0 | mongoose |
| MySQL | 45 日間 | 1.29.0 | mysql |
| mysql2 | 45 日間 | 1.37.1 | mysql2 |
| mssql | 45 日間 | 1.47.0 | mssql |
| プリズマ | 45 日間 | 2.11.0 | prisma |
| PG | 45 日間 | 1.44.2 | pg |
| pg-native | 45 日間 | 1.86.0 | pgnative |
| redis | 45 日間 | 1.31.0 | redis |
| ioredis | 45 日間 | 1.33.0 | ioredis |
| 続編化する | 45 日間 | ドライバーの具体的なバージョンによって異なります [3] | sequelize |
| ibm-db | 45 日間 | 2.2.0 | db2 |
| couchbase | 45 日間 | 2.21.0 | couchbase |
| 退屈な | 45 日間 | 3.2.0 | |
| oracledb | 45 日間 | 4.24.0 |
メッセージング
次の表は、 Instana Node.js Tracer パッケージがサポートするメッセージングライブラリの概要を示しています：
| ライブラリー | サポート・ポリシー | Instana および npm の最低必要バージョン | 計測器識別子 [1:3] |
|---|---|---|---|
| node-nats-streaming | 非推奨 | 1.72.0 | natStreaming |
| nats | 45 日間 | 1.72.0 | nats |
| amqplib | 45 日間 | 1.51.0 | amqplib |
| Kafka -ノード | 非推奨 | 1.20.0 | kafkanode |
| カフカ | 45 日間 | 1.83.0 | kafkajs |
| node-rdkafka | 45 日間 | 1.139.0 | rdkafka |
| kafka-avro | 非推奨 | 1.139.0 | |
| Bull | 45 日間 | 1.119.0 | bull |
| socket.io | 45 日間 | 2.24.0 | |
| socket.io-client | 45 日間 | 2.24.0 | |
| @confluentinc/kafka-javascript | 45 日間 | 5.1.0 |
クラウド・サービス
次の表は、 Instana の Node.js Tracerパッケージがサポートするクラウドサービスライブラリの概要を示しています：
| ライブラリー | サポート・ポリシー | Instana および npm の最低必要バージョン | 計測器識別子 [1:4] |
|---|---|---|---|
| aws-sdk [4] [5] [6] | 45 日間 | 1.114.0 | aws-sdk/v2 |
| @aws-sdk/client-sqs [4:1] [5:1] | 45 日間 | 1.132.0 | aws-sdk/v3 |
| @aws-sdk/client-s3 | 45 日間 | 1.129.0 | aws-sdk/v3 |
| @aws-sdk/client-dynamodb | 45 日間 | 1.127.0 | aws-sdk/v3 |
| @aws-sdk/client-kinesis | 45 日間 | 2.30.0 | aws-sdk/v3 |
| @aws-sdk/client-lambda | 45 日間 | 2.34.0 | aws-sdk/v3 |
| @google-cloud/storage | 45 日間 | 1.105.0 | gcp/storage |
| @google-cloud/pubsub [4:2] (>= 1.2.0 ) | 45 日間 | 1.107.0 | gcp/pubsub |
| sqs-consumer | 45 日間 | 1.119.3 | sqs-consumer |
| @azure/storage-blob | 45 日間 | 3.4.0 | azure/blob |
ロギング
非同期
その他
以下の表は、 Instana Node.js トレーサーでサポートされているその他のライブラリの概要を示しています：
| ライブラリー | サポート・ポリシー | Instana および npm の最低必要バージョン | 計測器識別子 [1:7] |
|---|---|---|---|
| edgemicro ( 2.4, 2.5, >= 3.x ) [7] | 45 日間 | 1.89.0 | |
| fs | 45 日間 | 2.24.0 |
- NATSの場合：NATSにはメッセージヘッダーがないため。 詳細については、 NATSのトレースに関するドキュメントを参照してください。
- NATSストリーミングの場合：NATSストリーミングにはメッセージヘッダーがないため。 詳細については、 NATSのトレースに関するドキュメントを参照してください。
- npm
kafka-nodeパッケージを使用してメッセージを送信または受信する場合：このパッケージは Kafka レコードヘッダーをサポートしていないためです。 詳細については、 kafka-node#763 および kafka-node#1309 を参照してください。 Kafka 以降では、 Kafka におけるトレースの継続性が一般的にサポートされています。その他のランタイムについては 0.11 を参照してください。また、kafkajsパッケージを使用する場合も同様です。 したがって、 Node.js アプリケーションで Kafka および Instana を使用する際は、kafka-nodeのkafkajs代わりにを使用する必要があります。 - オプション
objectModeが に設定されていないtrue場合、を使用してメッセージをnode-rdkafkaストリームとして生成するとき。
「Instrumentation識別子」とは、アプリケーションの設定において、特定のライブラリのトレースを有効または無効にするために使用される内部名です。 識別子が利用できない場合、このインストルメンテーションはこれらの機能をサポートしていません。 ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎
Instana Sequelize自体を直接実装するのではなく、その基盤となるデータベースドライバを実装します。 sequelizeのアクションの可視性は、sequelizeと一緒に使用しているデータベースライブラリ（
mysql、mysql2、mssql、pg、pg-native）に依存します。 ↩︎AWS SQS、NATS、NATS streaming、または Google Cloud PubSub,
amqplibを含むメッセージを受信した後、その後の呼び出しを正しくキャプチャするには、RabbitMQnode-rdkafkakafka-nodekafkajsspan.end()とspan.disableAutoEnd()を使用する必要があります。 詳細については、 「スパンを手動で終了させる」 を参照してください。 ↩︎ ↩︎ ↩︎AWS SQS や を使用する場合
async、 非同期コンテキストの手動での復元が必要になりますawait。 ↩︎ ↩︎AWS SDKの v2 は正式に非推奨となりました。 詳細については、 「 AWS SDK から v3 への移行」 を参照してください。↩︎
Apigeeマイクロゲートウェイまたはedgemicroを使用するには、追加のインストール手順が必要です。 このユースケースに関する詳細については、 インストール手順を参照してください。 ↩︎