Node.js agent release notesRSS

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.

Notes

Features

• Added deserialized X-NewRelic-Synthetics-Info header to transaction and transaction trace intrinsic attributes (#1912) (7ed64bd).
  • The attributes in transactions are: nr.syntheticsType, nr.syntheticsInitiator, and nr.synthetics<attributeKey(s)>.
  • The attributes in transaction traces are: synthetics_type, synthetics_initiator, and synthetics_<attribute_key(s)>.
  • It will also include the X-NewRelic-Synthetics-Info header in outgoing http requests.
• Added instrumentation for Restify async handlers (#1910) (1a3f87f).

Bug fixes

• Update import-in-the-middle to fix ESM on Node 18.19.0 (#1906) (e9c3748).

Code refactoring

• Change dynamic import to work with bundlers (#1905) (ee81429).

Miscellaneous chores

• Add AWS Bedrock feature flag (#1913) (91019b0).

Continuous integration

• Removed step in post release process to update an internal system with the latest agent version (#1909) (2080b1f).

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 here.

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

• deps: Updated @newrelic/aws-sdk to 7.0.3 (#1902) (bf22ae5)
• Updated shimmer to handle instrumenting named and default exports of CommonJS modules in ESM (#1894) (9f7979c)

Code refactoring

• Fixed cognitive complexity violations of openai instrumentation by moving functions outside of the parent function scope (#1895) (31dc717)
• Updated span names of openai actions to allow AI O11y team to locate relevant spans (#1896) (b7a644d)

Miscellaneous chores

• Improve OpenAI mock server streams (#1890) (d12bfe4)

Tests

• Fix winston-esm versioned tests (#1898) (6e02e57)
• pin undici versioned below 6.0.0 on Node 16 (#1900) (9973b24)

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 openai.
  • This feature is in limited preview and will be off by default.
  • Aside from creating spans for chat completions and embeddings, it will create custom events that drive the New Relic AI Monitoring.
  • Added instrumentation for chat completion streams (#1884) (404e317)
  • Added instrumentation for openai chat completion creation (#1862) (34dcd70)
  • Added instrumentation for openai embedding creation (#1872) (1c62321)
  • Added ai_monitoring.enabled configuration.(#1873) (52bf9f3)
  • Added Nodejs/ML/OpenAI/<version> metric every time a chat completion or embedding occurs.(#1886) (d11d100)
  • Added setLlmMetadata API to allow users to specify metadata for LLM events (#1863) (85979d7)
  • Ensure API errors are tracked (#1880) (289c2a2)
  • Added getLlmMessageIds and recordLlmFeedbackEvent API methods for tracking LLM feedback (#1868) (1681e4b)
  • Added openai LLM events. (#1857) (a7786f3)
• Added pkgVersion to shim instances to facilitate semver checking without having to re-parse the package.json (#1883) (4ddfd81)

Bug fixes

• Updated isSimpleObject util to only check plain objects not arrays (#1865) (8baa5bc)

Security improvements

• Set log file permissions to read/write for Node process only (#1854) (1b93ec9)

Code refactoring

• Improved custom event attributes checking when using api.recordCustomEvent (#1870) (20e7f1d)

Miscellaneous chores

• dep: Updated @newrelic/security-agent to v0.5.0 (#1877) (2882236)
• dev-deps: bump axios and @slack/bolt (#1871) (2d00b02)
• docs: Updated links in documentation to https (#1888) (f1913ea)
• Fixed bool -> boolean in jsdoc (#1853) (3c00e55)

Tests

• Added streaming responses to mock OpenAI sever (#1881) (86d83f2)
• Added unit tests for LLM API methods (#1878) (3d8b987)
• Added a mock server for openai testing (#1858) (3b1f5e6)
• Fixed shadowed variable lint error in pino versioned tests (#1859) (e1b21eb)
• Updated openai versioned tests to properly work with the legacy context manager (#1876) (a879700)

Continuous integration

• Made release note date always in pacific time (#1855) (6d7dc69)
• Remove updating staging with newly release agent version (#1887) (9d38faa)

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