Node.js agent release notesRSS

Features

• Added support for @opentelemetry/api@1.10.0 (#4392) (504490d)
  • For customers directly using @opentelemetry/api-logs, they must remove and update to use @opentelemetry/api 1.10.0+. See the OpenTelemetry API changelog for more information.
  • For customers registering 3rd party instrumentation for logging libraries they must update to the following: @opentelemetry/instrumentation-pino to 0.70.0+, @opentelemetry/instrumentation-bunyan to 0.69.0+, @opentelemetry/instrumentation-console to 0.6.0+, or @opentelemetry/instrumentation-winston to 0.69.0+

Bug fixes

• Collapsed Apollo Server argument array metrics (#4350) (baf35fd)
  • To take advantage of this feature you must set both config.apollo_server.field_metrics and config.apollo_server.collapse_field_metrics to true. Thanks to @cpruijsen for your contribution!
• Stopped net.js from pinning ended transactions to long-lived sockets (#4411) (471e7df)

Performance improvements

• Simplified mongodb bulk instrumentation to match execute directly (#4406) (af4efdb)
• Wrapped mongodb driver methods at the prototype level (#4399) (9074abc)

Documentation

• Updated compatibility report (#4403) (813c05b) (#4402) (33cff90)

Miscellaneous chores

• Removed obsolete timers instrumentation (#4410) (ccbd6c5)

Tests

• Fixed @langchain/aws@1.5.1 error tests retrying on mock failures (#4412) (648801f)

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.

See the New Relic Node.js agent EOL policy for information about agent releases and support dates.

Features

• Added --dump to validate-config to emit the effective configuration (#4390) (fe3e684)
• Added a validate-config CLI command (#4341) (821848d)
• Flagged a missing OpenTelemetry bridge as a validate-config startup blocker (#4396) (75397be)
• Reduced instances of the schema file to be just one instance in schema.json (#4379) (a870c3b)
• Shared startup-blocker checks between the agent and validate-config CLI (#4378) (06e6596)

Bug fixes

• Bounded module version resolution at filesystem root (#4393) (71c90b6)
• Fixed http2 client handling of missing headers, default ports, IPv6 hosts, and unparseable URLs (#4362) (0eef6a6)
• Loaded the code-level metrics function inspector once instead of on every call (#4391) (01d2797)

Performance improvements

• Reduced CPU per SQL query by skipping slow query processing below explain_threshold (#4376) (047e2cd)

Code refactoring

• Migrated http2 client instrumentation to subscriber-based (#4360) (8f5b504)

Documentation

• Updated compatibility report (#4388) (cbb6970) (#4363) (3cc962d)

Miscellaneous chores

• Fixed MAXIMUM_TIMEOUT_TIME in lib/otel/metrics/index.js to be the correct expected value (#4365) (39b037c)
• Updated linter to latest version (#4351) (a1a30f5)
• Added CLI tool help note about derived settings (#4398) (7c8b36d)

Tests

• Attempted to fix flaky tests (#4383) (01ddfd8)
• Pinned version of @opentelemetry/api to 1.9.0 (#4387) (525b81c)
• Updated got to latest to ensure it is up to date (#4364) (b586275)

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.

See the New Relic Node.js agent EOL policy for information about agent releases and support dates.

Notes

Bug fixes

• Prevented nested server/consumer spans from ending the outer transactions early (#4355) (1a41313)
• Truncated every string within an array based span attribute (#4358) (9276106)

Code refactoring

• Handled updating segment name on internal spans when span.updateName is used after span is created (#4356) (320b7e6)
• Updated span process onEnd logic to skip attaching stacktrace to error when span lacks stack trace (#4357) (d318777)
• Added instrumentation for dns.promises, dns.Resolver, dns.promises.Resolver, and additional resolve* methods (#4321) (e1e7784)
• Refactored net instrumentation to subscriber-based (#4322) (0123e56)

Documentation

• Updated compatibility report (#4348) (0a01c40)

Miscellaneous chores

• Added method wrapper separate from shimmer (#4306) (903b2d9)

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 a new api setApolloResolverFilterCallback to allow customers to filter out resolver segments before they are created (#4312) (0d89bde)

Bug fixes

• Updated the channel name for resolver fields in ESM to nr_resolve (#4346) (e8b294c)
• Wrapped openai stream [Symbol.asyncIterator] so synthesized message survives v7 chunk normalization (#4342) (aa8ed4b)

Code refactoring

• Removed reliance on @opentelemetry/sdk-logs for hybrid agent (#4318) (1d05075)
• Removed reliance on @opentelemetry/sdk-trace-base for hybrid agent (#4297) (00c363b)

Documentation

• Added an empty enhancements array to docs PR (#4344) (b505eda)
• Updated compatibility report (#4339) (6204ebb)

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 a pre-compiled config schema validator (#4320) (c965a33)

Bug fixes

• Ended the transaction and recorded the error when an Azure Functions handler throws (#4310) (918ef55)

Code refactoring

• Migrated fs instrumentation over to subscriber-based (#4317) (4711f4c)
• Migrated core globals instrumentation to subscriber-based (#4300) (7827797)
• Refactored the Transaction class and affected other entities (#4246) (b965d8e)

Documentation

• Updated compatibility report (#4305) (fb5a184)

Miscellaneous chores

• Added excludedPkgs list to instrumentation and added globals to it (#4334) (4f356f5)
• Migrated configuration to JSON Schema (#4284) (39cdebc)
• Regenerated agent config json schema (#4335) (4c199a5)
• Removed domain and inspector instrumentation and old zlib file (#4331) (f887492)
• Updated agent-types 1.0.0 (#4307) (175a4ba)

Tests

• Sped up newrelic-response-handling by always clearing nock (#4329) (31494cc)

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 segment.getExclusiveDuration to only attempt to calculate and cache the durations of all segments in a trace once (#4303) (563f743)

Performance improvements

• Updated algorithm for hashes.makeId to be 3x more performant (#4286) (6737071)

Code refactoring

• Consolidated core subscriber configs into a single file (#4294) (a6adc6d)
• Migrated core crypto instrumentation to subscriber-based (#4293) (8848d84)
• Refactored zlib instrumentation to be subscriber based (#4299) (e4ede21)
• Removed reliance on @opentelemetry/core for hybrid agent (#4295) (8a83507)

Documentation

• Updated compatibility report (#4282) (87be369)

Miscellaneous chores

• Fixes issues in CI (#4285) (6e61b03)

Tests

• Replaced test helper with native Promise.withResolvers (#4301) (be5f3f3)

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 browser_monitoring.version configuration option (#4269) (b62ca00)
  • When this is set, it will pin the browser agent version when using newrelic.getBrowserTimingHeader to the version selected.
  • If you specify a version that is no longer supported or invalid, it will not resolve to any browser agent when calling newrelic.getBrowserTimingHeader.

Bug fixes

• Updated undici instrumentation to not attempt to create an external segment when transaction is not active (#4278) (d634246)
• Updated http2 instrumentation to properly inject traceparent header with external segment id (#4279) (ccd7800)

Code refactoring

• Refactored child_process instrumentation to use tracing channel instead of Shim (#4212) (5a39c38)
• Refactored dns instrumentation to subscribe to events emitted (#4224) (c04289f)

Miscellaneous chores

• Regenerated agent config json schema (#4275) (c2107ed)
• Update secret naming (#4277) (09f5b25)

Tests

• Added legacy-peer-deps to google adk tests to avoid peer dep conflict (#4280) (e4a6b35)

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.

See the New Relic Node.js agent EOL policy for information about agent releases and support dates.

Notes

Features

• Added support for MessageBroker/Kafka/Cluster/{cluster_id}/{Produce|Consume}/{topic_name} metrics (#4263) (3be98f1)
• Updated GCP hostname to support more Cloud Run instance types (#4256) (67bfd0d)

Bug fixes

• Fixed duplicated router mount path in transaction names for async middleware (#4272) (51a3bf4)
• Fixed otlp payload format for metrics in AWS Lambda (#4270) (5d29078) (upcoming feature; not yet available)

Documentation

• Updated compatibility report (#4273) (40b3172) (#4267) (b4fa928) (#4253) (9fe7038)

Miscellaneous chores

• Deprecated utilization.gcp_use_instance_as_host in favor of utilization.gcp_cloud_run.use_instance_as_host (#4258) (450303e)

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

• Prevented duplicate external segments when undici negotiates HTTP/2 (#4251) (c94b81b)

Code refactoring

• Split BedrockResponse and BedrockCommand into Converse and InvokeModel variants (#4235) (8235cf5)
• Updated Claude detection logic in InvokeModelCommand (#4245) (b090344)

Documentation

• Updated compatibility report (#4249) (f69eecd)

Miscellaneous chores

• Pinned nestjs to unblock CI (#4248) (44abb5d)

Tests

• Added type: module for @nestjs/core tests, including version 12 (#4252) (7971d05)

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/)