Configuration de l'instrumentation Zero-Code

Apprenez comment configurer l’instrumentation Zero-Code pour Node.js

Ce module est hautement configurable via des variables d’environnement. De nombreux aspects du comportement de l’auto-instrumentation peuvent être configurés selon vos besoins, tels que les détecteurs de ressources, les exportateurs, les en-têtes de propagation du contexte de trace, et plus encore.

Configuration du SDK et des exportateurs

La configuration du SDK et des exportateurs peut être définie en utilisant des variables d’environnement.

Configuration des détecteurs de ressources du SDK

Par défaut, le module activera tous les détecteurs de ressources du SDK. Vous pouvez utiliser la variable d’environnement OTEL_NODE_RESOURCE_DETECTORS pour activer seulement certains détecteurs, ou les désactiver complètement :

  • env
  • host
  • os
  • process
  • serviceinstance
  • container
  • alibaba
  • aws
  • azure
  • gcp
  • all - active tous les détecteurs de ressources
  • none - désactive la détection de ressources

Par exemple, pour activer seulement les détecteurs env et host, vous pouvez définir :

OTEL_NODE_RESOURCE_DETECTORS=env,host

Exclure des bibliothèques d’instrumentation

Par défaut, toutes les bibliothèques d’instrumentation supportées sont activées, mais vous pouvez utiliser des variables d’environnement pour activer ou désactiver des instrumentations spécifiques.

Activer des instrumentations spécifiques

Utilisez la variable d’environnement OTEL_NODE_ENABLED_INSTRUMENTATIONS pour activer seulement certaines instrumentations en fournissant une liste séparée par des virgules des noms de bibliothèques d’instrumentation sans le préfixe @opentelemetry/instrumentation-.

Par exemple, pour activer seulement les instrumentations @opentelemetry/instrumentation-http et @opentelemetry/instrumentation-express :

OTEL_NODE_ENABLED_INSTRUMENTATIONS="http,express"

Désactiver des instrumentations spécifiques

Utilisez la variable d’environnement OTEL_NODE_DISABLED_INSTRUMENTATIONS pour conserver la liste complètement activée et désactiver seulement certaines instrumentations en fournissant une liste séparée par des virgules des noms de bibliothèques d’instrumentation sans le préfixe @opentelemetry/instrumentation-.

Par exemple, pour désactiver seulement les instrumentations @opentelemetry/instrumentation-fs et @opentelemetry/instrumentation-grpc :

OTEL_NODE_DISABLED_INSTRUMENTATIONS="fs,grpc"

Dernière modification August 4, 2025: [fr] Translation of Zero Code JS docs (#7388) (1f88cd39)