Unterstützte Node.js Bibliotheken und Frameworks

Online bearbeiten

Die Instana Node.js Tracer-Pakete unterstützen Tracing für die folgenden Node.js Bibliotheken und Frameworks.

Weitere Informationen zur Überwachung von Node.js Anwendungen finden Sie unter Überwachung Node.js.

Die Spalte "npm-Paketversion" gibt die Mindestversion des Instana Node.js Tracer-Pakets an, die für eine bestimmte Bibliothek oder ein bestimmtes Framework erforderlich ist. Weitere Informationen finden Sie GitHub Änderungsprotokoll.

HTTP

Online bearbeiten

In der folgenden Tabelle sind die HTTP Bibliotheken aufgeführt, die von den Instana Node.js Tracer-Paketen unterstützt werden:

Bibliothek Support-Richtlinie Minimal unterstützte Instana-npm-Version Kennung der Instrumentierung [1]
Express- Fehlerbehandlung und Pfadvorlagen 45 Tage 1.32.0, 1.43.0 express
Schnelligkeit 45 Tage 1.44.0 fastify
HTTP oder HTTPs-Kunden 0 Tag 1.10.0 httpClient
HTTP oder HTTPs-Server 0 Tag 1.10.0 httpServer
HTTP/2 kunden 0 Tag 1.103.0 http2Client
HTTP/2 server 0 Tag 1.103.0 http2Server
Hapi -Pfad-Vorlagen 45 Tage 1.68.0 hapi
koa-router pfadvorlagen 45 Tage 1.56.0 koa
anfrage-Versprechen [2] Veraltet 1.10.0 –
anfrage [3] Veraltet 1.10.0 –
Superagent 45 Tage 1.102.0 superagent
abrufen 0 Tag 2.15.0 nativefetch
TSOA 45 Tage 1.140.0 tsoa

Datenbanken

Online bearbeiten

Die folgende Tabelle gibt einen Überblick über die Datenbankbibliotheken, die von den Instana Node.js Tracern unterstützt werden:

Bibliothek Support-Richtlinie Minimal unterstützte Instana-npm-Version Kennung der Instrumentierung [1:2]
Elasticsearch Kunde (@elastic/elasticsearch) 45 Tage 1.96.0 elasticsearch
Memcached(>= 2.2.2) 45 Tage 1.126.0 memcached
MongoDB(>= 2.2) 45 Tage 1.13.0 mongodb
Mungo 45 Tage 1.13.0 mongoose
MySQL 45 Tage 1.29.0 mysql
MySQL2 45 Tage 1.37.1 mysql2
MSSQL 45 Tage 1.47.0 mssql
Prisma 45 Tage 2.11.0 prisma
Postgres 45 Tage 1.44.2 pg
Postgres (pg-native) 45 Tage 1.86.0 pgnative
Redis 45 Tage 1.31.0 redis
Redis (ioredis) 45 Tage 1.33.0 ioredis
Sequelize 45 Tage Hängt von der spezifischen Version eines Treibers ab [ 5] sequelize
IBM Db2 45 Tage 2.2.0 db2
Couchbase 45 Tage 2.21.0 couchbase

Messaging

Online bearbeiten

In der folgenden Tabelle sind die Messaging-Bibliotheken aufgeführt, die von den Instana Node.js Tracer-Paketen unterstützt werden:

Bibliothek Support-Richtlinie Minimal unterstützte Instana-npm-Version Kennung der Instrumentierung [1:3]
NATS-Streaming Veraltet 1.72.0 natStreaming
NATS 45 Tage 1.72.0 nats
RabbitMQ/amqplib 45 Tage 1.51.0 amqplib
Kafka-Knoten Veraltet 1.20.0 kafkanode
kafkajs 45 Tage 1.83.0 kafkajs
node-rdkafka 45 Tage 1.139.0 rdkafka
Bull 45 Tage 1.119.0 bull

Cloud-Services

Online bearbeiten

In der folgenden Tabelle sind die Bibliotheken der Cloud-Dienste aufgeführt, die von den Instana Node.js Tracer-Paketen unterstützt werden:

Bibliothek Support-Richtlinie Minimal unterstützte Instana-npm-Version Kennung der Instrumentierung [1:4]
AWS SDK v2 SQS [6] [7] [8:1] 45 Tage 1.114.0 aws-sdk/v2
AWS SDK v3 SQS [6:1] [7:1] 45 Tage 1.132.0 aws-sdk/v3
AWS SDK v2S3 [8:2] 45 Tage 1.115.0 aws-sdk/v2
AWS SDK v3 S3 45 Tage 1.129.0 aws-sdk/v3
AWS SDK v2 DynamoDB [8:3] 45 Tage 1.116.0 aws-sdk/v2
AWS SDK v3 DynamoDB 45 Tage 1.127.0 aws-sdk/v3
AWS SDK v2 SNS [8:4] 45 Tage 1.136.0 aws-sdk/v2
AWS SDK v2 Kinesis [8:5] 45 Tage 1.120.0 aws-sdk/v2
AWS SDK v3 Kinesis 45 Tage 2.30.0 aws-sdk/v3
AWS SDK v2 Lambda [8:6] 45 Tage 1.122.0 aws-sdk/v2
AWS SDK v3 Lambda 45 Tage 2.34.0 aws-sdk/v3
Google Cloud Storage 45 Tage 1.105.0 gcp/storage
PubSubGoogle Cloud [6:2] (>= 1.2.0 ) 45 Tage 1.107.0 gcp/pubsub
SQS-Verbraucher 45 Tage 1.119.3 sqs-consumer
Azure Storage-Blob 45 Tage 3.4.0 azure/blob

