Bibliothèques et frameworks Node.js pris en charge
Les packages Tracer de l' Instana Node.js prennent en charge le traçage pour les bibliothèques et les frameworks suivants : Node.js.
Pour plus d'informations sur la surveillance des applications Node.js, consultez la page Surveillance Node.js.
La colonne « Version du package npm » indique la version minimale du package Instana Node.js Tracer requise pour une bibliothèque ou un framework donné. Pour plus d'informations, consultez le journal des modifications d' GitHub.
HTTP
Le tableau suivant présente les bibliothèques d' HTTP s prises en charge par les modules Tracer de Instana Node.js :
| Bibliothèque | Politique de support | Configuration minimale requise : version d' Instananpm | Identifiant de l'instrument [1] |
|---|---|---|---|
| Gestion des erreurs et modèles de chemin d'accès dans Express | 45 jours | 1.32.0, 1.43.0 | express |
| accélérer | 45 jours | 1.44.0 | fastify |
| HTTP | 0 jour | 1.10.0 | httpClient,httpServer |
| https | 0 jour | 1.10.0 | httpClient,httpServer |
| http2 | 0 jour | 1.103.0 | http2Client, http2Server |
| node-fetch | 0 jour | 3.9.0 | node-fetch |
| Modèles de chemin @hapi/hapi | 45 jours | 1.68.0 | hapi |
| modèles de chemin koa-router | 45 jours | 1.56.0 | koa |
| superagent | 45 jours | 1.102.0 | superagent |
| extraire | 0 jour | 2.15.0 | nativefetch |
| TSOA | 45 jours | 1.140.0 | tsoa |
RPC
Le tableau suivant présente les bibliothèques d' RPC s prises en charge par les modules Tracer de Instana Node.js :
| Bibliothèque | Politique de support | Configuration minimale requise : version d' Instananpm | Identifiant de l'instrument [1:1] |
|---|---|---|---|
| @apollo/federation [2] | Obsolète | 1.87.0 | graphql |
| @apollo/serveur | 45 jours | 4.12.0 | graphql |
| @apollo/subgraph | 45 jours | 3.1.2 | graphql |
| @grpc/grpc-js | 45 jours | 1.5.7 | grpc |
| graphql | 45 jours | 1.69.0 | graphql |
Bases de données
Le tableau suivant présente les bibliothèques de bases de données prises en charge par les traceurs Node.js d' Instana :
| Bibliothèque | Politique de support | Configuration minimale requise : version d' Instananpm | Identifiant de l'instrument [1:2] |
|---|---|---|---|
| @elastic/elasticsearch | 45 jours | 1.96.0 | elasticsearch |
| memcached (version 2.2.2 ou supérieure) | 45 jours | 1.126.0 | memcached |
| mongodb (version 2.2 ou supérieure) | 45 jours | 1.13.0 | mongodb |
| mangouste | 45 jours | 1.13.0 | mongoose |
| MySQL | 45 jours | 1.29.0 | mysql |
| mysql2 | 45 jours | 1.37.1 | mysql2 |
| mssql | 45 jours | 1.47.0 | mssql |
| prisme | 45 jours | 2.11.0 | prisma |
| PG | 45 jours | 1.44.2 | pg |
| pg-native | 45 jours | 1.86.0 | pgnative |
| redis | 45 jours | 1.31.0 | redis |
| ioredis | 45 jours | 1.33.0 | ioredis |
| faire une suite | 45 jours | Cela dépend de la version spécifique du pilote [3] | sequelize |
| ibm-db | 45 jours | 2.2.0 | db2 |
| couchbase | 45 jours | 2.21.0 | couchbase |
| fastidieux | 45 jours | 3.2.0 | |
| OracleDB | 45 jours | 4.24.0 |
Messagerie
Le tableau suivant présente les bibliothèques de messagerie prises en charge par les packages Tracer d' Instana Node.js :
| Bibliothèque | Politique de support | Configuration minimale requise : version d' Instananpm | Identifiant de l'instrument [1:3] |
|---|---|---|---|
| node-nats-streaming | Obsolète | 1.72.0 | natStreaming |
| nats | 45 jours | 1.72.0 | nats |
| amqplib | 45 jours | 1.51.0 | amqplib |
| kafka-node | Obsolète | 1.20.0 | kafkanode |
| kafkajs | 45 jours | 1.83.0 | kafkajs |
| node-rdkafka | 45 jours | 1.139.0 | rdkafka |
| kafka-avro | Obsolète | 1.139.0 | |
| Bull | 45 jours | 1.119.0 | bull |
| socket.io | 45 jours | 2.24.0 | |
| socket.io-client | 45 jours | 2.24.0 | |
| @confluentinc/kafka-javascript | 45 jours | 5.1.0 |
Services cloud
Le tableau suivant présente les bibliothèques de services cloud prises en charge par les packages Tracer d' Instana Node.js :
| Bibliothèque | Politique de support | Configuration minimale requise : version d' Instananpm | Identifiant de l'instrument [1:4] |
|---|---|---|---|
| aws-sdk [4] [5] [6] | 45 jours | 1.114.0 | aws-sdk/v2 |
| @aws-sdk/client-sqs [4:1] [5:1] | 45 jours | 1.132.0 | aws-sdk/v3 |
| @aws-sdk/client-s3 | 45 jours | 1.129.0 | aws-sdk/v3 |
| @aws-sdk/client-dynamodb | 45 jours | 1.127.0 | aws-sdk/v3 |
| @aws-sdk/client-kinesis | 45 jours | 2.30.0 | aws-sdk/v3 |
| @aws-sdk/client-lambda | 45 jours | 2.34.0 | aws-sdk/v3 |
| @google-cloud/storage | 45 jours | 1.105.0 | gcp/storage |
| @google-cloud/pubsub [4:2] (>= 1.2.0 ) | 45 jours | 1.107.0 | gcp/pubsub |
| sqs-consommateur | 45 jours | 1.119.3 | sqs-consumer |
| @azure/storage-blob | 45 jours | 3.4.0 | azure/blob |
Journalisation
Le tableau suivant répertorie les bibliothèques de journalisation prises en charge par les traceurs Instana Node.js :
| Bibliothèque | Politique de support | Configuration minimale requise : version d' Instananpm | Identifiant de l'instrument [1:5] |
|---|---|---|---|
| Bunyan | 45 jours | 1.54.0 | bunyan |
| express-winston | 45 jours | 1.88.0 | winston |
| log4js | 45 jours | 1.84.0 | log4js |
| pino | 45 jours | 1.52.0 | pino |
| Winston | 45 jours | 1.88.0 | winston |
Async
Le tableau suivant présente les bibliothèques asynchrones prises en charge par les traceurs Node.js d' Instana :
| Bibliothèque | Politique de support | Configuration minimale requise : version d' Instananpm | Identifiant de l'instrument [1:6] |
|---|---|---|---|
| asynchrone | 45 jours | 1.10.0 | – |
| merle bleu | 45 jours | 1.35.0 | bluebird |
| promesses | 0 jour | 1.10.0 | – |
| Temporisateurs | 0 jour | 1.10.0 | – |
Autre
Le tableau suivant présente les autres bibliothèques prises en charge par les traceurs Node.js d' Instana :
| Bibliothèque | Politique de support | Configuration minimale requise : version d' Instananpm | Identifiant de l'instrument [1:7] |
|---|---|---|---|
| edgemicro ( 2.4, 2.5, >= 3.x ) [7] | 45 jours | 1.89.0 | |
| fs | 45 jours | 2.24.0 |
- Pour le NATS : Parce que le NATS n'a pas d'en-tête de message. Pour plus d'informations, consultez la documentation sur le traçage NATS.
- Pour la diffusion NATS : Le streaming NATS n'a pas d'en-tête de message. Pour plus d'informations, consultez la documentation sur le traçage NATS.
- Lorsque vous utilisez le package « npm
kafka-node» pour envoyer ou traiter des messages : ce package ne prend pas en charge les en-têtes d'enregistrement « Kafka ». Pour plus d'informations, consultez les sites kafka-node#763 et kafka-node#1309. La continuité des traces est prise en charge pour Kafka en général, à partir de Kafka 0.11 pour d'autres environnements d'exécution, ainsi que lorsque vous utilisez le paquetkafkajs. Par conséquent, vous devez utiliserkafkajsà la place dekafka-nodelorsque vous utilisez Kafka et Instana dans votre application Node.js. - Lorsque vous utilisez
node-rdkafkapour générer des messages sous forme de flux et queobjectModel'option n'est pas définie surtrue.
L'identifiant d'instrumentation est le nom interne utilisé dans la configuration de l'application pour activer ou désactiver le traçage d'une bibliothèque spécifique. Si aucun identifiant n'est disponible, l'instrumentation ne prend pas en charge ces fonctionnalités. ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎
La bibliothèque Apollo Federation est officiellement obsolète. Pour plus d'informations, voir Apollo Federation. ︎
Instana n'utilise pas directement Sequelize, mais plutôt les pilotes de base de données sous-jacents. La visibilité des actions de sequelize dépend de la bibliothèque de base de données que vous utilisez avec sequelize (
mysql,mysql2,mssql,pg, etpg-native). ︎Pour enregistrer correctement les appels suivants après avoir reçu un message contenant les mots-clés « AWS SQS »,
kafkajskafka-node«node-rdkafka, »,RabbitMQ«amqplib, », «, », «, », « NATS », « NATS streaming » ou « Google Cloud » « PubSub, », vous devez utiliserspan.disableAutoEnd()« » etspan.end()« ». Pour plus d'informations, consultez la section « Terminer manuellement les enchaînements ». ↩︎ ↩︎ ↩︎AWS SQS nécessite une restauration manuelle du contexte asynchrone lorsque vous utilisez des promesses avec
asyncouawait. ↩︎ ↩︎AWS Le SDK v2 est officiellement obsolète. Pour plus d'informations, consultez la page « Migration de l' v3 vers le SDK d' AWS ». ↩︎
L'utilisation d'Apigee Microgateway ou d'edgemicro nécessite des étapes d'installation supplémentaires. Pour plus d'informations sur ce cas d'utilisation, consultez les instructions d'installation. ↩︎