Configuración de la instrumentación sin código

Aprende a configurar la instrumentación sin código para Node.js

Este módulo es altamente configurable mediante variables de entorno. Puedes configurar muchos aspectos del comportamiento de la instrumentación automática según tus necesidades, como los detectores de recursos, los exportadores, las cabeceras de propagación del contexto de traza y más.

Configuración del SDK y del exportador

La configuración del SDK y del exportador se puede establecer mediante variables de entorno.

Configuración de los detectores de recursos del SDK

De forma predeterminada, el módulo habilita todos los detectores de recursos del SDK. Puedes usar la variable de entorno OTEL_NODE_RESOURCE_DETECTORS para habilitar solo algunos detectores o deshabilitar la detección por completo:

  • env
  • host
  • os
  • process
  • serviceinstance
  • container
  • alibaba
  • aws
  • azure
  • gcp
  • all: habilita todos los detectores de recursos
  • none: deshabilita la detección de recursos

Por ejemplo, para habilitar solo los detectores env y host, puedes establecer:

OTEL_NODE_RESOURCE_DETECTORS=env,host

Excluir librerías de instrumentación

De forma predeterminada, todas las librerías de instrumentación compatibles están habilitadas, pero puedes usar variables de entorno para habilitar o deshabilitar instrumentaciones específicas.

Habilitar instrumentaciones específicas

Usa la variable de entorno OTEL_NODE_ENABLED_INSTRUMENTATIONS para habilitar solo ciertas instrumentaciones, indicando una lista separada por comas con los nombres de las librerías de instrumentación sin el prefijo @opentelemetry/instrumentation-.

Por ejemplo, para habilitar solo las instrumentaciones @opentelemetry/instrumentation-http y @opentelemetry/instrumentation-express:

OTEL_NODE_ENABLED_INSTRUMENTATIONS="http,express"

Deshabilitar instrumentaciones específicas

Usa la variable de entorno OTEL_NODE_DISABLED_INSTRUMENTATIONS para mantener habilitada la lista completa y deshabilitar solo ciertas instrumentaciones, indicando una lista separada por comas con los nombres de las librerías de instrumentación sin el prefijo @opentelemetry/instrumentation-.

Por ejemplo, para deshabilitar solo las instrumentaciones @opentelemetry/instrumentation-fs y @opentelemetry/instrumentation-grpc:

OTEL_NODE_DISABLED_INSTRUMENTATIONS="fs,grpc"