Protokollierung

Online bearbeiten

Die folgende Tabelle gibt einen Überblick über die Protokollierungsbibliotheken, die von den Instana Node.js Tracern unterstützt werden:

Bibliothek Support-Richtlinie Minimal unterstützte Instana-npm-Version Kennung der Instrumentierung [1:5]
Bunyan 45 Tage 1.54.0 bunyan
Express-Winston 45 Tage 1.88.0 winston
log4js 45 Tage 1.84.0 log4js
Pino 45 Tage 1.52.0 pino
Winston (>= 3.x ). 45 Tage 1.53.0 winston
Winston (<= 2.x ) 45 Tage 1.88.0 winston

Andere

Online bearbeiten

In der folgenden Tabelle sind weitere Bibliotheken aufgeführt, die von den Instana Node.js Tracern unterstützt werden:

Bibliothek Support-Richtlinie Minimal unterstützte Instana-npm-Version Kommentar
Apigee Microgateway/edgemicro ( 2.4, 2.5, >= 3.x ) 45 Tage 1.89.0 Erfordert zusätzliche Installationsschritte. [9]
  • Für NATS: Weil NATS keine Nachrichten-Header hat. Weitere Informationen finden Sie in den NATS-Tracing-Dokumenten.
  • Für NATS-Streaming: Da NATS-Streaming keine Nachrichten-Header hat. Weitere Informationen finden Sie in den NATS-Tracing-Dokumenten.
  • Wenn Sie das npm-Paket kafka-node verwenden, um Nachrichten zu senden oder zu empfangen: Weil dieses Paket keine Kafka Datensatz-Header unterstützt. Weitere Informationen finden Sie unter kafka-node#763 und kafka-node#1309. Trace Continuity wird für Kafka generell ab Kafka 0.11 für andere Laufzeiten und auch bei Verwendung des Pakets kafkajs unterstützt. Daher müssen Sie kafkajs anstelle von kafka-node verwenden, wenn Sie Kafka und Instana in Ihrer Node.js Anwendung verwenden.
  • Wenn Sie verwenden, um node-rdkafka Nachrichten als Streams zu erzeugen, bei denen die objectMode Option nicht auf truegesetzt ist.

OpenTelemetry messgeräte

Online bearbeiten

Instana verwendet bestimmte OpenTelemetry Instrumentierungen, um die Abdeckung der Bibliothek zu erhöhen.

Die folgende Tabelle gibt einen Überblick über die OpenTelemetry Instrumente, die von den Instana Node.js Tracern unterstützt werden:

Bibliothek Support-Richtlinie Minimal unterstützte Instana-npm-Version Kennung der Instrumentierung [1:7]
fs 45 Tage 2.24.0
oracleDb 45 Tage 4.24.0
restify 45 Tage 2.24.0
socket.io 45 Tage 2.24.0
socket.io-client 45 Tage 2.24.0
tedious 45 Tage 3.2.0
Hinweis: Wenn Sie Probleme mit der Integration von OpenTelemetry haben, können Sie sie deaktivieren. Weitere Informationen zum Deaktivieren der Integration finden Sie unter Deaktivieren der OpenTelemetry Integration.

  1. Die Instrumentierungskennung ist der interne Name, der in der Anwendungskonfiguration verwendet wird, um die Ablaufverfolgung für eine bestimmte Bibliothek zu aktivieren oder zu deaktivieren. ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎

  2. Die npm request-promise Bibliothek ist offiziell veraltet. Weitere Informationen finden Sie unter request-promise. ︎

  3. Die npm-Request-Bibliothek ist offiziell veraltet. Weitere Informationen erhalten Sie auf Anfrage. ︎

  4. Die Apollo Federation Bibliothek ist offiziell veraltet. Weitere Informationen finden Sie unter Apollo Federation. ︎

  5. Instana instrumentiert Sequelize nicht direkt, sondern die zugrunde liegenden Datenbanktreiber. Die Sichtbarkeit von sequelize-Aktionen hängt von der Datenbankbibliothek ab, die Sie zusammen mit sequelize verwenden (mysql, mysql2, mssql, pg, und pg-native). ︎

  6. Um nachfolgende Anrufe korrekt zu erfassen, nachdem Sie eine Nachricht mit AWS SQS, kafkajs, kafka-node, node-rdkafka, RabbitMQ, amqplib, NATS, NATS-Streaming oder erhalten haben Google CloudPubSub,, müssen Sie und span.disableAutoEnd() verwenden span.end(). Weitere Informationen finden Sie unter Manuelles Beenden von Spannen. ︎ ︎ ︎

  7. AWS SQS erfordert die manuelle Wiederherstellung des asynchronen Kontexts, wenn Sie Versprechen mit async oder await verwenden. ︎ ︎

  8. AWS SDK v2 ist offiziell veraltet. Weitere Informationen finden Sie unter AWS v3 SDK-Migration ↩ ↩ ↩ ↩ ↩ ↩.

  9. Die Verwendung von Apigee Microgateway oder edgemicro erfordert zusätzliche Installationsschritte. Weitere Informationen zu diesem Anwendungsfall finden Sie in der Installationsanleitung. ↩︎