newrelic 12.22.0 → 12.24.0

package/NEWS.md

@@ -1,3 +1,38 @@
+### v12.24.0 (2025-07-07)
+
+#### Features
+
+* Implemented configurable attribute value size limit ([#3206](https://github.com/newrelic/node-newrelic/pull/3206)) ([08a6eca](https://github.com/newrelic/node-newrelic/commit/08a6eca7cd35811f5bcb4e6c13264eac156b302f))
+
+#### Documentation
+
+* Updated compatibility report ([#3190](https://github.com/newrelic/node-newrelic/pull/3190)) ([72c492c](https://github.com/newrelic/node-newrelic/commit/72c492cf78b6cc52791604ac354e34718c8ae926))
+
+#### Miscellaneous chores
+
+* Rename GCP ID config flag ([#3205](https://github.com/newrelic/node-newrelic/pull/3205)) ([8446f29](https://github.com/newrelic/node-newrelic/commit/8446f29fc6ed469d663e5634540a4afe4932765b))
+
+### v12.23.0 (2025-06-30)
+
+#### Features
+
+* Added ability to report only on entry and exit spans ([#3184](https://github.com/newrelic/node-newrelic/pull/3184)) ([1f909d3](https://github.com/newrelic/node-newrelic/commit/1f909d389f790733c8787a9db8b0ee71c26bb5ed))
+* Added Node.js 24 support ([#3080](https://github.com/newrelic/node-newrelic/pull/3080)) ([a538c2a](https://github.com/newrelic/node-newrelic/commit/a538c2a5e23b96be40fa3c014e60b912f695423e))
+
+#### Documentation
+
+* Updated compatibility report ([#3186](https://github.com/newrelic/node-newrelic/pull/3186)) ([5498c15](https://github.com/newrelic/node-newrelic/commit/5498c15bb6cf3329fe50595da46ab4f2b1385170))
+
+#### Miscellaneous chores
+
+* Fix issues on Node 24 ([#3181](https://github.com/newrelic/node-newrelic/pull/3181)) ([24832df](https://github.com/newrelic/node-newrelic/commit/24832df2984df960a4e44375525a8127a00a637c))
+* Removed force labels on main CI workflow ([#3183](https://github.com/newrelic/node-newrelic/pull/3183)) ([3aaee17](https://github.com/newrelic/node-newrelic/commit/3aaee17586f817ae1a2ab0573570a740bd6397ef))
+* Updated undici tests to unblock CI ([#3185](https://github.com/newrelic/node-newrelic/pull/3185)) ([08261eb](https://github.com/newrelic/node-newrelic/commit/08261ebcdbafdb625a451f4ccec9b0cba7641cc2))
+
+#### Continuous integration
+
+* Fixed the name of todo colum in add to board reusable workflow ([#3178](https://github.com/newrelic/node-newrelic/pull/3178)) ([f216e0c](https://github.com/newrelic/node-newrelic/commit/f216e0c48adf0291bfa38b3edbb04c9dcc96f92c))
+
 ### v12.22.0 (2025-06-24)
 
 #### Features

package/index.js

@@ -5,7 +5,7 @@
 
 'use strict'
 
-const HealthReporter = require('./lib/health-reporter')
+const HealthReporter = require('./lib/health-reporter.js')
 
 // Record opening times before loading any other files.
 const preAgentTime = process.uptime()
@@ -64,8 +64,8 @@ function initialize() {
       throw new Error(message)
     }
 
-    // TODO: Update this check when Node v24 support is added
-    if (psemver.satisfies('>=23.0.0')) {
+    // TODO: Update this check when Node v26 support is added
+    if (psemver.satisfies('>=25.0.0')) {
       logger.warn(
         'New Relic for Node.js %s has not been tested on Node.js %s. Please ' +
           'update the agent or downgrade your version of Node.js',

package/lib/attributes.js

@@ -12,6 +12,7 @@ const byteUtils = require('./util/byte-limit')
 const properties = require('./util/properties')
 
 const MAXIMUM_CUSTOM_ATTRIBUTES = 64
+const MAXIMUM_ATTR_VALUE_LENGTH = 4_096
 
 /**
  * @class
@@ -19,17 +20,25 @@ const MAXIMUM_CUSTOM_ATTRIBUTES = 64
  */
 class Attributes {
   /**
-   * @param {string} scope
+   * @param {object} params Constructor parameters.
+   * @param {string} params.scope
    *  The scope of the attributes this will collect. Must be `transaction` or
    *  `segment`.
-   * @param {number} [limit]
+   * @param {number} [params.limit]
    *  The maximum number of attributes to retrieve for each destination.
+   * @param {number} [params.valueLengthLimit] The maximum length allowed for
+   * attribute values.
    */
-  constructor(scope, limit = Infinity) {
+  constructor({ scope, limit = Infinity, valueLengthLimit = 256 } = {}) {
     this.filter = makeFilter(scope)
     this.limit = limit
     this.attributes = Object.create(null)
     this.attributeCount = 0
+    this.attributeValueLimit = valueLengthLimit
+
+    if (this.attributeValueLimit > MAXIMUM_ATTR_VALUE_LENGTH) {
+      this.attributeValueLimit = MAXIMUM_ATTR_VALUE_LENGTH
+    }
   }
 
   /**
@@ -73,7 +82,7 @@ class Attributes {
 
       attrs[key] =
         typeof attr.value === 'string' && !attr.truncateExempt
-          ? byteUtils.truncate(attr.value, 255)
+          ? byteUtils.truncate(attr.value, this.attributeValueLimit)
           : attr.value
     }
 

package/lib/config/default.js

@@ -233,6 +233,18 @@ defaultConfig.definition = () => ({
       default: true
     },
 
+    /**
+     * Defines the number of characters allowed for each individual attribute's
+     * value. The default is 256 characters, with a maximum of 4,096.
+     */
+    value_size_limit: {
+      formatter: int,
+      /**
+       * Maximum value is 4,096.
+       */
+      default: 256
+    },
+
     /**
      * Prefix of attributes to exclude from all destinations. Allows * as wildcard at end.
      *
@@ -538,6 +550,15 @@ defaultConfig.definition = () => ({
     total_ram_mib: {
       formatter: int,
       default: null
+    },
+
+    /**
+     * When enabled, it will use GCP metadata id
+     * to set the hostname of the running application.
+     */
+    gcp_use_instance_as_host: {
+      default: true,
+      formatter: boolean
     }
   },
   transaction_tracer: {
@@ -1120,6 +1141,19 @@ defaultConfig.definition = () => ({
       default: false
     },
 
+    /**
+     * Controls whether the agent will generate spans for in-process actions.
+     * When disabled, this will only create spans for entry and exit spans.
+     * entry spans - initial actions for web servers and messsage queue consumption.
+     * exit spans - all outgoing calls to external services(external and database calls)
+     */
+    in_process_spans: {
+      enabled: {
+        formatter: boolean,
+        default: true
+      }
+    },
+
     sampler: {
       /**
        * When set to `always_on`, the sampled flag in the `traceparent` header
@@ -1605,17 +1639,6 @@ defaultConfig.definition = () => ({
     }
   },
 
-  /**
-   * When enabled, it will use GCP metadata id
-   * to set the hostname of the running application
-   */
-  gcp_cloud_run: {
-    use_instance_as_host: {
-      default: true,
-      formatter: boolean
-    }
-  },
-
   /**
    * When enabled, it will allow loading of the agent
    * in worker threads.

package/lib/config/index.js

@@ -989,7 +989,7 @@ function getHostnameSafe(gcpId = null) {
     // If not applicable, use the os.hostname()
     if (config.heroku.use_dyno_names && process.env.DYNO) {
       _hostname = process.env.DYNO || os.hostname()
-    } else if (config.gcp_cloud_run.use_instance_as_host && process.env.K_SERVICE && gcpId) {
+    } else if (config.utilization.gcp_use_instance_as_host && process.env.K_SERVICE && gcpId) {
       _hostname = gcpId
     } else {
       _hostname = os.hostname()

package/lib/spans/helpers.js

@@ -60,10 +60,72 @@ function addSpanKind({ segment, span }) {
   }
 }
 
+/**
+ * Checks if the segment is an entry point span.
+ * An entry point span is defined as the base segment of a transaction.
+ * @param {object} params to function
+ * @param {Transaction} params.transaction active transaction
+ * @param {TraceSegment} params.segment segment that is creating span
+ * @returns {boolean} true if the segment is an entry point span
+ */
+function isEntryPointSpan({ transaction, segment }) {
+  return transaction?.baseSegment === segment
+}
+
+/**
+ * Checks if the segment is an exit span.
+ * An exit span is defined as a segment that is an external call,
+ * datastore operation, or message broker operation.
+ * @param {TraceSegment} segment segment that is creating span
+ * @returns {boolean} true if the segment is an exit span
+ */
+function isExitSpan(segment) {
+  return REGEXS.CLIENT.EXTERNAL.test(segment.name) || REGEXS.CLIENT.DATASTORE.test(segment.name) || REGEXS.PRODUCER.test(segment.name)
+}
+
+/**
+ * Determines if a span should be created based on the segment and transaction.
+ * If the segment is an entry point span or an exit span, a span should be created.
+ * @param {object} params to function
+ * @param {boolean} params.entryPoint true if the segment is an entry point span
+ * @param {TraceSegment} params.segment segment that is creating span
+ * @returns {boolean} true if a span should be created
+ */
+function shouldCreateSpan({ entryPoint, segment }) {
+  return entryPoint ||
+         isExitSpan(segment)
+}
+
+/**
+ * Reparents a span based on the transaction and inProcessSpans.
+ * If inProcessSpans is true or the transaction has accepted distributed trace and it's the root segment,
+ * the parentId is not changed.
+ * If there is a parentId and the transaction has a base segment, the span is reparented to the base segment.
+ * If there is no parentId, the span is not reparented(indicates an entry root span for a DT trace).
+ * @param {object} params to function
+ * @param {boolean} params.inProcessSpans true if in-process spans are enabled
+ * @param {boolean} params.isRoot true if the segment is the root segment
+ * @param {string} params.parentId the parent id of the segment
+ * @param {Transaction} params.transaction active transaction
+ * @returns {string|null} the new parentId for the span
+ */
+function reparentSpan({ inProcessSpans, isRoot, parentId, transaction }) {
+  if (inProcessSpans || (transaction.acceptedDistributedTrace && isRoot)) {
+    return parentId
+  } else if (parentId && transaction?.baseSegment?.id) {
+    return transaction.baseSegment.id
+  } else {
+    return null
+  }
+}
+
 module.exports = {
   HTTP_LIBRARY,
   CATEGORIES,
   SPAN_KIND,
   REGEXS,
-  addSpanKind
+  addSpanKind,
+  isEntryPointSpan,
+  reparentSpan,
+  shouldCreateSpan
 }

package/lib/spans/span-event-aggregator.js

@@ -21,6 +21,7 @@ class SpanEventAggregator extends EventAggregator {
     opts.metricNames = opts.metricNames || NAMES.SPAN_EVENTS
 
     super(opts, agent)
+    this.inProcessSpans = agent.config.distributed_tracing.in_process_spans.enabled
   }
 
   _toPayloadSync() {
@@ -66,7 +67,6 @@ class SpanEventAggregator extends EventAggregator {
    * @param {Transaction} params.transaction active transaction
    * @param {string} [params.parentId] GUID of the parent span.
    * @param {boolean} params.isRoot if segment is root segment
-   * @returns {boolean} True if the segment was added, or false if it was discarded.
    */
   addSegment({ segment, transaction, parentId, isRoot }) {
     // Check if the priority would be accepted before creating the event object.
@@ -77,8 +77,11 @@ class SpanEventAggregator extends EventAggregator {
 
       return false
     }
-    const span = SpanEvent.fromSegment(segment, transaction, parentId || null, isRoot)
-    return this.add(span, transaction.priority)
+    const span = SpanEvent.fromSegment({ segment, transaction, parentId, isRoot, inProcessSpans: this.inProcessSpans })
+
+    if (span) {
+      this.add(span, transaction.priority)
+    }
   }
 
   /**

package/lib/spans/span-event.js

@@ -9,7 +9,7 @@ const Config = require('../config')
 const { truncate } = require('../util/byte-limit')
 
 const { DESTINATIONS } = require('../config/attribute-filter')
-const { addSpanKind, HTTP_LIBRARY, REGEXS, SPAN_KIND, CATEGORIES } = require('./helpers')
+const { addSpanKind, isEntryPointSpan, reparentSpan, shouldCreateSpan, HTTP_LIBRARY, REGEXS, SPAN_KIND, CATEGORIES } = require('./helpers')
 const EMPTY_USER_ATTRS = Object.freeze(Object.create(null))
 const SERVER_ADDRESS = 'server.address'
 
@@ -93,9 +93,15 @@ class SpanEvent {
    * @param {Transaction} transaction active transaction
    * @param {?string} [parentId] ID of the segment's parent.
    * @param {boolean} isRoot if segment is root segment
+   * @param {boolean} inProcessSpans if the segment is in-process, create span
    * @returns {SpanEvent} The constructed event.
    */
-  static fromSegment(segment, transaction, parentId = null, isRoot = false) {
+  static fromSegment({ segment, transaction, parentId = null, isRoot = false, inProcessSpans }) {
+    const entryPoint = isEntryPointSpan({ segment, transaction })
+    if (!inProcessSpans && !shouldCreateSpan({ entryPoint, segment, transaction })) {
+      return null
+    }
+
     const spanContext = segment.getSpanContext()
 
     // Since segments already hold span agent attributes and we want to leverage
@@ -128,7 +134,7 @@ class SpanEvent {
 
     span.intrinsics.traceId = transaction.traceId
     span.intrinsics.guid = segment.id
-    span.intrinsics.parentId = parentId
+    span.intrinsics.parentId = reparentSpan({ inProcessSpans, isRoot, segment, transaction, parentId })
     span.intrinsics.transactionId = transaction.id
     span.intrinsics.sampled = transaction.sampled
     span.intrinsics.priority = transaction.priority
@@ -142,7 +148,7 @@ class SpanEvent {
     }
 
     // Only set this if it will be `true`. Must be `null` otherwise.
-    if (transaction.baseSegment === segment) {
+    if (entryPoint) {
       span.intrinsics['nr.entryPoint'] = true
     }
 

package/lib/spans/streaming-span-event-aggregator.js

@@ -44,6 +44,7 @@ class StreamingSpanEventAggregator extends Aggregator {
     this.metrics = metrics
     this.started = false
     this.isStream = true
+    this.inProcessSpans = agent.config.distributed_tracing.in_process_spans.enabled
   }
 
   /**
@@ -112,8 +113,11 @@ class StreamingSpanEventAggregator extends Aggregator {
       return
     }
 
-    const span = StreamingSpanEvent.fromSegment(segment, transaction, parentId, isRoot)
-    this.stream.write(span)
+    const span = StreamingSpanEvent.fromSegment({ segment, transaction, parentId, isRoot, inProcessSpans: this.inProcessSpans })
+
+    if (span) {
+      this.stream.write(span)
+    }
   }
 
   reconfigure(config) {

package/lib/spans/streaming-span-event.js

@@ -10,7 +10,7 @@ const { truncate } = require('../util/byte-limit')
 const Config = require('../config')
 
 const { DESTINATIONS } = require('../config/attribute-filter')
-const { addSpanKind, HTTP_LIBRARY, REGEXS, SPAN_KIND, CATEGORIES } = require('./helpers')
+const { addSpanKind, isEntryPointSpan, reparentSpan, shouldCreateSpan, HTTP_LIBRARY, REGEXS, SPAN_KIND, CATEGORIES } = require('./helpers')
 
 /**
  * Specialized span event class for use with infinite streaming.
@@ -108,7 +108,12 @@ class StreamingSpanEvent {
     }
   }
 
-  static fromSegment(segment, transaction, parentId = null, isRoot = false) {
+  static fromSegment({ segment, transaction, parentId = null, isRoot = false, inProcessSpans }) {
+    const entryPoint = isEntryPointSpan({ segment, transaction })
+    if (!inProcessSpans && !shouldCreateSpan({ entryPoint, segment, transaction })) {
+      return null
+    }
+
     const spanContext = segment.getSpanContext()
 
     // Since segments already hold span agent attributes and we want to leverage
@@ -141,8 +146,9 @@ class StreamingSpanEvent {
       span.addIntrinsicAttribute(key, value)
     }
 
+    const newParentId = reparentSpan({ inProcessSpans, isRoot, segment, transaction, parentId })
     span.addIntrinsicAttribute('guid', segment.id)
-    span.addIntrinsicAttribute('parentId', parentId)
+    span.addIntrinsicAttribute('parentId', newParentId)
     span.addIntrinsicAttribute('transactionId', transaction.id)
     span.addIntrinsicAttribute('sampled', transaction.sampled)
     span.addIntrinsicAttribute('priority', transaction.priority)
@@ -156,7 +162,7 @@ class StreamingSpanEvent {
     }
 
     // Only set this if it will be `true`. Must be `null` otherwise.
-    if (transaction.baseSegment === segment) {
+    if (entryPoint) {
       span.addIntrinsicAttribute('nr.entryPoint', true)
     }
 

package/lib/transaction/trace/index.js

@@ -44,8 +44,15 @@ function Trace(transaction) {
   this.root = this.segments.root.segment
   this.totalTimeCache = null
 
-  this.custom = new Attributes(ATTRIBUTE_SCOPE, MAXIMUM_CUSTOM_ATTRIBUTES)
-  this.attributes = new Attributes(ATTRIBUTE_SCOPE)
+  this.custom = new Attributes({
+    scope: ATTRIBUTE_SCOPE,
+    limit: MAXIMUM_CUSTOM_ATTRIBUTES,
+    valueLengthLimit: transaction.agent.config.attributes.value_size_limit
+  })
+  this.attributes = new Attributes({
+    scope: ATTRIBUTE_SCOPE,
+    valueLengthLimit: transaction.agent.config.attributes.value_size_limit
+  })
 
   // sending displayName if set by user
   const displayName = transaction.agent.config.getDisplayHost()

package/lib/transaction/trace/segment.js

@@ -43,7 +43,10 @@ function TraceSegment({ id, config, name, collect, parentId, root, isRoot = fals
   this.isRoot = isRoot
   this.root = root
   this.name = name
-  this.attributes = new Attributes(ATTRIBUTE_SCOPE)
+  this.attributes = new Attributes({
+    scope: ATTRIBUTE_SCOPE,
+    valueLengthLimit: config?.attributes.value_size_limit
+  })
   this.spansEnabled = config?.distributed_tracing?.enabled && config?.span_events?.enabled
 
   // Generate a unique id for use in span events.

package/lib/util/code-level-metrics.js

@@ -52,7 +52,7 @@ clmUtils.addCLMAttributes = function addCLMAttributes(fn, segment) {
   }
 
   try {
-    const { funcInfo } = require('@contrast/fn-inspect')
+    const { funcInfo } = require('@newrelic/fn-inspect')
     const { lineNumber, method, file: filePath, column } = funcInfo(fn)
     const fnName = setFunctionName(method)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "newrelic",
-  "version": "12.22.0",
+  "version": "12.24.0",
   "author": "New Relic Node.js agent team <nodejs@newrelic.com>",
   "license": "Apache-2.0",
   "contributors": [
@@ -223,8 +223,8 @@
     "winston-transport": "^4.5.0"
   },
   "optionalDependencies": {
-    "@contrast/fn-inspect": "^4.2.0",
-    "@newrelic/native-metrics": "^11.0.0",
+    "@newrelic/fn-inspect": "^4.4.0",
+    "@newrelic/native-metrics": "^11.1.0",
     "@prisma/prisma-fmt-wasm": "^4.17.0-16.27eb2449f178cd9fe1a4b892d732cc4795f75085"
   },
   "devDependencies": {