Informations de support

Instana suit le calendrier officiel de prise en charge à long terme (LTS) et de fin de vie (EOL) disponible sur Node.js pour le suivi de Node.js.

Lorsqu'une version d' Node.js e arrive à sa date de fin de vie, il est proposé de bénéficier d'au moins un an de support supplémentaire. Pour éviter d'éventuels problèmes, mettez régulièrement à jour votre version d' Node.js.

Le collecteur Instana Node.js envoie un événement de problème lorsque des applications s'exécutent sous une version en fin de vie d' Node.js.

Les modifications importantes suivantes ont été introduites dans la version 6. Pour plus d'informations, consultez le journal des modifications de GitHub

• La priorité de configuration est mise à jour. Le nouvel ordre de priorité de configuration est le suivant :

  1. Variables d'environnement (priorité maximale)
  2. Configuration dans le code
  3. Configuration de l'agent
  4. Valeurs par défaut

• La variable INSTANA_DEV_MIN_DELAY_BEFORE_SENDING_SPANS d'environnement est remplacée par INSTANA_TRACING_TRANSMISSION_DELAY.

La prise en charge des éléments suivants n'est plus assurée. Pour plus d'informations sur les modifications importantes apportées à la version 5, consultez le journal des modifications sur GitHub.

• Node.js Les versions antérieures à 18.19.0 ne sont plus prises en charge. Vous devez effectuer une mise à niveau vers la version Node.js 18.19.0 ou une version ultérieure.

• La prise en charge héritée d'ESM qui utilise --experimental-loader et esm-loader.mjs a été supprimée. Veillez à utiliser --import avec esm-register.mjs dans votre script d'initialisation du collecteur. Pour plus d'informations, consultez la section « Installation de Collector – ECMAScript ».

• Les variables d'environnement INSTANA_DISABLED_TRACERS et INSTANA_DISABLE_TRACING, ainsi que l'option de configuration tracing.disabledTracers , sont supprimées. Modifiez votre configuration pour utiliser INSTANA_TRACING_DISABLE et tracing.disable à la place. Pour plus d'informations, consultez la section « Désactivation de tous les suivis ».

• La prise en charge du paquet kafka-avro n'est plus assurée. Pour plus d'informations, voir kafka-avro.

• La prise en charge de AWS SDK v2 est obsolète. Pour plus d'informations, consultez AWS SDK v2 et le SDK AWS pour JavaScript v3.

• Dans le webhook « Instana AutoTrace », l'option autotrace.nodejs.application_type de configuration ne prend plus en charge l'ancienne module_v1 valeur. Utilisez module_v2 plutôt. Pour plus d'informations, consultez la section « Modules ECMAScript » du document « Node.js ».

  Remarque : l'ordre de priorité des configurations sera modifié dans la prochaine version majeure.

La prise en charge des technologies suivantes est interrompue. Pour plus d'informations sur les changements de la version 3, voir le changelog de GitHub.

• La prise en charge de Node.js 14 et 16 n'est plus assurée. Vous devez passer à Node.js 18.0.0 ou à une version ultérieure.

• La prise en charge des runtimes Node.js Lambda v14 et v16 est interrompue.

• L'option permettant de configurer le format d'en-tête Kafka est supprimée et les en-têtes sont désormais envoyés au format string, ce qui élimine la prise en charge du format binary. Supprimez toute référence à la variable d'environnement INSTANA_KAFKA_HEADER_FORMAT ou à l'option de configuration intégrée au code pour tracing: { kafka: { headerFormat: .... }}}. Pour plus d'informations sur la migration Kafka, voir kafka-header-migration phase 2.

• La prise en charge de l'en-tête X-Instana-Service est supprimée. Pour enregistrer X-Instana-Service l'en-tête, vous devez le configurer dans le fichier de configuration de l'agent configuration.yamlInstana. Pour plus d'informations, consultez la section « Capture des en-têtes personnalisés d' HTTP ».

• Les variables d'environnement INSTANA_URL et INSTANA_KEY sont supprimées. Remplacez toutes les occurrences de ces termes par INSTANA_ENDPOINT_URL et INSTANA_AGENT_KEY .

• La prise en charge de la désactivation de l'instrumentation du SDK AWS via aws-sdk/v2/index est abandonnée ; à la place, utilisez aws-sdk/v2. Pour plus d'informations, voir la désactivation du traceur.

• La prise en charge du paquet q n'est plus assurée. Pour plus d'informations, consultez q .

• La prise en charge du paquet kafka-avro est obsolète. Pour plus d'informations, consultez kafka-avro .

La prise en charge des technologies suivantes est interrompue. Pour plus d'informations sur les changements de la version 3, voir le changelog de GitHub.

• La prise en charge de Node.js 10 et 12 n'est plus assurée. Mettez à jour vers Node.js 14.0.0 ou plus récent.

• Le /opt/instana/instrumentation/nodejs/runtime-version-switch Le script interne a été supprimé du webhook Instana AutoTrace. Si vous obtenez le message d'erreur runtime-version-switch module not found, consultez la section Dépannage.

• La prise en charge de la bibliothèque Elasticsearch est supprimée.

  Avant de passer à la version 3, vous devez migrer vers @elastic/elasticsearch.

• La prise en charge de la bibliothèque gRPC est supprimée.

  Avant de passer à la version 3, vous devez migrer vers @grpc/grpc-js.

• La prise en charge de redis 0 est abandonnée. Pour plus d'informations, voir redis.

• La prise en charge de MSSQL 8 n'est plus assurée. Pour plus d'informations, voir node-mssql.

• La prise en charge de GraphQL 14 n'est plus assurée. Pour plus d'informations, voir graphql-js.

• La bibliothèque kafka-node est officiellement obsolète.

• La prise en charge de fastify 1 est interrompue.

Pour plus d'informations sur les changements de la version 2, voir le changelog de GitHub.

• La prise en charge des nœuds 6 et 8 est supprimée à partir de la version 2.0.0 de tous les paquets Instana npm (@instana/collector, @instana/aws-fargate, @instana/aws-lambda, et @instana/google-cloud-run). Mettez à jour votre version d' Node.js vers au moins la version 10.4.0.

• La prise en charge de reportUncaughtException est supprimée. Cette fonctionnalité est obsolète depuis la version 1.112.0 Si vous avez utilisé cette fonction auparavant, vous pouvez utiliser la fonction de détection de fin de processus anormal à la place. La détection de l'arrêt anormal d'un processus est activée par défaut.

• L'option de configuration timeBetweenHealthcheckCalls est déplacée de instana({ tracing: { timeBetweenHealthcheckCalls: Boolean }}) à instana({ tracing: { metrics: { timeBetweenHealthcheckCalls }}}). Pour plus d'informations, voir la référence de la configuration complète.

• L'option de configuration pour logger est supprimée. Vous ne pouvez plus utiliser instana({logger: logger}). Utilisez instana.setLogger(logger) à la place. Pour plus d'informations, voir le paramétrage de l'enregistreur après l'initialisation.

• L'option de configuration disableAutomaticTracing est supprimée. Vous ne pouvez plus utiliser instana({ tracing: { disableAutomaticTracing: Boolean }}). Utilisez instana({ tracing: { automaticTracingEnabled: Boolean }}) à la place. Pour plus d'informations, voir la désactivation du traçage automatique.