Node.js agent release notesRSS

Notes

Features

• Added instrumentation for chain.stream for langchain js. (#2052) (03abfce)

Miscellaneous chores

• Added @azure/openai and @langchain/community/llms/bedrock as tracking packages so we can measure usage with angler (#2053) (4830ea3)

Tests

• Updated aws-sdk branch to main as the necessary code was merged. (#2051) (1e52a5c)

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 RunnableSequence (#1996) (71ffa37)

• Added LangChain error events capture (#2040) (4d0d839)

• Added ai_monitoring.streaming.enabled. When set to false this will not instrument chat completion streams, thus it will not create relevant Llm events. (#2021) (ff78b51)

• Added ability to recordLlmFeedbackEvent by traceId (#2043) (b0a4ed1)

• Added instrumentation for langchain tools. (#2009) (695d10e)

Code refactoring

• Updated AIM instrumentation (#2015) (d37d2a8)

  • removed capturing last 4 of api key
  • included all custom attributes prefixed with llm. as attributes on all Llm events
  • changed tracking metric to start with Supportability

• Updated capturing conversation_id on Llm Events as llm.conversation_id (#2020) (5f93f65)

• Updated instrumentation to construct specs at source instead of within the shim methods (#2035) (ead8c25)

  • Simplified the logic in shim.recordQuery and shim.recordOperation to reduce merging of spec properties and rely on the constructed spec

Documentation

• Added note about using sudo for firewall script (#2032) (bf106d2)

• Fixed spec objects parameter definitions (#2024) (4378173)

Miscellaneous chores

• Added missing is_response to LangChain completion messages (#2044) (20c7d47)

• Attached specs to the Shim.prototype for use in custom instrumentation and instrumentation outside of the agent (#2038) (2c97488)

• deps: Updated to use @newrelic/ritm from require-in-the-middle (#2034) (ffb729f)

• Updated DatastoreParameters to include collection (#2039) (b9c73ca)

Tests

• Cleaned up pending mocks in the log dropping test to avoid a console warning around pending mocks in after each (#2017) (d2f40c2)

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

• Resolved application logs getting blocked when encountering an excessive payload (#2013) (365ded4)
• Updated Shim to properly calculate the _moduleRoot on Windows environments (#2014) (ab0bd7f)

Code refactoring

• Abstracted registering of new aggregators into a Harvester class that's responsible for starting, stopping, and updating all registered aggregators. (#1994) (1fb85a6)
• Refactored specs into classes for easier code navigation (#2004) (4daedc0)

Miscellaneous chores

• deps: Updated @newrelic/security agent to v1.0.1 (#2002) (b460c7b)

Tests

• Updated smoke tests to send data to the appropriate collector method (#2005) (6130486)

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

Features

• Added feature flag for LangChain instrumentation (#1990) (ab04e7a)
• Added message entities for LangChain (#1983) (6b44a3a)
• Added vectorsearch entities (#1992) (ef74b2e)

Bug fixes

• Updated grpc-js instrumentation to properly track errors and end transactions (#2001) (fda1346)

Documentation

• Removed documentation around aws_bedrock_instrumentation as feature flag has been removed (#1991) (f414564)

Miscellaneous chores

• Fixed third-party notices and package lock as they were out of sync. (#1999) (a89def8)

Tests

• Updated prisma versioned test range to skip 5.9.0 as it was broken (#1993) (d885286)

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. You can read more about keeping agents up to date in our documentation.

For information about agent releases and support dates, please see our New Relic Node.js agent EOL policy documentation.

Notes

Bug fixes

• Updated winston instrumentation to wrap configure to properly retain our transporter to do log forwarding (#1987) (b54a97f)

Documentation

• Fixed jsdoc generation by marking private methods as @private (#1976) (f33c0cc)

Miscellaneous chores

• Update eslint config (#1980) (8991a15)

Tests

• Pinned prisma instrumentation testing to <5.9.0 until we can fix issues with instrumentation (#1985) (5eae6ee)

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 instrumentation registration to allow for instrumenting of a local file that does not exist within node_modules.
  • To properly instrument a local file, you must pass in absolutePath with the absolute path to the file that is being instrumented along with the moduleName which in this case is just the file name without the extension. (#1974) (f545b4e)

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 llm attribute to all transactions that contain llm spans for openai (#1946) (6312629)
• Added transaction ID to ErrorTrace event (#1954) (5d0ebcd)

Security improvements

• remote_method: Redacted ingest key in trace level logs (#1948) (04fee88)

Code refactoring

• Updated lib/shim/shim.js to remove cognitive complexity violations (#1950) (60e57a1)
• Updated message-shim to remove cognitive complexity violations. (#1958) (3d1caaf)

Miscellaneous chores

• deps: Updated @newrelic/aws-sdk to latest and removed aws_bedrock_instrumentation feature flag (#1956) (9eae28c)
• deps: Updated @newrelic/security-agent to v0.7.0 (#1955) (e156539)
• Migrated non-sensitive CI values to vars (#1957) (1739378)
• updated contributors list to include james and svetlana 🎉 (#1947) (33a59fd)

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

• Assign pkgVersion and id of all child shim instances when using shim.makeSpecializedShim with a ConglomerateShim instance (#1941) (d3e393d)

Bug fixes

• Dropped support for ElasticSearch < 7.16.0 (#1940) (e017768)

  • Previously, New Relic's Node.js agent instrumented ElasticSearch as early as v7.13.0, which was susceptible to crashing when using ElasticSearch's .helper API. ElasticSearch fixed this bug in v7.16.0, so we now support instrumentation from that version onward, and previous versions are noops.

• Removed extra / in openai framework metric name (#1938) (7f586c3)

Security improvements

• deps: bump follow-redirects from 1.15.2 to 1.15.4 (#1942) (c1b04b6)

Miscellaneous chores

• Removed assigning unused metadata to LLM events (#1932) (2f67d49)

Tests

• Fixed DNS lookup in remote-method test (#1937) (4da2149)
• Removed console log (#1939) (7d378aa)
• Updated abort controller test expected error message based on undici version (#1935) (3e79cc7)
• Updated chat-completions tests to properly assert segments (#1931) (10762a7)

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

• Removed api.setLlmMetadata (#1918) (cc4a975)
  • Instead, the api.addCustomAttribute will have the llm prefix.
  • The conversation_id will be assigned from llm.conversation_id custom attribute
• Updated SQL obfuscation tokenizer to better handle negative numbers and boolean values.

Bug fixes

• Ensure opts.headers is defined in http instrumentation (#1926) (7ea31a3)

Code refactoring

• Updated lib/instrumentation/core/http.js to reduce the cognitive complexity to an allowable value (#1922) (4c30d97)
• Updated lib/shim/promise-shim.js to reduce the cognitive complexity (#1924) (bd0a5dc)
• Updated lib/shim/webframework-shim.js to reduce the cognitive complexity (#1927) (1ce371e)

Miscellaneous chores

• deps: Updated @newrelic/security-agent to v0.6.0 (#1929) (4e09927)

Tests

• Refactored tests now use tap if they still use the tap mocha shim + chai. (#1919) (957529e)
• Removed access to deprecated req._headers and instead use req.headers (#1923) (0ec2f66)
• Updated the cross agent tests, made updates to tests based on fixture changes (#1917) (2d666b6)
• Updated helper.randomPort to use crypto.randomInt instead of Math.random by using crypto lib (#1921) (9003791)

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.