newrelic 14.2.0 → 14.3.0

package/NEWS.md

@@ -1,31 +1,88 @@
-### v14.2.0 (2026-07-07)
-
-#### Features
-
-* Added Node.js 26 support ([#4084](https://github.com/newrelic/node-newrelic/pull/4084)) ([4a7f777](https://github.com/newrelic/node-newrelic/commit/4a7f7775d8598656f84bd1590a80e56458feb185))
-* Added `span_id` and `trace_id` labels to `CpuProfiler` sample data ([#4049](https://github.com/newrelic/node-newrelic/pull/4049)) ([c2b1737](https://github.com/newrelic/node-newrelic/commit/c2b1737ac87a26b7fce6d170597301cf97d26b22))
-* Added new GCP Cloud Run hostname logic to include `K_REVISION` ([#4069](https://github.com/newrelic/node-newrelic/pull/4069)) ([02855dc](https://github.com/newrelic/node-newrelic/commit/02855dc82b636c655e9808b50897b4dc5c7b1bba))
-* Added `profiling.source_mapping.enabled` config option ([#4090](https://github.com/newrelic/node-newrelic/pull/4090)) ([43add80](https://github.com/newrelic/node-newrelic/commit/43add80d07cccb1fd48190a60895d88cbde17b00))
-* Removed `spanId` in outgoing `tracestate` header ([#4091](https://github.com/newrelic/node-newrelic/pull/4091)) ([40a8bf1](https://github.com/newrelic/node-newrelic/commit/40a8bf1682860d11f2bf46fbfdaae840b6f3fa18))
-
-#### Code refactoring
-
-* Refactored `mongodb` instrumentation to subscribe to events emitted ([#4059](https://github.com/newrelic/node-newrelic/pull/4059)) ([d2777ba](https://github.com/newrelic/node-newrelic/commit/d2777ba6b29ab30f1a158e993283029bf40cff86))
-
-#### Documentation
-
-* Updated compatibility report ([#4078](https://github.com/newrelic/node-newrelic/pull/4078)) ([047a063](https://github.com/newrelic/node-newrelic/commit/047a063dd9e21097d2995dbd7f14ee564b96efcd))
-
-#### Miscellaneous chores
-
-* Addressed long standing CI flakes ([#4093](https://github.com/newrelic/node-newrelic/pull/4093)) ([ae973a0](https://github.com/newrelic/node-newrelic/commit/ae973a0d7bfd7da54bd0fe5e68d79fa77b180cfe))
-* Fixed package version resolution on Node 26 ([#4094](https://github.com/newrelic/node-newrelic/pull/4094)) ([73d14a9](https://github.com/newrelic/node-newrelic/commit/73d14a98c3bd678be499e14533e66f86b7b9996b))
-
-#### Continuous integration
-
-* Updated `release-creation` to use `lts/*` for node-version ([#4080](https://github.com/newrelic/node-newrelic/pull/4080)) ([7eaed22](https://github.com/newrelic/node-newrelic/commit/7eaed22f92af2da5db31232b60b5bf35f0ca3e02))
-* Updated `setup-node` job to include `check-latest` to ensure we are getting the latest version of node ([#4079](https://github.com/newrelic/node-newrelic/pull/4079)) ([4a425f6](https://github.com/newrelic/node-newrelic/commit/4a425f692c8eacac1e4967e7517c34605f67ad82))
-
+### v14.3.0 (2026-07-14)
+
+#### Features
+
+* Added source mapping support to heap profiler ([#4122](https://github.com/newrelic/node-newrelic/pull/4122)) ([dcee39f](https://github.com/newrelic/node-newrelic/commit/dcee39fa76a102389f9dd7c186461346ef4fa265))
+* Added source mapping support to CPU (wall time) profiler ([#4095](https://github.com/newrelic/node-newrelic/pull/4095)) ([f6123bc](https://github.com/newrelic/node-newrelic/commit/f6123bc939afc0122443fda3eab7d9e842dcbfef))
+* Added `otlp_resource_attributes` to all outgoing OpenTelemetry metrics calls ([#4128](https://github.com/newrelic/node-newrelic/pull/4128)) ([a0c1c5b](https://github.com/newrelic/node-newrelic/commit/a0c1c5b0f314b7ca35b84f0c6cf8229395c4aa52))
+* Added support for `ai_monitoring.enabled`,`ai_monitoring.streaming.enabled`, and `ai_monitoring.record_content.enabled` to be assigned via server-side config ([#4123](https://github.com/newrelic/node-newrelic/pull/4123)) ([c4d8032](https://github.com/newrelic/node-newrelic/commit/c4d8032bb2fcc7e346854b6ae818bea9e17f7f9f))
+
+#### Bug fixes
+
+* Fixed `bunyan` log forwarding multiple duplicate lines ([#4132](https://github.com/newrelic/node-newrelic/pull/4132)) ([b0f4242](https://github.com/newrelic/node-newrelic/commit/b0f4242098ffe8a63566519707987b588b22f6aa))
+* Fixed OTEL crash when adding exceptions to spans ([#4130](https://github.com/newrelic/node-newrelic/pull/4130)) ([508542e](https://github.com/newrelic/node-newrelic/commit/508542e7cb8f2ad11952171a4e44dc71b2d23f07))
+
+#### Documentation
+
+* Updated compatibility report ([#4125](https://github.com/newrelic/node-newrelic/pull/4125)) ([405b59b](https://github.com/newrelic/node-newrelic/commit/405b59b20ed811b31eadc4a85bf8ff6a64c12edd)) ([#4107](https://github.com/newrelic/node-newrelic/pull/4107)) ([267a964](https://github.com/newrelic/node-newrelic/commit/267a964cffdab4373a9292e035cc877b814f8529))
+
+#### Miscellaneous chores
+
+* Changed `notify-release.yml` schedule with our bot user ([#4135](https://github.com/newrelic/node-newrelic/pull/4135)) ([a9318ae](https://github.com/newrelic/node-newrelic/commit/a9318aec1ff32fd8930431b20df7123f76ced513))
+* Changed `versioned-security-agent.yml` schedule with our bot user ([#4134](https://github.com/newrelic/node-newrelic/pull/4134)) ([d7c6f64](https://github.com/newrelic/node-newrelic/commit/d7c6f64af2747a392ac905a1775aa70642a9f9b6))
+* Changed smoke-test schedule with our bot user ([#4133](https://github.com/newrelic/node-newrelic/pull/4133)) ([400268e](https://github.com/newrelic/node-newrelic/commit/400268e98b9d559c1b46726a91f555aeff706bbe))
+* Sharded the versioned tests w/ security agent workflow ([#4119](https://github.com/newrelic/node-newrelic/pull/4119)) ([fe200c4](https://github.com/newrelic/node-newrelic/commit/fe200c4fc1996ce7b115a7ab76e4b84659758d01))
+* Updated test runner to accept suites as positional parameters ([#4117](https://github.com/newrelic/node-newrelic/pull/4117)) ([ac0985d](https://github.com/newrelic/node-newrelic/commit/ac0985d65291eb24637c90e4d96b0e3aff56ecfc))
+
+#### Tests
+
+* Added more scenarios to winston for constructing loggers ([#4120](https://github.com/newrelic/node-newrelic/pull/4120)) ([ea90fc3](https://github.com/newrelic/node-newrelic/commit/ea90fc30719824c8cdd7de67a9af88257ab97805))
+* Added skip for winston test for ranges that do not support it ([#4121](https://github.com/newrelic/node-newrelic/pull/4121)) ([e75e15e](https://github.com/newrelic/node-newrelic/commit/e75e15e3ca3eb7344f9a9697efe9b49fef96f3af))
+* Applied sampling to `pg-native` tests to reduce the matrix under test ([#4124](https://github.com/newrelic/node-newrelic/pull/4124)) ([b1ad2da](https://github.com/newrelic/node-newrelic/commit/b1ad2da853ee55ebe7477ff6a172e454a76d13bd))
+* Fixed flaky amqplib async-work duration assertions ([#4118](https://github.com/newrelic/node-newrelic/pull/4118)) ([3544237](https://github.com/newrelic/node-newrelic/commit/3544237c908f908aad17cf4d6b713015f186be6e))
+* Removed timing race from common.request unit tests ([#4113](https://github.com/newrelic/node-newrelic/pull/4113)) ([b22c25b](https://github.com/newrelic/node-newrelic/commit/b22c25b56f73b9821710e22988a4cdcbfb06d907))
+
+### v14.2.1 (2026-07-09)
+
+#### Bug fixes
+
+* Updated `winston` instrumenting to assign `handleExceptions` to the first NrTransport to avoid registering duplicate `uncaughtException` handlers ([#4108](https://github.com/newrelic/node-newrelic/pull/4108)) ([d60a48d](https://github.com/newrelic/node-newrelic/commit/d60a48d3b9399d3a084c64cf53c3a62c7a4cab0b))
+  * This would create a linear memory leak because the `NrTransport` objects for loggers no longer in use, would not be freed because of the global `process.on('uncaughtException')` handler
+
+#### Documentation
+
+* Updated compatibility report ([#4099](https://github.com/newrelic/node-newrelic/pull/4099)) ([058fde6](https://github.com/newrelic/node-newrelic/commit/058fde6d64e3606b82875380ba51f9bc44a4b994))
+
+#### Continuous integration
+
+* Pinned CI npm to 11 so native versioned suites build on Node 22 ([#4114](https://github.com/newrelic/node-newrelic/pull/4114)) ([b844e94](https://github.com/newrelic/node-newrelic/commit/b844e94317e573410d96f8971308b2d1535570ca))
+* Removed the 8 minute versioned shard timeout ([#4111](https://github.com/newrelic/node-newrelic/pull/4111)) ([0ef6374](https://github.com/newrelic/node-newrelic/commit/0ef63749b2739d7c7446a6b7c6d3ee80d2d360e5))
+* Attempted to fix memcached CI issue again ([#4098](https://github.com/newrelic/node-newrelic/pull/4098)) ([f67fef5](https://github.com/newrelic/node-newrelic/commit/f67fef5febe71ffab853164aba06c76cd2c6c26d))
+* Shard versioned tests across CI runners ([#4101](https://github.com/newrelic/node-newrelic/pull/4101)) ([1471734](https://github.com/newrelic/node-newrelic/commit/14717345d87ec46a4eba18c513e10e3caed40f7c))
+
+#### Tests
+
+* Added `samples` to prisma and next to cut down on versions under test on packages we recommend using hybrid ageninstrumentation ([#4112](https://github.com/newrelic/node-newrelic/pull/4112)) ([7d8bd7c](https://github.com/newrelic/node-newrelic/commit/7d8bd7cd2e3076d17ad25b75628956d1158fc23a))
+* Resolved `grpc` `proto-loader` from the running suite's `node_modules` ([#4110](https://github.com/newrelic/node-newrelic/pull/4110)) ([5b5a9f8](https://github.com/newrelic/node-newrelic/commit/5b5a9f8d8e0f17557b9f202b0098e2ec84c9e028))
+
+### v14.2.0 (2026-07-07)
+
+#### Features
+
+* Added Node.js 26 support ([#4084](https://github.com/newrelic/node-newrelic/pull/4084)) ([4a7f777](https://github.com/newrelic/node-newrelic/commit/4a7f7775d8598656f84bd1590a80e56458feb185))
+* Added `span_id` and `trace_id` labels to `CpuProfiler` sample data ([#4049](https://github.com/newrelic/node-newrelic/pull/4049)) ([c2b1737](https://github.com/newrelic/node-newrelic/commit/c2b1737ac87a26b7fce6d170597301cf97d26b22))
+* Added new GCP Cloud Run hostname logic to include `K_REVISION` ([#4069](https://github.com/newrelic/node-newrelic/pull/4069)) ([02855dc](https://github.com/newrelic/node-newrelic/commit/02855dc82b636c655e9808b50897b4dc5c7b1bba))
+* Added `profiling.source_mapping.enabled` config option ([#4090](https://github.com/newrelic/node-newrelic/pull/4090)) ([43add80](https://github.com/newrelic/node-newrelic/commit/43add80d07cccb1fd48190a60895d88cbde17b00))
+* Removed `spanId` in outgoing `tracestate` header ([#4091](https://github.com/newrelic/node-newrelic/pull/4091)) ([40a8bf1](https://github.com/newrelic/node-newrelic/commit/40a8bf1682860d11f2bf46fbfdaae840b6f3fa18))
+
+#### Code refactoring
+
+* Refactored `mongodb` instrumentation to subscribe to events emitted ([#4059](https://github.com/newrelic/node-newrelic/pull/4059)) ([d2777ba](https://github.com/newrelic/node-newrelic/commit/d2777ba6b29ab30f1a158e993283029bf40cff86))
+
+#### Documentation
+
+* Updated compatibility report ([#4078](https://github.com/newrelic/node-newrelic/pull/4078)) ([047a063](https://github.com/newrelic/node-newrelic/commit/047a063dd9e21097d2995dbd7f14ee564b96efcd))
+
+#### Miscellaneous chores
+
+* Addressed long standing CI flakes ([#4093](https://github.com/newrelic/node-newrelic/pull/4093)) ([ae973a0](https://github.com/newrelic/node-newrelic/commit/ae973a0d7bfd7da54bd0fe5e68d79fa77b180cfe))
+* Fixed package version resolution on Node 26 ([#4094](https://github.com/newrelic/node-newrelic/pull/4094)) ([73d14a9](https://github.com/newrelic/node-newrelic/commit/73d14a98c3bd678be499e14533e66f86b7b9996b))
+
+#### Continuous integration
+
+* Updated `release-creation` to use `lts/*` for node-version ([#4080](https://github.com/newrelic/node-newrelic/pull/4080)) ([7eaed22](https://github.com/newrelic/node-newrelic/commit/7eaed22f92af2da5db31232b60b5bf35f0ca3e02))
+* Updated `setup-node` job to include `check-latest` to ensure we are getting the latest version of node ([#4079](https://github.com/newrelic/node-newrelic/pull/4079)) ([4a425f6](https://github.com/newrelic/node-newrelic/commit/4a425f692c8eacac1e4967e7517c34605f67ad82))
+
 ### v14.1.2 (2026-06-25)
 
 #### Bug fixes

package/lib/agent.js

@@ -397,7 +397,11 @@ Agent.prototype.start = function start(callback) {
   }
   logger.info('Starting New Relic for Node.js connection process.')
 
-  this.collector.connect(function onStartConnect(error, response) {
+  // Build the profiling source mapper once, so it can be reused
+  // across profiling start/stop cycles.
+  this.sourceMapperReady = this.profilingData.initSourceMapper()
+
+  this.collector.connect(async function onStartConnect(error, response) {
     if (error || response.shouldShutdownRun()) {
       agent.healthReporter.setStatus(HealthReporter.STATUS_CONNECT_ERROR)
       agent.setState('errored')
@@ -408,6 +412,9 @@ Agent.prototype.start = function start(callback) {
 
     if (agent.collector.isConnected()) {
       const config = response.payload
+      // await for source mapper before starting the harvester
+      // which registers the profiling aggregator which could take the sourceMapper
+      await agent.sourceMapperReady
 
       const shouldImmediatelyHarvest = !agent.config.no_immediate_harvest
       agent.onConnect(shouldImmediatelyHarvest, () => {
@@ -453,7 +460,6 @@ Agent.prototype.onConnect = function onConnect(shouldImmediatelyHarvest, callbac
   }
 
   this._scheduleHarvests(shouldImmediatelyHarvest, callback)
-
   this.setState('started')
 }
 

package/lib/aggregators/profiling-aggregator.js

@@ -37,6 +37,17 @@ class ProfilingAggregator extends BaseAggregator {
     return this.pprofData
   }
 
+  /**
+   * Builds the profiling SourceMapper once during agent startup so the profilers
+   * resolve frames to their original source. Delegated to the manager, which caches
+   * and consumes it; a no-op unless both profiling and source_mapping are enabled.
+   *
+   * @returns {Promise<void>}
+   */
+  initSourceMapper() {
+    return this.profilingManager.buildSourceMapper()
+  }
+
   /**
    * This overrides the default `start` method
    * as we want to collect profiling data for `cpu` and/or `heap`

package/lib/config/index.js

@@ -141,6 +141,10 @@ function Config(config) {
 
   this.browser_monitoring.loader = 'rum'
   this.browser_monitoring.loader_version = ''
+  // default to empty object, this will get populated
+  // from `onConnect` if hybrid agent is enabled
+  // along with hybrid agent's metrics feature
+  this.otlp_resource_attributes = {}
 
   // Settings to play nice with DLPs (see NODE-1044).
   this.simple_compression = false // Disables subcomponent compression
@@ -357,12 +361,6 @@ Config.prototype._fromServer = function _fromServer(params, key) {
     case 'high_security':
       break
 
-    // interpret AI Monitoring account setting
-    case 'collect_ai':
-      this._disableOption(params.collect_ai, 'ai_monitoring')
-      this.emit('change', this)
-      break
-
     // always accept these settings
     case 'encoding_key':
       this._alwaysUpdateIfChanged(params, key)
@@ -583,6 +581,41 @@ Config.prototype._fromServer = function _fromServer(params, key) {
       }
       break
 
+    // interpret AI Monitoring account setting.
+    // `ai_monitoring.enabled` from the connect response server-side config(SSC) takes precedence over
+    // SSC settings come in an `agent_config` object
+    // `collect_ai`; collect_ai is only the fallback when it is absent.
+    case 'collect_ai':
+      if (!params?.agent_config?.['ai_monitoring.enabled']) {
+        this._disableOption(params.collect_ai, 'ai_monitoring')
+        this.emit('change', this)
+      }
+      break
+    case 'ai_monitoring.enabled':
+      this._updateNestedIfChanged(
+        params,
+        this.ai_monitoring,
+        'ai_monitoring.enabled',
+        'enabled'
+      )
+      break
+    case 'ai_monitoring.streaming.enabled':
+      this._updateNestedIfChanged(
+        params,
+        this.ai_monitoring.streaming,
+        'ai_monitoring.streaming.enabled',
+        'enabled'
+      )
+      break
+    case 'ai_monitoring.record_content.enabled':
+      this._updateNestedIfChanged(
+        params,
+        this.ai_monitoring.record_content,
+        'ai_monitoring.record_content.enabled',
+        'enabled'
+      )
+      break
+
     case 'profiling.enabled':
       this._updateNestedIfChanged(
         params,
@@ -592,6 +625,10 @@ Config.prototype._fromServer = function _fromServer(params, key) {
       )
       break
 
+    case 'otlp_resource_attributes':
+      this.otlp_resource_attributes = params.otlp_resource_attributes ?? {}
+      break
+
     // These settings are not allowed from the server.
     case 'attributes.enabled':
     case 'attributes.exclude':

package/lib/context-manager/async-local-context-manager.js

@@ -30,7 +30,11 @@ class AsyncLocalContextManager {
    * @returns {object} The current active context.
    */
   getContext() {
-    return this._asyncLocalStorage.getStore() || (this.isOtelBridgeMode ? new OtelContext() : new Context())
+    return this._asyncLocalStorage.getStore() || (
+      this.isOtelBridgeMode
+        ? new OtelContext()
+        : new Context()
+    )
   }
 
   /**

package/lib/otel/fake-span.js

@@ -10,12 +10,29 @@
  * within otel bridge. We have to create fake spans for new relic
  * segments.  The only thing needed is a method for `spanContext`
  * which should return the spanId(segment id) and traceId(transaction trace id).
- * We hardcode traceFlags to 1.
+ * We hard code traceFlags to 1.
+ *
+ * Note: as of 2026-07 we stub methods on this object that do not make sense
+ * in the context of our bridge. For example, we internally manage the name
+ * and lifecyle of spans. So those methods are no-ops here.
+ *
+ * @see https://open-telemetry.github.io/opentelemetry-js/interfaces/_opentelemetry_api._opentelemetry_api.Span.html
  */
 module.exports = class FakeSpan {
+  #segment
+  #transaction
+
   constructor(segment, transaction) {
-    this.segmentId = segment.id
-    this.traceId = transaction.traceId
+    this.#segment = segment
+    this.#transaction = transaction
+  }
+
+  get segmentId() {
+    return this.#segment.id
+  }
+
+  get traceId() {
+    return this.#transaction.traceId
   }
 
   spanContext() {
@@ -25,4 +42,103 @@ module.exports = class FakeSpan {
       traceFlags: 1
     }
   }
+
+  /**
+   * Adds a new attribute to the backing segment.
+   *
+   * @param {string} key The attribute name to add
+   * @param {*} value Some serializable JavaScript value.
+   *
+   * @returns {FakeSpan}
+   */
+  setAttribute(key, value) {
+    this.#segment.addAttribute(key, value)
+    return this
+  }
+
+  /**
+   * Add multiple attributes to the backing segment at once.
+   *
+   * @param {object} attributes Each field name is the key, and each field
+   * value the value passed to {@link #setAttribute}.
+   *
+   * @returns {FakeSpan}
+   */
+  setAttributes(attributes) {
+    for (const [k, v] of Object.entries(attributes)) {
+      this.setAttribute(k, v)
+    }
+    return this
+  }
+
+  addEvent(name, _attrsOrTime, _time) {
+    this.#segment.logger.warn(
+      'addEvent is not implemented. Not adding event: %s.',
+      name
+    )
+    return this
+  }
+
+  /**
+   * Adds a new span link to the backing segment.
+   *
+   * @param {object} link An OTEL shaped span link.
+   *
+   * @see https://open-telemetry.github.io/opentelemetry-js/interfaces/_opentelemetry_api._opentelemetry_api.Link.html
+   *
+   * @returns {FakeSpan}
+   */
+  addLink(link) {
+    this.#segment.addSpanLink(link)
+    return this
+  }
+
+  /**
+   * Adds multiple span links to the backing segment at once.
+   *
+   * @param {object[]} links A list of OTEL shaped span links.
+   *
+   * @see @see https://open-telemetry.github.io/opentelemetry-js/interfaces/_opentelemetry_api._opentelemetry_api.Link.html
+   *
+   * @returns {FakeSpan}
+   */
+  addLinks(links) {
+    for (const link of links) {
+      this.addLink(link)
+    }
+    return this
+  }
+
+  setStatus(otelSpanStatus) {
+    this.#segment.logger.warn(
+      'setStatus is not implemented. Not setting status: %s.',
+      otelSpanStatus?.code
+    )
+    return this
+  }
+
+  updateName(name) {
+    this.#segment.logger.warn(
+      'updateName is not implemented. Not setting name: %s.',
+      name
+    )
+    return this
+  }
+
+  end(_time) {
+    this.#segment.logger.warn(
+      'end is not implemented. Not ending span.'
+    )
+  }
+
+  isRecording() {
+    return true
+  }
+
+  recordException(exception, time) {
+    // This replicates what the original actually does.
+    // See:
+    // https://github.com/open-telemetry/opentelemetry-js/blob/9b05f66/packages/sdk-trace/src/Span.ts#L427-L451.
+    this.addEvent(exception, null, time)
+  }
 }

package/lib/otel/metrics/index.js

@@ -115,7 +115,7 @@ class SetupMetrics extends SetupSignal {
           { agent, logger }
         )
 
-        const resource = resourceFromAttributes({ 'entity.guid': config.entity_guid })
+        const resource = resourceFromAttributes({ 'entity.guid': config.entity_guid, ...config.otlp_resource_attributes })
         // Assigning the resource after having received the `entity.guid` from
         // the server is a key detail of this implementation. Unfortunately,
         // we don't have real public access to the object that retains the

package/lib/profiling/index.js

@@ -16,17 +16,26 @@ class ProfilingManager {
     this.samplingInterval = samplingInterval
     this.profilers = new Map()
     this.startTime = null
+    this.sourceMapper = null
   }
 
   register() {
     if (this.config.include.includes('heap') && !this.profilers.has('HeapProfiler')) {
       const { HeapProfiler } = require('./profilers')
-      this.profilers.set('HeapProfiler', new HeapProfiler({ logger: this.logger }))
+      this.profilers.set('HeapProfiler', new HeapProfiler({
+        logger: this.logger,
+        sourceMapper: this.sourceMapper
+      }))
     }
 
     if (this.config.include.includes('cpu') && !this.profilers.has('CpuProfiler')) {
       const { CpuProfiler } = require('./profilers')
-      this.profilers.set('CpuProfiler', new CpuProfiler({ logger: this.logger, samplingInterval: this.samplingInterval, tracer: this.tracer }))
+      this.profilers.set('CpuProfiler', new CpuProfiler({
+        logger: this.logger,
+        samplingInterval: this.samplingInterval,
+        tracer: this.tracer,
+        sourceMapper: this.sourceMapper
+      }))
     }
   }
 
@@ -84,6 +93,31 @@ class ProfilingManager {
 
     return results
   }
+
+  /**
+   * Builds the `pprof` SourceMapper once by scanning the app root for source
+   * maps and caches it for the profilers to resolve frames to their original
+   * source. A no-op unless `source_mapping` is enabled; on failure, the mapper
+   * stays `null` and frames fall back to compiled file/line.
+   *
+   * @returns {Promise<void>}
+   */
+  async buildSourceMapper() {
+    if (!(this.config.enabled && this.config.source_mapping.enabled)) {
+      return
+    }
+
+    // lazy-require so pprof's native binding only loads when source mapping is enabled
+    const { SourceMapper } = require('@datadog/pprof')
+    const searchDir = process.cwd()
+    try {
+      const start = Date.now()
+      this.sourceMapper = await SourceMapper.create([searchDir])
+      this.logger.debug(`Built profiling SourceMapper from ${searchDir} in ${Date.now() - start} ms.`)
+    } catch (error) {
+      this.logger.error({ error }, `Failed to build profiling SourceMapper from ${searchDir}, frames will report compiled file/line.`)
+    }
+  }
 }
 
 module.exports = ProfilingManager

package/lib/profiling/profilers/base.js

@@ -6,8 +6,17 @@
 'use strict'
 
 class BaseProfiler {
-  constructor({ logger }) {
+  /**
+   * pprof `SourceMapper` to be shared across the entire agent
+   * instance, or `null`/`undefined` if disabled.
+   * When set, pprof resolves sample frames to their original
+   * source at serialization (e.g. TypeScript, minified code).
+   */
+  sourceMapper
+
+  constructor({ logger, sourceMapper }) {
     this.logger = logger
+    this.sourceMapper = sourceMapper
   }
 
   start() {

package/lib/profiling/profilers/cpu.js

@@ -58,8 +58,8 @@ class CpuProfiler extends BaseProfiler {
    */
   #asyncHook
 
-  constructor({ logger, samplingInterval, tracer }) {
-    super({ logger })
+  constructor({ logger, samplingInterval, tracer, sourceMapper }) {
+    super({ logger, sourceMapper })
     this.#pprof = require('@datadog/pprof')
     this.#kSampleCount = this.#pprof.time.constants.kSampleCount
     this.#tracer = tracer
@@ -82,7 +82,8 @@ class CpuProfiler extends BaseProfiler {
       // needed for trace_id + span_id label
       withContexts: true,
       // carry the sample context per async-context-frame when ACF is active
-      useCPED: this.#useCPED
+      useCPED: this.#useCPED,
+      sourceMapper: this.sourceMapper
     })
 
     if (this.#useCPED) {

package/lib/profiling/profilers/heap.js

@@ -11,8 +11,8 @@ class HeapProfiler extends BaseProfiler {
   #pprof
   #intervalBytes = 524288 // captures stack trace every 512 kb of allocated memory
   #stackDepth = 64
-  constructor({ logger }) {
-    super({ logger })
+  constructor({ logger, sourceMapper }) {
+    super({ logger, sourceMapper })
     this.#pprof = require('@datadog/pprof')
   }
 
@@ -30,7 +30,7 @@ class HeapProfiler extends BaseProfiler {
   }
 
   async collect() {
-    const profile = this.#pprof.heap.profile()
+    const profile = this.#pprof.heap.profile(undefined, this.sourceMapper)
     return this.#pprof.encode(profile)
   }
 }

package/lib/subscribers/ai-monitoring/base.js

@@ -26,8 +26,23 @@ class AiMonitoringSubscriber extends Subscriber {
     this.trackingPrefix = trackingPrefix
   }
 
-  get enabled() {
-    return super.enabled && this.agent.config.ai_monitoring.enabled === true
+  /**
+   * Checks if AI monitoring is enabled. The subscriber itself is registered
+   * regardless of this value (gated only by `instrumentation.<lib>.enabled`),
+   * but AI monitoring behavior (segments, events, metrics) is gated on this.
+   * @returns {boolean} if AI monitoring is enabled
+   */
+  get aiEnabled() {
+    return this.agent.config.ai_monitoring.enabled === true
+  }
+
+  /**
+   * Checks if AI monitoring streaming is enabled.  It is predicated on AI monitoring being enabled
+   * as if it isn't, no instrumentation should occur
+   * @returns {boolean} if we should be instrumenting streams
+   */
+  get streamingEnabled() {
+    return this.aiEnabled && this.agent.config.ai_monitoring.streaming.enabled === true
   }
 
   set name(name) {
@@ -96,7 +111,7 @@ class AiMonitoringSubscriber extends Subscriber {
    * @returns {Context} either new context or existing
    */
   handler(data, ctx) {
-    if (!this.enabled) {
+    if (!this.aiEnabled) {
       this.logger.debug('`ai_monitoring.enabled` is set to false, not creating segment.')
       return ctx
     }

package/lib/subscribers/ai-monitoring/chat.js

@@ -23,10 +23,6 @@ class AiMonitoringChatSubscriber extends AiMonitoringSubscriber {
     super({ agent, logger, packageName, channelName, name, trackingPrefix })
   }
 
-  get streamingEnabled() {
-    return this.agent.config.ai_monitoring.streaming.enabled === true
-  }
-
   /**
    * Function that must be implemented by inherited subscriber to create an llm completion message.
    *
@@ -86,7 +82,7 @@ class AiMonitoringChatSubscriber extends AiMonitoringSubscriber {
    * @param {Array} params.tags used only for langchain events at the moment
    */
   recordChatCompletionEvents({ ctx, request, response, err, timeOfFirstToken, metadata = {}, tags = [] }) {
-    if (!this.enabled) {
+    if (!this.aiEnabled) {
       this.logger.debug('config.ai_monitoring.enabled is set to false, not creating chat completion events.')
       return
     }

package/lib/subscribers/ai-monitoring/embedding.js

@@ -46,7 +46,7 @@ class AiMonitoringEmbeddingSubscriber extends AiMonitoringSubscriber {
    * @param {object} params.err error if present
    */
   recordEmbedding({ ctx, request, response, err }) {
-    if (!this.enabled) {
+    if (!this.aiEnabled) {
       this.logger.debug('config.ai_monitoring.enabled is set to false, not creating embedding event.')
       return
     }

package/lib/subscribers/anthropic-sdk/create.js

@@ -25,7 +25,7 @@ module.exports = class AnthropicChatCreateSubscriber extends AiMonitoringChatSub
 
   asyncEnd(data) {
     const { agent, logger } = this
-    if (!this.enabled) {
+    if (!this.aiEnabled) {
       logger.debug('`ai_monitoring.enabled` is set to false, not creating chat completion events.')
       return
     }

package/lib/subscribers/bunyan/index.js

@@ -22,6 +22,16 @@ class BunyanLoggerSubscriber extends BunyanSubscriber {
     const self = this
     if (this.isLogForwardingEnabled()) {
       const logger = data.self
+      // The `Logger` constructor runs for every logger, including every
+      // `logger.child(...)`. Child loggers inherit (copy) or share the parent's
+      // `streams` array, so re-adding our forwarder on each construction would
+      // accumulate duplicate `NRLogForwarder` streams and forward a single log
+      // line multiple times. Only add it if one isn't already present.
+      const alreadyForwarding = logger.streams?.some((s) => s.name === 'NRLogForwarder')
+      if (alreadyForwarding) {
+        return
+      }
+
       logger.addStream({
         name: 'NRLogForwarder',
         type: 'raw',

package/lib/subscribers/google-adk/agent-run-async.js

@@ -33,7 +33,7 @@ module.exports = class GoogleAdkAgentRunSubscriber extends AiMonitoringSubscribe
   // generator is created but before it is consumed by the caller.
   end(data) {
     const { agent, logger } = this
-    if (!this.enabled) {
+    if (!this.aiEnabled) {
       logger.debug('Google ADK instrumentation is disabled, not instrumenting runAsync.')
       return
     }

package/lib/subscribers/google-adk/tool-run-async.js

@@ -36,7 +36,7 @@ module.exports = class GoogleAdkToolRunSubscriber extends AiMonitoringSubscriber
 
   asyncEnd(data) {
     const { agent, logger, toolName, toolInput } = this
-    if (!this.enabled) {
+    if (!this.aiEnabled) {
       logger.debug('Google ADK instrumentation is disabled, not instrumenting FunctionTool.runAsync.')
       return
     }

package/lib/subscribers/google-genai/generate-content-stream.js

@@ -76,11 +76,6 @@ class GoogleGenAIGenerateContentStreamSubscriber extends GoogleGenAIGenerateCont
   }
 
   asyncEnd(data) {
-    // Check config to see if ai_monitoring is still enabled
-    if (!this.enabled) {
-      this.logger.debug('`ai_monitoring.enabled` is set to false, stream will not be instrumented.')
-      return
-    }
     if (!this.streamingEnabled) {
       this.logger.warn(
         '`ai_monitoring.streaming.enabled` is set to `false`, stream will not be instrumented.'

package/lib/subscribers/langchain/runnable-stream.js

@@ -12,10 +12,6 @@ class LangchainRunnableStreamSubscriber extends LangchainRunnableSubscriber {
   }
 
   asyncEnd(data) {
-    if (!this.enabled) {
-      this.logger.debug('`ai_monitoring.enabled` is set to false, stream will not be instrumented.')
-      return
-    }
     if (!this.streamingEnabled) {
       this.logger.debug('`ai_monitoring.streaming.enabled` is set to false, stream will not be instrumented.')
       this.agent.metrics.getOrCreateMetric(STREAMING_DISABLED).incrementCallCount()

package/lib/subscribers/langchain/tool.js

@@ -27,7 +27,7 @@ class LangchainToolSubscriber extends AiMonitoringSubscriber {
   asyncEnd(data) {
     // Extract data and exit early if need be.
     const { agent, logger } = this
-    if (!this.enabled) {
+    if (!this.aiEnabled) {
       logger.debug('Langchain instrumentation is disabled, not recording Llm events.')
       return
     }

package/lib/subscribers/langchain/vectorstore.js

@@ -84,7 +84,7 @@ class LangchainVectorstoreSubscriber extends AiMonitoringSubscriber {
   }
 
   asyncEnd(data) {
-    if (!this.enabled) {
+    if (!this.aiEnabled) {
       this.logger.debug('Langchain instrumentation is disabled, not recording Llm events.')
       return
     }

package/lib/subscribers/langgraph/graph-stream.js

@@ -21,10 +21,6 @@ class LangGraphStreamSubscriber extends AiMonitoringSubscriber {
     this.events = ['asyncEnd']
   }
 
-  get streamingEnabled() {
-    return this.agent.config.ai_monitoring.streaming.enabled
-  }
-
   handler(data, ctx) {
     // Store LangGraph AI agent name and update
     // segment name to use it.
@@ -35,10 +31,7 @@ class LangGraphStreamSubscriber extends AiMonitoringSubscriber {
 
   asyncEnd(data) {
     const { agent, logger, aiAgentName } = this
-    if (!this.enabled) {
-      logger.debug('LangGraph instrumentation is disabled, not instrumenting stream.')
-      return
-    }
+
     if (!this.streamingEnabled) {
       logger.debug('LangGraph streaming instrumentation is disabled, not instrumenting stream.')
       this.agent.metrics.getOrCreateMetric(STREAMING_DISABLED).incrementCallCount()

package/lib/subscribers/openai/chat.js

@@ -35,7 +35,7 @@ class OpenAIChatCompletions extends AiMonitoringChatSubscriber {
   }
 
   asyncEnd(data) {
-    if (!this.enabled) {
+    if (!this.aiEnabled) {
       this.logger.debug('`ai_monitoring.enabled` is set to false, stream will not be instrumented.')
       return
     }

package/lib/subscribers/winston/configure.js

@@ -12,11 +12,18 @@ const NrTransport = require('./nr-winston-transport.js')
  * during initial construction and on any subsequent reconfiguration.
  *
  * Handles `NrTransport` injection (after `configure` runs, via `end`).
+ *
+ * @property {boolean} handlingExceptions Indicates if this instrumentation has
+ * already registered a global exception handler or not. We only need a single
+ * exception handler per process.
  */
 module.exports = class WinstonConfigure extends ApplicationLogsSubscriber {
   constructor({ agent, logger }) {
     super({ agent, logger, channelName: 'nr_configure', packageName: 'winston' })
     this.events = ['end']
+    // we only want to assign `handleExceptions` to the first NrTransport
+    // customers could be constructing multiple logger instances
+    this.handlingExceptions = false
   }
 
   handler(data, ctx) {
@@ -39,11 +46,12 @@ module.exports = class WinstonConfigure extends ApplicationLogsSubscriber {
     const hasNrTransport = logger.transports?.some((t) => t.name === 'newrelic')
     if (!hasNrTransport) {
       const nrTransport = new NrTransport({ agent: this.agent })
-      // Only handle exceptions if the logger has user-configured transports.
-      // This prevents the default logger (created during require('winston')
-      // module init with no transports) from double-handling exceptions.
-      if (logger.transports.length === 0) {
-        nrTransport.handleExceptions = false
+      // assigning `transport.handleExceptions` adds a global `process.on('uncaughtException')`
+      // handler. Doing it for more than one NrTransport instance will cause duplicate log lines
+      if (this.handlingExceptions === false && logger.transports.length > 0) {
+        // See: https://github.com/winstonjs/winston#handling-uncaught-exceptions-with-winston
+        nrTransport.handleExceptions = true
+        this.handlingExceptions = true
       }
       logger.add(nrTransport)
     }

package/lib/subscribers/winston/nr-winston-transport.js

@@ -14,12 +14,15 @@ const { truncate } = require('../../util/application-logging')
  *
  * Note*: This copies the log line so no other transports will get the
  * mutated data.
+ *
+ * @property {string} name name of the transport
+ * @property {Agent} agent the instance of agent
+ * @property {object} config the agent configuration
+ * @property {boolean} handleExceptions set in `lib/subscribers/winston/configure.js` for the first NrTransport instance
+ * to ensure that only one is handling uncaught exceptions in winston transports
  */
 class NrTransport extends TransportStream {
   constructor(opts = {}) {
-    // set this option to have winston handle uncaught exceptions
-    // See: https://github.com/winstonjs/winston#handling-uncaught-exceptions-with-winston
-    opts.handleExceptions = true
     super(opts)
     this.name = 'newrelic'
     this.agent = opts.agent

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "newrelic",
-  "version": "14.2.0",
+  "version": "14.3.0",
   "author": "New Relic Node.js agent team <nodejs@newrelic.com>",
   "license": "Apache-2.0",
   "contributors": [
@@ -170,7 +170,7 @@
     "lint:fix": "eslint --fix .",
     "public-docs": "jsdoc -c ./jsdoc-conf.jsonc",
     "publish-docs": "./bin/publish-docs.sh",
-    "services": "DOCKER_PLATFORM=linux/$(uname -m) docker compose up -d --wait",
+    "services": "./bin/start-services.sh",
     "services:start": "npm run services",
     "services:stop": "docker compose down",
     "smoke": "time borp --timeout 180000 --reporter ./test/lib/test-reporter.mjs 'test/smoke/**/*.test.js'",