import { _optionalChain } from '@sentry/utils'; import moduleModule from 'module'; import { diag, DiagLogLevel } from '@opentelemetry/api'; import { Resource } from '@opentelemetry/resources'; import { BasicTracerProvider } from '@opentelemetry/sdk-trace-base'; import { ATTR_SERVICE_NAME, SEMRESATTRS_SERVICE_NAMESPACE, ATTR_SERVICE_VERSION } from '@opentelemetry/semantic-conventions'; import { SDK_VERSION } from '@sentry/core'; import { SentrySampler, SentrySpanProcessor, SentryPropagator } from '@sentry/opentelemetry'; import { logger, GLOBAL_OBJ, consoleSandbox } from '@sentry/utils'; import { createAddHookMessageChannel } from 'import-in-the-middle'; import { getOpenTelemetryInstrumentationToPreload } from '../integrations/tracing/index.js'; import { SentryContextManager } from '../otel/contextManager.js'; import { isCjs } from '../utils/commonjs.js'; /** * Initialize OpenTelemetry for Node. */ function initOpenTelemetry(client) { if (client.getOptions().debug) { setupOpenTelemetryLogger(); } const provider = setupOtel(client); client.traceProvider = provider; } function getRegisterOptions(esmHookConfig) { if (_optionalChain([esmHookConfig, 'optionalAccess', _ => _.onlyIncludeInstrumentedModules])) { const { addHookMessagePort } = createAddHookMessageChannel(); // If the user supplied include, we need to use that as a starting point or use an empty array to ensure no modules // are wrapped if they are not hooked return { data: { addHookMessagePort, include: esmHookConfig.include || [] }, transferList: [addHookMessagePort] }; } return { data: esmHookConfig }; } /** Initialize the ESM loader. */ function maybeInitializeEsmLoader(esmHookConfig) { const [nodeMajor = 0, nodeMinor = 0] = process.versions.node.split('.').map(Number); // Register hook was added in v20.6.0 and v18.19.0 if (nodeMajor >= 22 || (nodeMajor === 20 && nodeMinor >= 6) || (nodeMajor === 18 && nodeMinor >= 19)) { // We need to work around using import.meta.url directly because jest complains about it. const importMetaUrl = typeof import.meta.url !== 'undefined' ? import.meta.url : undefined; if (!GLOBAL_OBJ._sentryEsmLoaderHookRegistered && importMetaUrl) { try { // @ts-expect-error register is available in these versions moduleModule.register('import-in-the-middle/hook.mjs', importMetaUrl, getRegisterOptions(esmHookConfig)); GLOBAL_OBJ._sentryEsmLoaderHookRegistered = true; } catch (error) { logger.warn('Failed to register ESM hook', error); } } } else { consoleSandbox(() => { // eslint-disable-next-line no-console console.warn( '[Sentry] You are using Node.js in ESM mode ("import syntax"). The Sentry Node.js SDK is not compatible with ESM in Node.js versions before 18.19.0 or before 20.6.0. Please either build your application with CommonJS ("require() syntax"), or use version 7.x of the Sentry Node.js SDK.', ); }); } } /** * Preload OpenTelemetry for Node. * This can be used to preload instrumentation early, but set up Sentry later. * By preloading the OTEL instrumentation wrapping still happens early enough that everything works. */ function preloadOpenTelemetry(options = {}) { const { debug } = options; if (debug) { logger.enable(); setupOpenTelemetryLogger(); } if (!isCjs()) { maybeInitializeEsmLoader(options.registerEsmLoaderHooks); } // These are all integrations that we need to pre-load to ensure they are set up before any other code runs getPreloadMethods(options.integrations).forEach(fn => { fn(); if (debug) { logger.log(`[Sentry] Preloaded ${fn.id} instrumentation`); } }); } function getPreloadMethods(integrationNames) { const instruments = getOpenTelemetryInstrumentationToPreload(); if (!integrationNames) { return instruments; } return instruments.filter(instrumentation => integrationNames.includes(instrumentation.id)); } /** Just exported for tests. */ function setupOtel(client) { // Create and configure NodeTracerProvider const provider = new BasicTracerProvider({ sampler: new SentrySampler(client), resource: new Resource({ [ATTR_SERVICE_NAME]: 'node', // eslint-disable-next-line deprecation/deprecation [SEMRESATTRS_SERVICE_NAMESPACE]: 'sentry', [ATTR_SERVICE_VERSION]: SDK_VERSION, }), forceFlushTimeoutMillis: 500, }); provider.addSpanProcessor( new SentrySpanProcessor({ timeout: client.getOptions().maxSpanWaitDuration, }), ); // Initialize the provider provider.register({ propagator: new SentryPropagator(), contextManager: new SentryContextManager(), }); return provider; } /** * Setup the OTEL logger to use our own logger. */ function setupOpenTelemetryLogger() { const otelLogger = new Proxy(logger , { get(target, prop, receiver) { const actualProp = prop === 'verbose' ? 'debug' : prop; return Reflect.get(target, actualProp, receiver); }, }); // Disable diag, to ensure this works even if called multiple times diag.disable(); diag.setLogger(otelLogger, DiagLogLevel.DEBUG); } export { initOpenTelemetry, maybeInitializeEsmLoader, preloadOpenTelemetry, setupOtel }; //# sourceMappingURL=initOtel.js.map