Node.js agent release notesRSS

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

Notes

Bug fixes

• Updated message consumer subscribers to properly time the consumption actions (#3660) (ef1b611)

Documentation

• Updated compatibility report (#3654) (ca16dae)

Miscellaneous chores

• Update OTEL metrics test (#3661) (ae84b62)

Tests

• Added cross agent tests for sampler configuration and sampling rate scenarios (#3648) (fa0e2d1)

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 getHostnameSafe to invalidate the cache is trying to assign the host based on the gcp cloud run id (#3650) (d395c76)
• Updated logic to properly assign content and role in LangChain chat completion messages (#3638) (407bcb6)

Documentation

• Updated compatibility report (#3643) (8929ab3)

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 entity_guid to Agent Control health file (#3594) (f42a501)
• Added instrumentation support for iovalkey (#3612) (55f5d6e)
• Added support for OTel span events (#3600) (5b7c340)
• Additional support for partial granularity traces (Not available for production use)
  • Added compact type for partial granularity traces. (#3608) (73b0381)
  • Added core tracing supportability metrics (#3610) (c465f4c)
  • Updated metric names for full and partial traces to consolidate like values (#3620) (b201338)

Bug fixes

• Account for links added during transaction (#3606) (488b678)
• Updated samplers to properly assign sampling decisions based on appropriate context (#3641) (4bbdddf)
• Updated undici instrumentation to track the active and parent segment as symbols on request to properly end active request (#3619) (9baebe5)

Code refactoring

• Removed unused distributed_tracing.in_process_spans.enabled logic. Partial granularity tracing replaces it (#3611) (1d5584e)
• Updated @langchain/core instrumentation to subscribe to events emitted (#3493) (d1e90e4)

Documentation

• Updated compatibility report (#3635) (74ac737)

Miscellaneous chores

• Changed Langchain to LangChain, expand version range (#3629) (d77239e)
• Copy OTEL status metadata to segment (#3613) (4057e80)
• deps: Updated @newrelic/security-agent to v3.0.0 (#3637) (a84fa74)
• Don't create OpenAI segments if ai_monitoring is disabled (#3625) (b4f0010)
• Limit number of span links on segments (#3621) (c923c30)
• Updated Azure publishing with OIDC steps (#3633) (14c41c0)

Tests

• Centralized indices for redis versioned tests (#3636) (34f6562)
• Changed LangChain tool test to >=0.2.0 (#3631) (3a4980f)
• Fix LangChain test targets (#3634) (6504eb8)
• Refactored LangChain versioned tests (#3624) (12ae601)

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 AWS Lambda instrumentation to skip wrapping handler callback if not present (#3602) (d56e27d)

Documentation

• Updated compatibility report (#3596) (ed24527)

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