newrelic 12.23.0 → 12.24.0

package/NEWS.md

@@ -1,3 +1,17 @@
+### 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

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: {
@@ -1618,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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "newrelic",
-  "version": "12.23.0",
+  "version": "12.24.0",
   "author": "New Relic Node.js agent team <nodejs@newrelic.com>",
   "license": "Apache-2.0",
   "contributors": [