Node.js agent release notesRSS

Notes

Features

• Updated koa instrumentation to properly wrap Router when using @koa/router@15.0.0+ (#3550) (f1e08ad)
• Added ability to configure a ratio based sampler (#3501) (f300bd5)
  • To assign a ratio based sampler, set config.distributed_tracing.sampler.root, config.distributed_tracing.sampler.remote_parent_sampled, or config.distributed_tracing.sampler.remote_parent_not_sampled to { trace_id_ratio_based: { ratio: <float between 0 and 1> }}
  • To assign via environment variables set NEW_RELIC_DISTRIBUTED_TRACING_SAMPLER_<TYPE>='trace_id_ratio_based' and NEW_RELIC_DISTRIBUTED_TRACING_SAMPLER_<TYPE>_RATIO=<float between 0 and 1> where <TYPE> is one of ROOT, REMOTE_PARENT_SAMPLED, or REMOTE_PARENT_NOT_SAMPLED
• Updated configuration to allow adaptive.sampling_target to be set for config.distributed_tracing.sampler.root, config.distributed_tracing.sampler.remote_parent_sampled, and config.distributed_tracing.sampler.remote_parent_not_sampled (#3532) (44f51dd)
• Added support for OTEL span links (#3528) (e840690)
• Replaced default with adaptive as the default for samplers (#3543) (3f03162)
• Preliminary support for partial granularity traces (Not available for production use)
  • Added essential type for partial granularity traces (#3547) (3d85fb5)
  • Added reduced type for partial granularity traces. (#3540) (cfa8f41)
  • Added partial granularity samplers and assign transactions with isPartialTrace when partial granularity sampling decisions have been made (#3544) (1535a82)
  • Refactored samplers into classes and store them on agent.sampler.* (#3527) (ad63441)
  • Updated Samplers class to normalize logger messages, short circuit when applicable and remove optional chaining checks (#3546) (4f7684c)
  • Updated samplers to assign priority between 0-1 when DT is disabled or both full and partial granularity are disabled (#3559) (7a1c37e)
  • Updated transaction to store partial granularity indicator as .partialType (#3561) (a7f20d8)
  • Updated when partial granularity rules are applied (#3553) (a4bdf4f)
  • Added toString and get [Symbol.toStringTag]() to default Sampler class (#3562) (771168d)

Bug fixes

• Fixed normalization of OTEL hrtime (#3564) (707fe7d)

Documentation

• Updated compatibility report (#3551) (02268a4)
• Added internal doc for attributes (#3539) (68543b6)

Miscellaneous chores

• Improved logging around preconnect payload
  • Added more logging around assigning hostname during preconnect (#3568) (3ee4d38)
  • Improved GCP utilization logging (#3552) (e6c4141)
• Utilization resolution is now done concurrently (#3556) (8386360)
• Collected OTEL instrumentation scope metadata on all OTEL spans. (#3554) (75703c4)
• Improved OTEL hrtime processing (#3557) (8f187b1)
• Renamed config opentelemetry_bridge to opentelemetry (#3565) (c9d156f)

Support statement:

We recommend updating to the latest agent version as soon as it's available. If you can't upgrade to the latest version, update your agents to a version no more than 90 days old. Read more about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notes

Bug fixes

• Updated app.use or router.use Express instrumentation to properly wrap all middleware defined (#3520) (d3b20d0)

Documentation

• Updated compatibility report (#3522) (72ec652) (#3516) (35defb0)

Tests

• Pinned next.js to skip 11.0.10 and 11.0.11 (#3521) (20977ee)

Support statement:

We recommend updating to the latest agent version as soon as it's available. If you can't upgrade to the latest version, update your agents to a version no more than 90 days old. Read more about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notes

Bug fixes

• Updated express instrumentation to ignore error when the next handler passes route or router (#3513) (724b218)
• Updated MessageConsumerSubscriber to wait for consumer callback to end when it is a promise (#3510) (45667a0)

Documentation

• Updated compatibility report (#3498) (ef41b38)

Tests

• Updated aws sdk v3 s3 test to no longer test DeleteBucketCommand (#3512) (df27448)

Support statement:

We recommend updating to the latest agent version as soon as it's available. If you can't upgrade to the latest version, update your agents to a version no more than 90 days old. Read more about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notes

Bug fixes

• Updated MessageConsumerSubscriber to end transaction created for a given message consumption (#3503) (ba30818)
• Updated MessageProducerSubscriber to properly set the sampled flag on traceparent (#3505) (0b1a9a8)
• Updated the bedrock middleware to be registered with a high priority to ensure payload is properly deserialized (#3500) (63e531b)

Support statement:

We recommend updating to the latest agent version as soon as it's available. If you can't upgrade to the latest version, update your agents to a version no more than 90 days old. Read more about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notes

Bug fixes

• Updated @google/genai to properly handle assigning token counts to LlmCompletionSummary message (#3495) (f805d38)
• Updated AWS Bedrock instrumentation to properly assign token counts (#3491) (b1687f6)
• Updated openai instrumentation to properly handle streaming when stream_options.include_usage is set (#3494) (37c43f5)

Code refactoring

• Update mysql and mysql2 instrumentation to subscribe to events emitted (#3423) (2e38914)

Documentation

• Cleaned up README links and outdated verbiage (#3484) (51e6d7a)
• Updated compatibility report (#3477) (859f27f)

Support statement:

We recommend updating to the latest agent version as soon as it's available. If you can't upgrade to the latest version, update your agents to a version no more than 90 days old. Read more about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notes

Bug fixes

• Updated express instrumentation to properly instrument an array of middleware defined on a route (#3473) (e383c4e)

Documentation

• documented how to use the subscriber based instrumentation (#3432) (3b3ab72)
• Updated compatibility report (#3471) (964543b)

Support statement:

We recommend updating to the latest agent version as soon as it's available. If you can't upgrade to the latest version, update your agents to a version no more than 90 days old. Read more about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notes

Bug fixes

• Updated middleware wrapper to not wrap handler if it is not a function (#3469) (c702689)

Documentation

• Updated compatibility report (#3466) (5853657)

Support statement:

We recommend updating to the latest agent version as soon as it's available. If you can't upgrade to the latest version, update your agents to a version no more than 90 days old. Read more about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notes

Features

• Added instrumentation for http2 client methods (#3284) (bda7aea)

Bug fixes

• Updated ioredis instrumentation to handle breakage of errors when using .pipeline. (#3457) (49f4d93)
• Updated openai instrumentStream function to handle empty chunk when include_usage is set (#3427) (f804940)

Code refactoring

• Update express instrumentation to subscribe to events emitted (#3424) (bbf3d01)
• Updated instances in instrumentation of Array.forEach for a more performant for...of or for index loop (#3463) (99484ce)
• Updated instances of Array.forEach for a more performant for...of or for index loop (#3440) (48c37bf)
• Updated token calculation for aws-bedrock LLM Events (#3445) (9450181)
• Updated token calculation for google-genai LLM Events (#3431) (41d32be)
• Updated token calculation for openai LLM Events (#3430) (b8678cc)

Documentation

• Updated compatibility report (#3459) (f253b97)

Miscellaneous chores

• Update release workflows (#3444) (d1ec158)

Tests

• Added a randomString helper to agent_helper and use it in ioredis to avoid flappy tests, also updated local instances of random strings in kafka, elasticsearch and opensearch tests (#3462) (4deb6d8)
• Fixed conflict between ioredis and ioredis-esm by running flushdb instead of flushall to avoid index getting removed mid test (#3464) (5e3f0a8)
• Fixed express async error test to purposely misspell a method to emit a crash (#3435) (ff9f064)
• Moved aws-sdk-v3 common.js requirement of semver (#3461) (6a380ef)
• Pinned Next.js tests to <16.0.0 (#3446) (10787a1)
• Updated minimum tested version of @langchain/core to 1.0.0 (#3437) (b61f67a)

Support statement:

We recommend updating to the latest agent version as soon as it's available. If you can't upgrade to the latest version, update your agents to a version no more than 90 days old. Read more about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notes

Code refactoring

• Updated fastify instrumentation to subscribe to events emitted (#3407) (51e361e)

• Updated pg and pg-native instrumentation to subscribe to events emitted (#3397) (04af258)

• Updated config.instrumentation.timers.enabled to false to disable timers.setTimeout and timers.setInterval by default. (#3414) (b925d3d)

  • 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) (fef98dd)

Miscellaneous chores

• Added a new diagnostics base class and migrated undici to use new class (#3408) (8047bf1)
• Created directory for samplers (#3419) (dd2d3df)

Styles

• Require check-types and require-returns-type jsdoc (#3400) (e4cd687)
• Require jsdoc check*, implements-on-classes, and some no-undefined-types (#3404) (4fa645b)
• Require jsdoc require-returns-check and require-property-* (#3403) (1008073)

Tests

• Added helper to get version of package when package.json not exported, and updated tests that need it (#3411) (5ae02c7)
• Fixed fastify segment tree assertion when security agent is enabled (#3422) (b2cf6ed)
• Refactored mcp tests to listen on new port for every streaming test, removed unncessary shutdown of process (#3420) (17db813)
• Updated an openai assertion with setTimeout disabled (#3421) (ceec8f9)

Support statement:

We recommend updating to the latest agent version as soon as it's available. If you can't upgrade to the latest version, update your agents to a version no more than 90 days old. Read more about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)