newrelic 13.3.3 → 13.5.0

package/NEWS.md

@@ -1,3 +1,55 @@
+### v13.5.0 (2025-10-14)
+
+#### Code refactoring
+
+* Updated `fastify` instrumentation to subscribe to events emitted ([#3407](https://github.com/newrelic/node-newrelic/pull/3407)) ([51e361e](https://github.com/newrelic/node-newrelic/commit/51e361ed736fa1235eeb16f1c5ec833a1b56a0bf))
+* Updated `pg` and `pg-native` instrumentation to subscribe to events emitted ([#3397](https://github.com/newrelic/node-newrelic/pull/3397)) ([04af258](https://github.com/newrelic/node-newrelic/commit/04af2580a554ecabedab447d5edc5cec836d7f40))
+
+* Updated `config.instrumentation.timers.enabled` to false to disable `timers.setTimeout` and `timers.setInterval` by default. ([#3414](https://github.com/newrelic/node-newrelic/pull/3414)) ([b925d3d](https://github.com/newrelic/node-newrelic/commit/b925d3d178886e6d4bbd0f2eaa6f51b6fddd7878))
+    * To re-enable, set `config.instrumentation.timers.enabled` to `true` in config or set `NEW_RELIC_INSTRUMENTATION_TIMERS_ENABLED=true` 
+
+#### Documentation
+
+* Updated compatibility report ([#3413](https://github.com/newrelic/node-newrelic/pull/3413)) ([fef98dd](https://github.com/newrelic/node-newrelic/commit/fef98ddffddf60b32f162ea87dee2a3a0bdf8048))
+
+#### Miscellaneous chores
+
+* Added a new diagnostics base class and migrated undici to use new class ([#3408](https://github.com/newrelic/node-newrelic/pull/3408)) ([8047bf1](https://github.com/newrelic/node-newrelic/commit/8047bf165ae5105bb612c1a834d574078d52724d))
+* Created directory for samplers ([#3419](https://github.com/newrelic/node-newrelic/pull/3419)) ([dd2d3df](https://github.com/newrelic/node-newrelic/commit/dd2d3dfe1bb2582de51e07a1cce6077df84f7108))
+
+#### Styles
+
+* Require `check-types` and `require-returns-type` jsdoc ([#3400](https://github.com/newrelic/node-newrelic/pull/3400)) ([e4cd687](https://github.com/newrelic/node-newrelic/commit/e4cd687c59aeaba6b627403bcb29b4b6576fe4d9))
+* Require jsdoc `check*`, `implements-on-classes`, and some `no-undefined-types` ([#3404](https://github.com/newrelic/node-newrelic/pull/3404)) ([4fa645b](https://github.com/newrelic/node-newrelic/commit/4fa645b91900ff0acbd24b8f50c6fffcd07f3b82))
+* Require jsdoc `require-returns-check` and `require-property-*` ([#3403](https://github.com/newrelic/node-newrelic/pull/3403)) ([1008073](https://github.com/newrelic/node-newrelic/commit/100807342b9c9283f43042024f15bb575de219ee))
+
+#### Tests
+
+* Added helper to get version of package when package.json not exported, and updated tests that need it ([#3411](https://github.com/newrelic/node-newrelic/pull/3411)) ([5ae02c7](https://github.com/newrelic/node-newrelic/commit/5ae02c7411cd7ae0a45203b025559c5442a7171e))
+* Fixed fastify segment tree assertion when security agent is enabled ([#3422](https://github.com/newrelic/node-newrelic/pull/3422)) ([b2cf6ed](https://github.com/newrelic/node-newrelic/commit/b2cf6ed5d8debae23d0bb31e9a72b325464fadc2))
+* Refactored mcp tests to listen on new port for every streaming test, removed unncessary shutdown of process ([#3420](https://github.com/newrelic/node-newrelic/pull/3420)) ([17db813](https://github.com/newrelic/node-newrelic/commit/17db8133e8e13c970362330885dccf4870942aea))
+* Updated an openai assertion with setTimeout disabled ([#3421](https://github.com/newrelic/node-newrelic/pull/3421)) ([ceec8f9](https://github.com/newrelic/node-newrelic/commit/ceec8f9ef2ac95285dcc1619ef2ee8e187252beb))
+
+### v13.4.0 (2025-09-29)
+
+#### Code refactoring
+
+* Update `amqplib` instrumentation to subscribe to events emitted ([#3377](https://github.com/newrelic/node-newrelic/pull/3377)) ([fecbb08](https://github.com/newrelic/node-newrelic/commit/fecbb08d3e3ddc31049aae07537da5d44efaa9e7))
+* Updated `cassandra-driver` instrumentation to subscribe to events emitted. ([#3372](https://github.com/newrelic/node-newrelic/pull/3372)) ([bb87cd8](https://github.com/newrelic/node-newrelic/commit/bb87cd829aacbc66e9caee4f7c494babab742f86))
+
+#### Documentation
+
+* Updated compatibility report ([#3385](https://github.com/newrelic/node-newrelic/pull/3385)) ([b79be72](https://github.com/newrelic/node-newrelic/commit/b79be723abd29a81c9fa2b635118de44be78c69b))
+
+#### Miscellaneous chores
+
+* Updated `@apm-js-collab/tracing-hooks` to latest to take advantage of wasm optimizations ([#3398](https://github.com/newrelic/node-newrelic/pull/3398)) ([cda56cc](https://github.com/newrelic/node-newrelic/commit/cda56cc074c421064150163a02a561e69b23a6cb))
+
+#### Styles
+
+* Require `jsdoc/valid-types` and `jsdoc/check-param-names` ([#3368](https://github.com/newrelic/node-newrelic/pull/3368)) ([5d1b1d9](https://github.com/newrelic/node-newrelic/commit/5d1b1d94a82aaeb877a6fe783becbc8aea6582d6))
+* Require jsdoc `require-param-description` and `require-param-type` ([#3391](https://github.com/newrelic/node-newrelic/pull/3391)) ([3785d0c](https://github.com/newrelic/node-newrelic/commit/3785d0c06cfcc6ac85e23ad4ad21d357e334207b))
+
 ### v13.3.3 (2025-09-22)
 
 #### Features
@@ -7906,3 +7958,5 @@ Special thanks to Ryan Copley (@RyanCopley) for the contribution.
 
 
 
+
+

package/THIRD_PARTY_NOTICES.md

@@ -98,7 +98,7 @@ code, the source code can be found at [https://github.com/newrelic/node-newrelic
 
 ### @apm-js-collab/tracing-hooks
 
-This product includes source derived from [@apm-js-collab/tracing-hooks](https://github.com/apm-js-collab/tracing-hooks) ([v0.1.1](https://github.com/apm-js-collab/tracing-hooks/tree/v0.1.1)), distributed under the [Apache-2.0 License](https://github.com/apm-js-collab/tracing-hooks/blob/v0.1.1/LICENSE):
+This product includes source derived from [@apm-js-collab/tracing-hooks](https://github.com/apm-js-collab/tracing-hooks) ([v0.3.1](https://github.com/apm-js-collab/tracing-hooks/tree/v0.3.1)), distributed under the [Apache-2.0 License](https://github.com/apm-js-collab/tracing-hooks/blob/v0.3.1/LICENSE):
 
 ```
 
@@ -308,7 +308,7 @@ This product includes source derived from [@apm-js-collab/tracing-hooks](https:/
 
 ### @grpc/grpc-js
 
-This product includes source derived from [@grpc/grpc-js](https://github.com/grpc/grpc-node/tree/master/packages/grpc-js) ([v1.13.4](https://github.com/grpc/grpc-node/tree/master/packages/grpc-js/tree/v1.13.4)), distributed under the [Apache-2.0 License](https://github.com/grpc/grpc-node/tree/master/packages/grpc-js/blob/v1.13.4/LICENSE):
+This product includes source derived from [@grpc/grpc-js](https://github.com/grpc/grpc-node/tree/master/packages/grpc-js) ([v1.14.0](https://github.com/grpc/grpc-node/tree/master/packages/grpc-js/tree/v1.14.0)), distributed under the [Apache-2.0 License](https://github.com/grpc/grpc-node/tree/master/packages/grpc-js/blob/v1.14.0/LICENSE):
 
 ```
                                  Apache License
@@ -726,7 +726,7 @@ This product includes source derived from [@grpc/proto-loader](https://github.co
 
 ### @newrelic/security-agent
 
-This product includes source derived from [@newrelic/security-agent](https://github.com/newrelic/csec-node-agent) ([v2.4.3](https://github.com/newrelic/csec-node-agent/tree/v2.4.3)), distributed under the [UNKNOWN License](https://github.com/newrelic/csec-node-agent/blob/v2.4.3/LICENSE):
+This product includes source derived from [@newrelic/security-agent](https://github.com/newrelic/csec-node-agent) ([v2.4.4](https://github.com/newrelic/csec-node-agent/tree/v2.4.4)), distributed under the [UNKNOWN License](https://github.com/newrelic/csec-node-agent/blob/v2.4.4/LICENSE):
 
 ```
 ## New Relic Software License v1.0
@@ -1190,7 +1190,7 @@ This product includes source derived from [@opentelemetry/api](https://github.co
 
 ### @opentelemetry/core
 
-This product includes source derived from [@opentelemetry/core](https://github.com/open-telemetry/opentelemetry-js) ([v2.0.1](https://github.com/open-telemetry/opentelemetry-js/tree/v2.0.1)), distributed under the [Apache-2.0 License](https://github.com/open-telemetry/opentelemetry-js/blob/v2.0.1/LICENSE):
+This product includes source derived from [@opentelemetry/core](https://github.com/open-telemetry/opentelemetry-js) ([v2.1.0](https://github.com/open-telemetry/opentelemetry-js/tree/v2.1.0)), distributed under the [Apache-2.0 License](https://github.com/open-telemetry/opentelemetry-js/blob/v2.1.0/LICENSE):
 
 ```
                                  Apache License
@@ -1608,7 +1608,7 @@ This product includes source derived from [@opentelemetry/exporter-metrics-otlp-
 
 ### @opentelemetry/resources
 
-This product includes source derived from [@opentelemetry/resources](https://github.com/open-telemetry/opentelemetry-js) ([v2.0.1](https://github.com/open-telemetry/opentelemetry-js/tree/v2.0.1)), distributed under the [Apache-2.0 License](https://github.com/open-telemetry/opentelemetry-js/blob/v2.0.1/LICENSE):
+This product includes source derived from [@opentelemetry/resources](https://github.com/open-telemetry/opentelemetry-js) ([v2.1.0](https://github.com/open-telemetry/opentelemetry-js/tree/v2.1.0)), distributed under the [Apache-2.0 License](https://github.com/open-telemetry/opentelemetry-js/blob/v2.1.0/LICENSE):
 
 ```
                                  Apache License
@@ -2026,7 +2026,7 @@ This product includes source derived from [@opentelemetry/sdk-logs](https://gith
 
 ### @opentelemetry/sdk-metrics
 
-This product includes source derived from [@opentelemetry/sdk-metrics](https://github.com/open-telemetry/opentelemetry-js) ([v2.0.1](https://github.com/open-telemetry/opentelemetry-js/tree/v2.0.1)), distributed under the [Apache-2.0 License](https://github.com/open-telemetry/opentelemetry-js/blob/v2.0.1/LICENSE):
+This product includes source derived from [@opentelemetry/sdk-metrics](https://github.com/open-telemetry/opentelemetry-js) ([v2.1.0](https://github.com/open-telemetry/opentelemetry-js/tree/v2.1.0)), distributed under the [Apache-2.0 License](https://github.com/open-telemetry/opentelemetry-js/blob/v2.1.0/LICENSE):
 
 ```
                                  Apache License
@@ -2235,7 +2235,7 @@ This product includes source derived from [@opentelemetry/sdk-metrics](https://g
 
 ### @opentelemetry/sdk-trace-base
 
-This product includes source derived from [@opentelemetry/sdk-trace-base](https://github.com/open-telemetry/opentelemetry-js) ([v2.0.1](https://github.com/open-telemetry/opentelemetry-js/tree/v2.0.1)), distributed under the [Apache-2.0 License](https://github.com/open-telemetry/opentelemetry-js/blob/v2.0.1/LICENSE):
+This product includes source derived from [@opentelemetry/sdk-trace-base](https://github.com/open-telemetry/opentelemetry-js) ([v2.1.0](https://github.com/open-telemetry/opentelemetry-js/tree/v2.1.0)), distributed under the [Apache-2.0 License](https://github.com/open-telemetry/opentelemetry-js/blob/v2.1.0/LICENSE):
 
 ```
                                  Apache License
@@ -2533,7 +2533,7 @@ SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 ### import-in-the-middle
 
-This product includes source derived from [import-in-the-middle](https://github.com/nodejs/import-in-the-middle) ([v1.14.2](https://github.com/nodejs/import-in-the-middle/tree/v1.14.2)), distributed under the [Apache-2.0 License](https://github.com/nodejs/import-in-the-middle/blob/v1.14.2/LICENSE):
+This product includes source derived from [import-in-the-middle](https://github.com/nodejs/import-in-the-middle) ([v1.14.4](https://github.com/nodejs/import-in-the-middle/tree/v1.14.4)), distributed under the [Apache-2.0 License](https://github.com/nodejs/import-in-the-middle/blob/v1.14.4/LICENSE):
 
 ```
                                  Apache License
@@ -2964,7 +2964,7 @@ SOFTWARE.
 
 ### @aws-sdk/client-s3
 
-This product includes source derived from [@aws-sdk/client-s3](https://github.com/aws/aws-sdk-js-v3) ([v3.872.0](https://github.com/aws/aws-sdk-js-v3/tree/v3.872.0)), distributed under the [Apache-2.0 License](https://github.com/aws/aws-sdk-js-v3/blob/v3.872.0/LICENSE):
+This product includes source derived from [@aws-sdk/client-s3](https://github.com/aws/aws-sdk-js-v3) ([v3.896.0](https://github.com/aws/aws-sdk-js-v3/tree/v3.896.0)), distributed under the [Apache-2.0 License](https://github.com/aws/aws-sdk-js-v3/blob/v3.896.0/LICENSE):
 
 ```
                                 Apache License
@@ -3173,7 +3173,7 @@ This product includes source derived from [@aws-sdk/client-s3](https://github.co
 
 ### @aws-sdk/s3-request-presigner
 
-This product includes source derived from [@aws-sdk/s3-request-presigner](https://github.com/aws/aws-sdk-js-v3) ([v3.872.0](https://github.com/aws/aws-sdk-js-v3/tree/v3.872.0)), distributed under the [Apache-2.0 License](https://github.com/aws/aws-sdk-js-v3/blob/v3.872.0/LICENSE):
+This product includes source derived from [@aws-sdk/s3-request-presigner](https://github.com/aws/aws-sdk-js-v3) ([v3.896.0](https://github.com/aws/aws-sdk-js-v3/tree/v3.896.0)), distributed under the [Apache-2.0 License](https://github.com/aws/aws-sdk-js-v3/blob/v3.896.0/LICENSE):
 
 ```
                                 Apache License
@@ -5033,7 +5033,7 @@ SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 ### eslint
 
-This product includes source derived from [eslint](https://github.com/eslint/eslint) ([v9.33.0](https://github.com/eslint/eslint/tree/v9.33.0)), distributed under the [MIT License](https://github.com/eslint/eslint/blob/v9.33.0/LICENSE):
+This product includes source derived from [eslint](https://github.com/eslint/eslint) ([v9.36.0](https://github.com/eslint/eslint/tree/v9.36.0)), distributed under the [MIT License](https://github.com/eslint/eslint/blob/v9.36.0/LICENSE):
 
 ```
 Copyright OpenJS Foundation and other contributors, <www.openjsf.org>

package/api.js

@@ -1937,7 +1937,7 @@ API.prototype.ignoreApdex = function ignoreApdex() {
  *      { role: 'user', content: 'Tell me about Node.js.'}
  *    ]})
  * })
- * @param {Object} context LLM custom attributes context
+ * @param {object} context LLM custom attributes context
  * @param {Function} callback The function to execute in context.
  */
 API.prototype.withLlmCustomAttributes = function withLlmCustomAttributes(context, callback) {

package/esm-loader.mjs

@@ -9,10 +9,10 @@ import subscriptions from './lib/subscriber-configs.js'
 import createSubscriberConfigs from './lib/subscribers/create-config.js'
 // Exclusions must be regexes
 const exclusions = [/@openai\/agents.*/]
-const { packages, instrumentations } = createSubscriberConfigs(subscriptions)
+const { instrumentations } = createSubscriberConfigs(subscriptions)
 
 register('@apm-js-collab/tracing-hooks/hook.mjs', import.meta.url, {
-  data: { instrumentations, packages }
+  data: { instrumentations }
 })
 register('import-in-the-middle/hook.mjs', import.meta.url, {
   data: { exclude: exclusions }

package/lib/agent.js

@@ -5,7 +5,7 @@
 
 'use strict'
 
-const AdaptiveSampler = require('./adaptive-sampler')
+const AdaptiveSampler = require('./samplers/adaptive-sampler')
 const CollectorAPI = require('./collector/api')
 const ServerlessCollector = require('./collector/serverless')
 const DESTINATIONS = require('./config/attribute-filter').DESTINATIONS
@@ -169,7 +169,7 @@ const DEFAULT_HARVEST_INTERVAL_MS = 60000
  * available. Don't try to recover here, because without configuration the
  * agent can't be brought up to a useful state.
  *
- * @param {object} config Agent configuration object
+ * @param {Config} config Agent configuration object
  */
 function Agent(config) {
   EventEmitter.call(this)

package/lib/aggregators/event-aggregator.js

@@ -85,8 +85,6 @@ class EventAggregator extends Aggregator {
 
   /**
    * Resets the contents of the aggregator and all counters.
-   *
-   * @returns {PriorityQueue} The old collection of aggregated events.
    */
   clearEvents() {
     // ???: might be more efficient to clear here and come up with an efficient way to

package/lib/attributes.js

@@ -68,7 +68,7 @@ class Attributes {
    * in the list of allowed destinations. If there is a limit on the number of
    * attributes allowed, no more than that number will be included in the result.
    *
-   * @param {AttributeFilter.DESTINATIONS} dest
+   * @param {AttributeFilter.DESTINATIONS} dest - Allowed destinations
    * @returns {object}
    */
   get(dest) {
@@ -92,7 +92,7 @@ class Attributes {
   /**
    * Checks if a given key exists in the instance attributes object.
    *
-   * @param {string} key
+   * @param {string} key the key to check
    */
   has(key) {
     return !!this.attributes[key]
@@ -163,8 +163,8 @@ class Attributes {
    * Returns true if a given key is valid for any of the
    * provided destinations.
    *
-   * @param {DESTINATIONS} destinations
-   * @param {string} key
+   * @param {DESTINATIONS} destinations - The destinations to check against.
+   * @param {string} key the key to check
    */
   hasValidDestination(destinations, key) {
     const validDestinations = this.filter(destinations, key)
@@ -176,8 +176,8 @@ class Attributes {
  * Creates a filter function for the given scope.
  *
  * @param {string} scope - The scope of the filter to make.
- * @returns {Function} A function that performs attribute filtering for the given
- *  scope.
+ * @returns {Function|undefined} A function that performs attribute filtering for the given
+ *  scope, or undefined if the scope is not recognized.
  */
 function makeFilter(scope) {
   const { attributeFilter } = Config.getInstance()

package/lib/collector/api.js

@@ -153,7 +153,7 @@ CollectorAPI.prototype._updateEndpoints = function _updateEndpoints(endpoint) {
 /**
  * Connect to the data collector.
  *
- * @param {function} callback A typical error first callback to be invoked
+ * @param {Function} callback A typical error first callback to be invoked
  * upon successful or unsuccessful connection. The second parameter will be
  * an instance of {@link CollectorResponse}.
  *

package/lib/collector/facts.js

@@ -130,7 +130,7 @@ function getAllIPAddresses() {
  * connections are the same real agent or a separate one.
  * https://github.com/newrelic/node-newrelic/issues/654
  *
- * @param appNames
+ * @param {Array<string>} appNames list of app names
  */
 function getIdentifierOverride(appNames) {
   return [

package/lib/collector/http-agents.js

@@ -19,7 +19,7 @@ let agentProxyWithKeepAlive = null
 /**
  * Returns an HTTP agent with keep-alive enabled
  *
- * @param config
+ * @param {object} config configuration for HTTP agent
  */
 exports.keepAliveAgent = function keepAliveAgent(config) {
   config = config ? config : {}
@@ -45,7 +45,7 @@ exports.keepAliveAgent = function keepAliveAgent(config) {
  * to the proxy server as to how its connection is made
  * with New Relic's servers.
  *
- * @param config
+ * @param {object} config configuration for proxy agent
  */
 exports.proxyAgent = function proxyAgent(config) {
   if (agentProxyWithKeepAlive !== null) {

package/lib/collector/parse-response.js

@@ -16,18 +16,15 @@ const logger = require('../logger').child({ component: 'new_relic_response' })
  * about errors as possible, and to parse out the return value as often
  * as possible.
  *
- * @param string         name     Remote method name that was invoked.
- * @param ServerResponse response HTTP response stream
- * @param Function       callback Function that will be called with any
- *                                error, the value returned by the server
- *                                (if any), and the raw JSON of the
- *                                server's response.
- * @param name
- * @param response
- * @param callback
- * @returns Function Another callback that is meant to be invoked with
- *                   any errors from reading the response stream, as
- *                   well as a string containing the full response.
+ * @param {string}         name     Remote method name that was invoked.
+ * @param {ServerResponse} response HTTP response stream
+ * @param {Function}       callback Function that will be called with any
+ *                                  error, the value returned by the server
+ *                                  (if any), and the raw JSON of the
+ *                                  server's response.
+ * @returns {Function} Another callback that is meant to be invoked with
+ *                     any errors from reading the response stream, as
+ *                     well as a string containing the full response.
  */
 module.exports = function parse(name, response, callback) {
   if (!callback) {

package/lib/collector/remote-method.js

@@ -128,9 +128,8 @@ RemoteMethod.prototype.invoke = function invoke(payload, nrHeaders, callback) {
  * Take a serialized payload and create a response wrapper for it before
  * invoking the method on the collector.
  *
- * @param {string}   methodName Name of method to invoke on collector.
  * @param {string}   data       Serialized payload.
- * @param {?object}  nrHeaders  NR request headers from connect response.
+ * @param {object}  nrHeaders  NR request headers from connect response.
  * @param {Function} callback   What to do next. Gets passed any error.
  */
 RemoteMethod.prototype._post = function _post(data, nrHeaders, callback) {
@@ -282,6 +281,7 @@ RemoteMethod.prototype._safeRequest = function _safeRequest(options) {
  * Generate the request headers and wire up the request. There are many
  * parameters used to make a request:
  *
+ * @param {object} options options object
  * @param {string}   options.host       Hostname (or proxy hostname) for collector.
  * @param {string}   options.port       Port (or proxy port) for collector.
  * @param {string}   options.path       URL path for method being invoked on collector.
@@ -292,7 +292,6 @@ RemoteMethod.prototype._safeRequest = function _safeRequest(options) {
  *                                      original callback given to .send).
  * @param {Function} options.onResponse Response handler for this request (created by
  *                                      ._post).
- * @param options
  */
 RemoteMethod.prototype._request = function _request(options) {
   const requestOptions = {
@@ -364,7 +363,7 @@ RemoteMethod.prototype._path = function _path({ redactLicenseKey } = {}) {
 }
 
 /**
- * @param {object} options
+ * @param {object} options options object
  * @param {number} options.body       - Data to be sent.
  * @param {object} options.nrHeaders  - NR request headers from the connect response.
  * @param {boolean}   options.compressed - The compression method used, if any.
@@ -402,7 +401,7 @@ RemoteMethod.prototype._headers = function _headers(options) {
  *
  * FIXME: come up with a better heuristic
  *
- * @param data
+ * @param {*} data the data that might get compressed
  */
 RemoteMethod.prototype._shouldCompress = function _shouldCompress(data) {
   return data && byteLength(data) > 65536

package/lib/collector/serverless.js

@@ -110,7 +110,7 @@ class ServerlessCollector {
    * Constructs, serializes, and prints the final consolidated payload to stdout.
    *
    * @param {Function} cb The callback to invoke when finished.
-   * @returns {boolean} indicating if callback was defined and successfully executed
+   * @returns {boolean|undefined} indicating if callback was defined and successfully executed
    */
   flushPayload(cb) {
     if (!this.enabled) {

package/lib/config/build-instrumentation-config.js

@@ -12,18 +12,28 @@ const corePkgs = Object.keys(coreLibraries)
 const subscriptions = require('../subscriber-configs')
 const subscribers = Object.keys(subscriptions)
 pkgNames.push(...subscribers)
-// Manually adding undici as it is registered separately in shimmer
-corePkgs.push('undici')
 // Manually adding domain as it is registered separately in shimmer
 corePkgs.push('domain')
 pkgNames.push(...corePkgs)
 
+// Packages are normally enabled without any extra
+// configuration. This list is a set of packages that
+// we want to be disabled without any extra configuration.
+// Typically, this is because the instrumentation no longer
+// provides useful data. Users can still enable them if they
+// are interested in the instrumentation they provide.
+const disabledPkgs = ['timers']
+
 /**
  * Builds the stanza for config.instrumentation.*
  * It defaults every library to true and assigns a boolean
  * formatter for the environment variable conversion of the values
  */
 module.exports = pkgNames.reduce((config, pkg) => {
-  config[pkg] = { enabled: { formatter: boolean, default: true } }
+  let defaultValue = true
+  if (disabledPkgs.includes(pkg)) {
+    defaultValue = false
+  }
+  config[pkg] = { enabled: { formatter: boolean, default: defaultValue } }
   return config
 }, {})

package/lib/config/default.js

@@ -1156,16 +1156,27 @@ defaultConfig.definition = () => {
       },
 
       sampler: {
-      /**
-       * When set to `always_on`, the sampled flag in the `traceparent` header
-       * being set to "true" will result in the local transaction being sampled
-       * with a priority value of "2". When set to `always_off`, the local
-       * transaction will never be sampled. At the default setting, the sampling
-       * decision will be determined according to the normal algorithm.
-       *
-       * This setting takes precedence over the `remote_parent_not_sampled`
-       * setting.
-       */
+        /**
+         * The sampling target for adaptive sampling is controlled via this attribute when configuring the default/adaptive sampler.
+         * The default sampling target is 10 transactions/min when it is not specified but **MUST** be within the range of [1, 120] (inclusive).
+         * Upon agent connect, the connect response **MUST** provide the value of `sampling_target` based on this configuration setting's value.
+         * The `sampling_target` value from the connect response **SHOULD** be used as the sampling target value for adaptive sampling in the agent.
+         */
+        adaptive_sampling_target: {
+          formatter: int,
+          default: 10
+        },
+
+        /**
+         * When set to `always_on`, the sampled flag in the `traceparent` header
+         * being set to "true" will result in the local transaction being sampled
+         * with a priority value of "2". When set to `always_off`, the local
+         * transaction will never be sampled. At the default setting, the sampling
+         * decision will be determined according to the normal algorithm.
+         *
+         * This setting takes precedence over the `remote_parent_not_sampled`
+         * setting.
+         */
         remote_parent_sampled: {
           formatter: allowList.bind(null, ['always_on', 'always_off', 'default']),
           default: 'default'

package/lib/config/formatters.js

@@ -10,7 +10,7 @@ const formatters = module.exports
  * Splits a string by a ',' and trims whitespace
  *
  * @param {string} val config setting
- * @param {Array}
+ * @returns {Array}
  */
 formatters.array = function array(val) {
   return val.split(',').map((k) => k.trim())
@@ -39,8 +39,7 @@ formatters.float = function float(val) {
 /**
  * Parses a config setting as a boolean
  *
- * @param {string} val config setting
- * @param setting
+ * @param {string} setting value of config setting
  * @returns {boolean}
  */
 formatters.boolean = function boolean(setting) {
@@ -68,7 +67,7 @@ formatters.boolean = function boolean(setting) {
  *
  * @param {string} val config setting
  * @param {logger} logger agent logger instance
- * @returns {object}
+ * @returns {object|undefined} the parsed value, or undefined if an error occurred
  */
 formatters.object = function object(val, logger) {
   try {
@@ -84,7 +83,7 @@ formatters.object = function object(val, logger) {
  *
  * @param {string} val config setting
  * @param {logger} logger agent logger instance
- * @returns {Array}
+ * @returns {Array|undefined} The parsed array of objects, or undefined if an error occurred
  */
 formatters.objectList = function objectList(val, logger) {
   try {
@@ -112,7 +111,7 @@ formatters.allowList = function allowList(list, val) {
  *
  * @param {string} val valid regex
  * @param {logger} logger agent logger instance
- * @returns {RegExp} regex
+ * @returns {RegExp|undefined} regex, or undefined if an error occurred
  */
 formatters.regex = function regex(val, logger) {
   try {