如何在NodeSDK中禁用OpenTelemetry追踪功能？

算力阿峰

2026-7-2

完全禁用OpenTelemetry追踪并保留指标的方案

方案一：全局禁用追踪组件

通过指定NoopTracerProvider（无操作追踪提供者），彻底关闭所有追踪相关功能，同时保留指标收集和所需的instrumentation。这样既不会生成span元数据，也不会产生追踪带来的额外开销。

修改后的代码：

const { NodeSDK } = require('@opentelemetry/sdk-node');
const { PrometheusExporter } = require('@opentelemetry/exporter-prometheus');
const { getNodeAutoInstrumentations } = require('@opentelemetry/auto-instrumentations-node');
const { NoopTracerProvider } = require('@opentelemetry/api');

const sdk = new NodeSDK({
  metricReader: new PrometheusExporter(),
  instrumentations: [getNodeAutoInstrumentations()],
  // 替换为无操作追踪提供者，彻底禁用追踪
  tracerProvider: new NoopTracerProvider(),
  // 可选：禁用上下文传播，进一步减少不必要开销
  textMapPropagator: undefined,
});

sdk.start();

方案二：单独配置HTTP Instrumentation（仅关闭HTTP追踪）

如果不需要全局禁用所有追踪，只是想阻止HTTP请求生成span元数据，可以精细化配置HTTP instrumentation，只保留指标收集逻辑，关闭追踪相关的钩子和span创建。

示例代码：

const { NodeSDK } = require('@opentelemetry/sdk-node');
const { PrometheusExporter } = require('@opentelemetry/exporter-prometheus');
const { getNodeAutoInstrumentations } = require('@opentelemetry/auto-instrumentations-node');

const sdk = new NodeSDK({
  metricReader: new PrometheusExporter(),
  instrumentations: [getNodeAutoInstrumentations({
    '@opentelemetry/instrumentation-http': {
      // 禁用span创建逻辑
      createSpan: () => false,
      // 清空追踪相关钩子，避免生成元数据
      traceRequestHook: () => {},
      traceResponseHook: () => {},
    },
  })],
});

sdk.start();