Node.js agent release notesRSS

Notes

Features

• Added support for Continuous Profiling (#3834) (6d8d5b5)
  • Added server-side configuration for profiling.enabled (#3790) (0d44e5b) (#3847) (e57223c)
  • Added delay + duration to ProfilingAggregator (#3815) (8000665)
  • Added supportability metrics for profiling (#3801) (19bbb7e)
  • Prevented ProfilingAggregator from running in serverless mode (#3806) (e4db0f4)
  • Disabled profiling.enabled when high security mode is enabled (#3803) (9d4eebb)
  • Added Heap profiler (#3751) (8262f6b)
  • Added Cpu Profiler (#3747) (2c2097f)

Note: Continuous Profiling UI is coming soon! While the Node.js agent now supports Continuous Profiling data collection, the visualization experience will debut in Limited Preview starting next week. If you would like to get early access to the profiling dashboards and UI features, please reach out to your Account Executive (AE) about how to opt-in to the preview.

Code refactoring

• Refactor winston instrumentation to subscribe to events emitted (#3808) (4af2f48)

Documentation

• Updated compatibility report (#3824) (0cfb356)

Tests

• Added segment duration tests for ioredis/iovalkey (#3825) (9738bc8)
• Added segment duration timing tests for mysql2 (#3820) (bb424ff)
• Changed structure of bedrock tests to avoid getting instrumented core libraries from first test (#3838) (886a36c)
• Changed structure of lambda and sns tests to avoid getting instrumented core libraries from first test (#3836) (414044d)
• Updated @aws-sdk/lib-dynamodb version range (#3829) (d28c938)

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 @apm-js-collab/tracing-hooks to 0.5.0, to allow instrumentation on windows environments. (#3819) (d8f6d0f)
  • This version of @apm-js-collab/tracing-hooks includes the windows path fix for @apm-js-collab/code-transformer, see.

Code refactoring

• Updated redis v3 instrumentation to subscribe to events emitted (#3802) (4d18302)

Documentation

• Updated compatibility report (#3813) (27cb0a5)

Tests

• Add redis-client and node-redis-client segment duration timing tests (#3810) (f07bcfe)

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 time_to_first_token for LlmChatCompletionSummary (#3781) (737f374)
• Added time_to_first_token for AWS Bedrock (#3804) (a993b00)
• Added time_to_first_token for Google Gen AI (#3785) (d90ee70)
• Added time_to_first_token for OpenAI (#3782) (07cfd57)

Code refactoring

• Migrated redis 4+ instrumentation to subscribe to events emitted (#3773) (add6827)

Documentation

• Updated compatibility report (#3800) (5228cdc) (#3795) (1d6fe52) (#3791) (e79db5b) (#3777) (12fe4c6)

Miscellaneous chores

• Added version comment for agent-metadata.yml (#3779) (1267293)
• Refactored nestjs instrumentation to subscriber type (#3792) (f7feb25)
• Removed @langchain/core peer dep from langchain openai and aws tests (#3788) (e670bb1)
• Removed unneccessary generic-pool context propagation (#3786) (bdd35fb)
• Removed unnecessary superagent context propagation (#3798) (81650e1)
• Updated @apm-js-collab/tracing-hooks to 0.4.0 (#3787) (d85fb2b)
• Updated version format in agent-metadata.yml (#3778) (61759e9)

Tests

• Updated langchain vectorstore tests to use a custom vectorstore to simplify the testing process (#3793) (0fd9b54)
• Updated version range for langgraph tests (#3794) (e02ce99)

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 ability to delay the start of the Profiler and run for n milliseconds before shutting down. (#3758) (8503d25)
• Added functionality to ingest logs from Azure Functions App automatically (#3772) (0c70ba2)
• Added support for error causes (#3769) (7c5aae3)

Bug fixes

• Updated @google/genai subscriber to handle the new embedContentInternal method in 1.42.0 (#3771) (e96c974)

Code refactoring

• AWS Bedrock llm events refactor (#3759) (7ff953d)
• Google Gen AI LLM event refactor (#3748) (f1e3a0e)
• LangGraph LlmAgent event, remove old LlmEvent base (#3761) (39d1d9a)
• Updated the reparenting logic for compact mode of partial traces to assign parent id to entry span (#3768) (5196318)

Documentation

• Updated compatibility report (#3774) (5d04bba)

Miscellaneous chores

• Added API key to enable support for GH action (#3760) (a521e80)
• Added call to agent metadata workflow - step 1 (#3750) (90eeaec)
• Added span id to all debug/trace level logs in span.applyPartialTraceRules (#3766) (8c57230)
• Renamed file and fix cache output (#3757) (1ac00ea)
• Set up metadata action to run with releases (#3762) (66efb13)
• Updated @langchain/core version for langchain-openai tests (#3763) (c27213e)

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

Feature Release

With this release, we are making available our Node.js Hybrid Agent. The Node.js Hybrid Agent provides a future-proof observability solution with integrated support for OpenTelemetry Tracing, Metrics, and Logs APIs. Key enhancements like Span Links and Events on Spans are now available, ensuring seamless interoperability in mixed-mode environments. It is designed to bridge the gap for Node.js teams looking to adopt OpenTelemetry standards while maintaining backwards compatibility with their existing New Relic dashboards.

A full product announcement, and documentation for this feature, is coming soon. Please subscribe to our news releases to be kept up-to-date.

Features

• Added delay and duration to profiling config (#3754) (a7f06e0)
• Added ProfilingAggregator that will be used to collect and send pprof_data telemetry (#3732) (738045c)
• Added profiling configuration (#3733) (2b4d7d8)
• Added ProfilingManager class, used to orchestrate profilers (#3738) (105da3b)
• Updated RemoteMethod to handle sending pprof_data through the collector (#3734) (868e5bd)
• Updated the profiling config properties (#3742) (fa55881)

Code refactoring

• LangChain LLM event refactor (#3745) (b2612ec)
• OpenAI LLM event refactor (#3726) (0ccad21)

Documentation

• Updated compatibility report (#3743) (4a7cafc) (#3739) (59ff976) (#3730) (dea410b) (#3703) (532729a)

Miscellaneous chores

• Added subcomponent attribute to LangChain tool traces (#3706) (c5469ea)
• Added subcomponent attribute to mcp-sdk invocations (#3749) (70b7f41)
• Enabled all OTEL signals by default when OTEL is enabled (#3712) (15b82c2)
• Fixed @langchain/community peer dep conflict (#3741) (202d2b3)
• Removed @langchain/core peer dep from LangGraph test matrix (#3737) (8ba2616)
• Renamed OTEL metrics config params to snake_case from camelCas… (#3711) (4f59108)
• Updated ai-support.json to include LangGraph (#3705) (aa0ba22)
• Updated eslint configuration (#3740) (d306374)

Tests

• Updated mcp streaming tests to generate sessions to reuse transport for all streaming tests (#3729) (1772fd5)

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

Security

• Bumped minimum version of security agent (#3713) (88b2334)

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 support for @langchain/langgraph (#3645) (f339675)
• Added timestamp to LlmChatCompletionSummary messages
  • Added timestamp to AWS Bedrock LlmChatCompletionSummary (#3702) (430d1dd)
  • Added timestamp to Google Gen AI LlmChatCompletionSummary (#3690) (7748e26)
  • Added timestamp to LangChain LlmChatCompletionSummary (#3701) (7472118)
• Added compact mode for span links (#3681) (6ff6961)

Bug fixes

• Updated langchain tool instrumentation to properly redefine the segment name on every call (#3691) (4df6068)

Documentation

• Updated compatibility report (#3699) (40b6b81)

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 timestamp to AIM LlmChatCompletionMessage messages
  • Added timestamp to AWS Bedrock LlmChatCompletionMessage (#3685) (ea297c8)
  • Added timestamp to Google Gen AI LlmChatCompletionMessage (#3686) (f4dd09e)
  • Added timestamp to LangChain input LlmChatCompletionMessage (#3658) (0bce235)
• Added timestamp to OpenAI LlmChatCompletionSummary (#3689) (55b0310)
• Additional support for partial granularity traces (Not available for production use)
  • Added essential tracing mode for span links (#3670) (83dfb84)
  • Updated Supportability/Nodejs/PartialGranularity/NrIds/Dropped metric to only keep track of spans that got dropped when nr.ids execeeded 63 spans. (#3684) (9797cf3)

Bug fixes

• Added defensive code in lib/subscribers/middleware-wrapper.js to prevent crash when attempting to associate an error on an incoming http request (#3697) (658e78b)
• Updated pg instrumentation to properly capture the TraceSegment duration for promise based queries (#3695) (0051697)

Code refactoring

• Added AIM abstract subscribers and updated all AIM subscribers to use them (#3676) (08cd38b)

Documentation

• Updated compatibility report (#3675) (cc898f4)

Miscellaneous chores

• Added TimedEvent limit of 100 (#3683) (0d595d8)
• Added supportability metrics Supportability/Nodejs/SpanEvent/<Links|Events>/Dropped when limit of 100 is exceeded (#3688) (a247d31)
• Removed eslint disable next line for sonarjs/no-dead-store (#3692) (593fa15)

Continuous Integration

• Fixed CI issue when sec-agent present (#3677) (23da654)

Tests

• Assert that span events drop in partial traces (#3680) (25e3781)

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

• Add timestamp to OpenAI input LlmChatCompletionMessages (#3657) (099e20e)
• Added reduced tracing mode for span links (#3649) (2414331)

Bug fixes

• Updated OpenAI instrumentation to properly parse headers when a call fails (#3665) (641b7a8)

Documentation

• Updated compatibility report (#3669) (ec922ae) (#3668) (85c601f) (#3663) (82b3ac8)

Miscellaneous chores

• Lazy load OTEL dependencies (#3667) (0b0c764)
• Record subscriber usage metric (#3626) (5796574)
• Update ai-support.json (#3666) (562b403)
• Updated OpenAI instrumentation to skip creating a LlmChatCompletionMessage for an outgoing tool call response (#3655) (572c3a1)

Tests

• Updated mock response to avoid retries on OpenAI LangChain vectorstore calls (#3664) (bc1faf3)

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