Node.js agent release notesRSS

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

Notes

Miscellaneous chores

• dep: Updated @newrelic/security-agent to v0.4.0 (#1837) (fb06ac9)

Continuous integration

• Disable fail-fast on nightly versioned test runs (#1836) (fe1b4fc)

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 support for parsing container ids from docker versions using cgroups v2. (#1830) (9892901)

Miscellaneous chores

• [Snyk] Upgraded @grpc/grpc-js from 1.9.2 to 1.9.4. (#1823) (81f9450)
• deps: Updated aws-sdk, koa, superagent (#1831) (8b4e963)

Tests

• Increased timeout for integration tests to avoid random failures. (#1827) (5202048)

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

• Updated agent initialization to allow running in worker threads when config.worker_threads.enabled is true (#1817) (a39f0ef)

Bug fixes

• Updated Elasticsearch instrumentation to register on v7.13.0+ only (#1816) (6437671)

Miscellaneous chores

• dev-deps: Bumped @babel/traverse (#1818) (d3c8d04)
• Updated release note headers to follow standard sentence caps (#1806) (91d3600)

Tests

• Updated the grpc versioned tests utils to dynamically bind ports to avoid conflicts between cjs and esm tests (#1820) (95ac917)

Continuous integration

• Disabled fail-fast on testing jobs to make sure all versions are run before getting canceled because of a flappy test (#1819) (0928ee3)
• Updated CI workflow to use larger runners on versioned tests but only when running against the main branch (#1812) (01eaa14)
• Updated post release script to update the nodejs_agent_version only on staging and us prod, eu will get it via replication now (#1811) (317a00a)

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 initialization to return the API on start up to the security agent properly (#1807) (99e5792)

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 ElasticSearch (#1785) (a748b84)

Bug fixes

• Updated agent to create a stub api when running in a worker thread to avoid Next.js early return errors (#1800) (636e8f0)
• Updated shimmer to allow registering instrumentation for different versions of the same module (#1799) (30f0b16)

Miscellaneous chores

• deps: Updated @newrelic/security-agent to v0.3.0 (#1786) (9ca78ae)
• Separated running versioned tests between local and external (#1792) (6ffe2f6)
• dev-deps Updated get-func-name to fix CVE (#1790) (f378c77)

Tests

• Updated elasticsearch container to ignore highwatermark to function on a constrained environment (#1803) (8380e9d)
• Updated invalid json pino test as this was fixed in 8.15.1 of the pino library. (#1782) (3e65fdc)

Continuous integration

• Added steps to zip up container logs on versioned test failure (#1804) (0a54729)

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