Node.js agent release notes

Node.js agent v1.18.1

Thu, 02 Apr 2015 00:00:00 +0000

Notes

Names assigned to errors via Error.name now appear in the UI.

Previously, the name of an error in the UI appeared as Error.constructor.name or with a default of Error. Now the common pattern of Error.name is respected and takes precedence.
Child segments of external calls will now be nested correctly.

This change causes segments that make up external calls to nest under the call correctly. Previously, the child segments appeared as siblings to external calls.
The request_uri attribute on errors will now only include the path without any parameters.

This behavior now matches the other New Relic agents.

Node.js agent v10.0.0

Wed, 19 Apr 2023 00:00:00 +0000

Notes

BREAKING - Updated the default of config.transaction_tracer.record_sql from off to obfuscated. This means that sql statements will be captured but obfuscated.
BREAKING - Route (URL) parameters are now stored as request.parameters.route.* attributes on Transactions, root Segments and Spans.

After this change, the following becomes true:
- Query parameters will be available as attributes prefixed with request.parameters.* on Transactions and Spans.
- Route parameters will be available as attributes prefixed with request.parameters.route.* on Transactions and Spans.
- Route parameters (aka url parameters) are a common feature of various web frameworks, where you can create a placeholder as part of an API route definition.
  
  For example, given the following Express route definition and request url:
```
app.get('/api/users/:id', myMiddleware, myController)
```
```
curl http://localhost:3000/api/users/abc123?id=true
```
  The route parameter is id, and has a value of abc123. This would become request.parameters.route.id: abc123 on the Transaction, root Segment, and Span attributes. This example also has a query parameter of id, which has a value of true. This would become request.parameters.id: true on the Transaction, root Segment, and Span attributes.
BREAKING - Removed captureUrlParams from WebFrameworkShim class.
DEPRECATION NOTICE: shim.unwrap and shim.unwrapOnce will no longer function if you attempt to unwrap an item that has been wrapped multiple times.
- This is because since we now allow instrumenting the same module more than once, you cannot safely unwrap without breaking all registered instrumentation. We plan to remove shim.unwrap and shim.unwrapOnce in the next major release.
Added the ability to register instrumentation multiple hooks (onRequire, onResolved) for the same resolved moduleName.
- This has been a limitation of the agent from the beginning.
- If you used the api to instrument api.instrument, api.instrumentDatastore, api.instrumentWebframework, api.instrumentMessages, or api.instrumentConglomerate, it would override existing instrumentation hooks. The effect was that the Node.js agent would not function as designed.
Refactored lib/transaction/tracecontext.js to reduce cognitive complexity.
Refactored lib/transaction/trace/index.js to reduce cognitive complexity.
Upgraded devDependencies jsdoc, and lean-jsdoc-theme.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v10.1.0

Thu, 04 May 2023 00:00:00 +0000

Notes

Added batching and compression to infinite tracing.
- These options are on by default.
- To restore uncompressed spans set config.infinite_tracing.compression to false.
- To send single spans vs batches set config.infinite_tracing.batching to false.
- The environment variables for these new configurations are: NEW_RELIC_INFINITE_TRACING_BATCHING and NEW_RELIC_INFINITE_TRACING_COMPRESSION.
Added support to record Nest.js error stack traces.
- Nest.js is officially supported via underlying instrumentation of express or fastify.
Added job to create a release notes PR in the post-release workflow.
Removed request library and updated helper to use http/https to make requests in tests.
Reduced cognitive complexity in lib/serverless/aws-lambda.js

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v10.1.1

Mon, 15 May 2023 00:00:00 +0000

Notes

Bug Fixes

updated prisma instrumentation to properly parse database connection strings that work across all versions of prisma (#1634) (b2101fd)

Code Refactoring

run-versioned-tests.sh: added ability to run versioned tests and skip collecting coverage by passing in SKIP_C8 env var to the job. (#1621) (0ba9dcb)

Documentation

update Contribution Guide with Conventional Commit info (#1635) (f1a00e5)

Miscellaneous Chores

pin testdobule to 3.17.2 as 3.18.0 no longer works on node 14 (#1628) (d68bd9f)
remove release-please workflow and scripts (#1624) (80f7eb8)

Tests

pin prisma to 4.14.0 until we fix instrumentation (#1631) (a60659d)
scripts: fix failing changelog unit test (#1626) (08f48b3)
config: increase test coverage (#1625) (67f39d8)
config: revert changes to lib/config/index.js (#1630) (fea1068)

Continuous Integration

changed versioned tests script to use SKIP_C8 (#1621) (83e95e3)
add --use-new-release functionality (#1633) (d97b421)
add ability to generate release notes from conventional commits (#1623) (880a88b)
create-docs-pr: Set username/email to machine user by default (#1627) (3870a1f)
fix issue with missing type in the prep-release (#1638) (9a906e8)
update prep-release to fetch entire history of caller repo (#1641) (428174a)
update to conditionally add CLI flag to prep-release (#1640) (b167c93)

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v10.1.2

Wed, 24 May 2023 00:00:00 +0000

Notes

Bug Fixes

Updated mysql instrumentation to properly wrap the connection pool.getConnection and poolCluster.of (#1647) (4caf1db)
- Added instrumentation to PoolNamespace.prototype.query

Continuous Integration

fix minor release note generation bugs (#1643) (dd6ab9a)

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v10.2.0

Tue, 06 Jun 2023 00:00:00 +0000

Notes

Features

Added supportability metrics to indicate how agent was loaded and if source maps were enabled (#1657) (6f6f7e6)
- Supportability/Features/CJS/Preload - recorded if -r newrelic was used to load agent
- Supportability/Features/CJS/Require - recorded if require('newrelic') was used to load agent
- Supportability/Features/EnableSourceMaps - recorded if node --enable-source-maps was present to start application
Added logging of process.execArgs at the debug level (#1654) (c85c006)

Miscellaneous chores

Updated c8 to merge v8 coverage reports asynchronously to avoid OOM issues (#1652) (34376d7)
Updated explorer hub link in readme (#1656) (c1e81a7)

Tests

Added unit tests for MySQL instrumentation (#1649) (b693ba0)

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v10.3.0

Tue, 13 Jun 2023 00:00:00 +0000

Notes

Features

Added Interactive Application Security Testing(IAST) mode of security agent when config.security.agent.enabled is true. (#1664) (3e926e5)

The New Relic Security agent IAST mode is in public preview and should only be used in non-production environments.

To learn about how to use IAST, check out our documentation.

To enable the security agent set config.security.agent.enabled and config.security.enabled to true.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v10.3.1

Thu, 22 Jun 2023 00:00:00 +0000

Notes

Security

deps: Updated semver to v7.5.2, also in native-metrics and test utils (#1685) (e207a6b)

Miscellaneous Chores

Added test for getRedisParams (#1670) (e9f8556)
temporarily limit prisma tests to non-breaking version (#1680) (76d3ade)
testing: convert query-test-aggregator tests to tap style (#1676) (d2e45ad)
testing: Converted error-event-aggregator.test.js to tap (#1683) (9f1d66f)

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v10.3.2

Mon, 26 Jun 2023 00:00:00 +0000

Notes

Bug Fixes

prisma: check for query args in string property (#1684) (8d9b176)

Security Improvements

deps: Updated security agent to v0.1.3 (#1696) (0f957bd)

Miscellaneous Chores

test: Added t.end() to trace unit test (#1698) (254c9c0)
test: convert error-trace-aggregator.test.js to tap-style (#1690) (44b17ab)
test: convert trace unit test to tap style (#1692) (727c17f)
test: Fixed tap end/autoend calls in trace unit test (#1700) (b4a4948)

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v10.4.0

Fri, 30 Jun 2023 00:00:00 +0000

Notes

Miscellaneous Chores

test: Converted 'errors/expected.test.js' to tap-style (#1695) (86025de)
test: Converted server-config.test.js to tap-style (#1702) (2c6906d)

Continuous Integration

skip running test suite when merging releases (#1704) (f78b981)

Build System

updated @newrelic/aws-sdk to latest to get the instrumentation fixes for 3.363.0 (#1707) (a2cca08)

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v10.4.1

Mon, 10 Jul 2023 00:00:00 +0000

Notes

Security Improvements

deps: bump protobufjs from 7.2.3 to 7.2.4 (#1713) (5fb4606)

Miscellaneous Chores

test: Converted adaptive-sampler.test.js to tap (#1709) (bb42249)
test: converted environment.test.js to tap (#1705) (53b4376)
test: Replaced t.equals with t.equal (#1711) (a0b255e)

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v10.4.2

Thu, 13 Jul 2023 00:00:00 +0000

Notes

Bug fixes

Dropped query params from request.uri attribute when obfuscating (#1719) (76112a6)

Miscellaneous chores

Created story issue template (#1694) (20442c6)

Tests

Pinned prisma to < 5 when running on node 14 (#1717) (b000d7b)

Support statement

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v10.5.0

Thu, 20 Jul 2023 00:00:00 +0000

Notes

Features

enabled code_level_metrics by default (#1723) (0b96de3)

Bug Fixes

prevent ESM loader from loading instrumentation multiple times (#1729) (962d172)

Miscellaneous Chores

deps-dev: bump word-wrap from 1.2.3 to 1.2.4 (#1730) (500a69e)

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v10.6.0

Wed, 26 Jul 2023 00:00:00 +0000

Notes

Miscellaneous Chores

deps: Updated @newrelic/security-agent to v0.2.0 (#1737) (9bf2a01)
restored engines to >=14 until we actually drop support for Node 14 (#1738) (8d66123)

Continuous Integration

Add Node.js 20.x to CI and remove 14.x (#1603) (c4b008c)
update support statement (#1733) (3013da9)

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

Node.js agent v10.6.2

Mon, 07 Aug 2023 00:00:00 +0000

Notes

Bug Fixes

added defensive code around JSON.parse in formatting pino log lines because pino can return invalid json (#1750) (8f2e11a)

Miscellaneous Chores

deps: Updated @newrelic/security-agent to v0.2.1 (#1754) (0d04f14)
Fix smoke tests node 20 (#1745) (8c053e0)
fixed typos in lib/config/index.js comments (#1749) (9000a14)

Tests

Added a full suite of unit tests for the collector/http-agents (#1748) (9d4201b)

Support statement:

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

Node.js agent v10.6.1

Tue, 01 Aug 2023 00:00:00 +0000

Notes

Security Improvements

updated ESM loader to track instrumentation by url in a map instead of in url to avoid remote code execution. (#1741) (c8dc779)

Support statement:

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

Node.js agent v1.0.0

Thu, 24 Oct 2013 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes:

General Availability release of the Node.js agent.
Please review the news.md at the root of the project for all prior release notes.
If you are using an older BETA version of the Node.js agent, please upgrade to the current version.

Node.js agent v1.0.1

Wed, 30 Oct 2013 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes:

Added a new setIgnoreTransaction call to the exported API to allow explicit control over whether transactions should be ignored or not. Mark those polling routes to be ignored! Pull your crazy custom favicon.ico renderer out of the ignore list!
The module will no longer pollute MongoDB queries with New Relic-only parameters. Thanks to Alon Salant for identifying this issue, and all apologies to him for the trouble it caused him.
The instrumentation for MongoDB, memcached, Redis, and Express will now honor the setting of the capture_params configuration flag. Before the module always captured query parameters.
Fixed a problem that would cause New Relic for Node to fail on versions of Node between 0.8.0 and 0.8.3.
Upgraded to the newest version of continuation-local-storage, which has many fixes for dealing with monkeypatched EventEmitters.

Node.js agent v11.0.0

Mon, 28 Aug 2023 00:00:00 +0000

Notes

⚠ BREAKING CHANGES

Removed support for Node 14.
Replaced ESM loader with import-in-the-middle to fix instrumentation firing for both CommonJS and ESM.
- You must load both the ESM loader and agent as follows: node --experimental-loader newrelic/esm-loader.mjs -r newrelic path/to/app.js.
- Removed config.esm.custom_instrumentation_entrypoint to register ESM instrumentation. You can now just call the newrelic.instrument* APIs but you must pass in an object and specify isEsm: true. See example.
Updated agent to use require-in-the-middle to register CommonJS instrumentation. You can no longer use an onResolved hook to register custom instrumentation.
Updated the default context manager to be AsyncLocalContextManager.
Renamed shim.handleCATHeaders to shim.handleMqTracingHeaders.
Updated agent to only run in the main thread. This is because running in a worker thread does not completely function out of the box. This will reduce the overhead for customers that are naively trying to load this into worker threads.

Features

Added support for Node 20.
Renamed shim.handleCATHeaders to shim.handleMqTracingHeaders (#1735) (6788f9e)
- If you have calls to shim.handleCATHeaders, the signature is identical and a function name change is only necessary.
- Note: The agent will be removing CAT functionality in an upcoming release.
Updated the default context manager to be AsyncLocalContextManager (#1731) (25f2bd8)
- To restore functionality of legacy context manager you can set config.feature_flag.legacy_context_manager to true or `NEW_RELIC_FEATURE_FLAG_LEGACY_CONTEXT_MANAGER=true
- Please note this legacy context manager will be removed in future major releases. If you have any issues, please raise with New Relic support or on the issues of the agent.

Bug Fixes

Replaced esm loader with import-in-the-middle to fix instrumentation firing for both commonjs and esm (#1760) (4452354), closes 1646
- Breaking Change: Updated ESM loader that now requires to use both a loader and -r.
  - node --experimental-loader newrelic/esm-loader.mjs -r newrelic path/to/app.js
- Breaking Change: Removed config.esm.custom_instrumentation_entrypoint to register ESM instrumentation.
  - You can now just call the newrelic.instrument* APIs but you must pass in an object and specify isEsm: true.
Updated prisma instrumentation to parse prisma datamodel with internal package (#1765) (48079b3)

Code Refactoring

Updated agent to use require-in-the-middle to register CommonJS instrumentation (#1758) (d4b4f11)
- Removed onResolved hook. If you're using custom instrumentation with an onResolved hook, you must update to use onRequire
- You can no longer instrument files that are not within a node_module unless you provide an absolute path to the file when registering the instrumentation.
- You cannot instrument both the base module and a sub module.

Miscellaneous Chores

Remove support for Node 14 (#1756) (0ff9912)
Updated the bundled packages to the latest @newrelic/superagent, @newrelic/aws-sdk, @newrelic/koa, @newrelic/native-metrics, and @newrelic/test-utilities (#1766) (8f6e15b)
Updated the aws-sdk external branch to be main now that the code is in there (#1761) (d34d0fe)

Tests

update smoke tests versioned matrix in CI to 16, 18, and 20. (#1762) (c82b517)

Support statement:

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

Node.js agent v11.10.0

Mon, 22 Jan 2024 00:00:00 +0000

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:

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

Node.js agent v11.1.0

Thu, 07 Sep 2023 00:00:00 +0000

Notes

Features

Added instrumentation for fetch. (#1776) (980b4dc)
Removed undici feature flag. This will now instrument undici by default. (#1772) (683b254)
Updated undici instrumentation to create segment on request create instead of after connection and opening socket to more accurately record time it takes to make an undici request. (#1770) (3f494f8)

Performance Improvements

Trace: optimise getTotalTimeDurationInMillis function to push to an array instead of concat arrays. (#1774) (6ecde97)
- Thanks @infinity-naveen for your contribution 🎉

Miscellaneous Chores

Updated Next.js plugin versioned tests to use main now that require-in-the-middle fixes have been merged. (#1768) (6a72d1f)
Upgraded @newrelic/test-utilities and removed unused shimmer.patchModule and shimmer.unpatchModule (#1769) (96620ef)

Support statement:

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

Node.js agent v11.10.1

Thu, 25 Jan 2024 00:00:00 +0000

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:

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

Node.js agent v11.10.2

Wed, 31 Jan 2024 00:00:00 +0000

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:

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

Node.js agent v11.10.3

Wed, 07 Feb 2024 00:00:00 +0000

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.

Node.js agent v11.10.4

Tue, 13 Feb 2024 00:00:00 +0000

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:

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

Node.js agent v11.12.0

Mon, 04 Mar 2024 00:00:00 +0000

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:

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

Node.js agent v11.11.0

Tue, 27 Feb 2024 00:00:00 +0000

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:

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

Node.js agent v11.13.0

Wed, 13 Mar 2024 00:00:00 +0000

Notes

Features

Added AI Monitoring(AIM) for
OpenAI
,
Amazon Bedrock
, and
Langchain
.
- To enable, set config.ai_monitoring.enabled or NEW_RELIC_AI_MONITORING_ENABLED to true.
- For a full experience, set config.span_events.max_samples_stored to 10000, config.custom_insights_events.max_samples_stored to 100000, and config.distributed_tracing.enabled should not be set to false.
- Note: Enabling high-security mode will disable the AIM instrumentation and events.
Added instrumentation for VectorStore.similaritySearch for langchain.js (#2049) (3c50606)
Added setLlmTokenCountCallback API endpoint to register a callback for calculating token count when none is provided (#2065) (d2faf1a)
Added token_count to LlmEmbedding and LlmChatCompletionMessage for openai (#2061) (47a925e)
Added tool_id to Langchain error event (#2064) (793abe8)

Miscellaneous chores

Added flag for verbosity during docs publishing (#2060) (fe0d41a)
Added some delays to docs publishing (#2062) (a602fd4)
Changed casing of OpenAI in vendor property (#2068) (64b4ca2)
Changed token_count to only use tokenCountCallback (#2070) (66f94b0)
Removed langchain_instrumentation feature flag as the instrumentation is feature complete (#2073) (925a463)
updated @newrelic/aws-sdk and @newrelic/koa to latest (#2074) (0747ca4)

Support statement:

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

Node.js agent v11.14.0

Wed, 20 Mar 2024 00:00:00 +0000

Notes

Features

Added guid attribute to TransactionError events (#2079) (3468fb1)
Added instrumentation for initializeUnorderedBulkOp, and initializeOrderedBulkOp in mongodb 4+ (#2086) (666ae6e)
Added support for Mongo v5+ (#2085) (00f6feb)

Security improvements

deps: bump follow-redirects from 1.15.5 to 1.15.6 (#2078) (aa86482)

Documentation

Changed bug bounty URL (#2081) (f4586d7)

Miscellaneous chores

Added instrumentation tracking class (#2084) (07d7e7d)
deps: pin @newrelic/security-agent to 1.0.1 (#2089) (e133c76)

Support statement:

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

Node.js agent v11.15.0

Tue, 09 Apr 2024 00:00:00 +0000

Notes

Bug fixes

Fixed instrumenting the same module installed in different locations (#2104) (88bdace)

Code refactoring

mongodb: Removed instrumentation that handles connecting via unix domain socket. (#2129) (808323f)
Updated shim classes to no longer construct specs. (#2096) (158c295)

Miscellaneous chores

deps-dev: Bumped express from 4.18.2 to 4.19.2 (#2101) (639cb78)
deps: Updated @newrelic/security-agent to v1.1.1 (#2092) (3272aa3)
Fixed incorrect pinning of @elastic/transport (#2120) (7b5bdaa)
Removed scrollbar styling in generated API docs (#2091) (cb0fa11)
Removed transaction_id and legacy token count attributes from llm events for openai and langchain (#2093) (df2a0fd)

Tests

Updated test/integration/core/dns reverse test to remove flakiness (#2121) (c32cb27)
Updated elastic tests to skip broken version (#2119) (5d0d1bb)

Continuous integration

Removed usage of use_new_release from prepare release workflow (#2124) (007ddb4)
Updated prepare-release.js to not require changelog.json (#2106) (328a570)
Updated prepare release to provide a drop down for release type (#2133) (846269b)
Updated versioned security agent workflow (#2100) (f787b15)
Fixed typo in constant name for prepare release script (#2094) (3b887d9)

Support statement:

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

Node.js agent v11.16.0

Mon, 29 Apr 2024 00:00:00 +0000

Notes

Features

Added API ignoreApdex to ignore calculating apdex for the active transaction (#2166) (cb21d2c)

Bug fixes

Fixed issue with CJS being imported as ESM (#2168) (9a14cb0)

Security improvements

deps: bump formidable and superagent (#2162) (260f16b)

Documentation

Fixed images in markdown tutorials (#2153) (ef14948)
Includes api.js in jsdoc generation (#2139) (3883348)

Miscellaneous chores

Migrated @newrelic/superagent into agent repo (#2141)
Migrated @newrelic/aws-sdk into agent repo (#2161) (a9eb593)
Migrated @newrelic/koa into mainline agent repo (#2148) (33af646)
Removed repetitive cache busting (#2160) (5ac870e)
Updated instrumentation to use type constants instead of raw strings (#2165) (c5b42cd)
Updated versioned tests readme (#2159) (a957304)
Updated versioned tests to support upcoming tooling (#2147) (38e47d9)
Updated versioned tests to use quiet output mode (#2145) (63a5ddc)

Support statement:

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

Node.js agent v11.17.0

Wed, 15 May 2024 00:00:00 +0000

Notes

Features

Added otel compliant server.address, server.port, and http.request.method to external http spans (#2169) (b0a3e6d)
Added otel compliant db.system, server.address, and server.port attributes to database spans (#2173) (3fdcab4)

Bug fixes

Added support for AWS API Gateway v2 payloads (#2191) (0ccdc6a)

Code refactoring

Updated instrumentation for http, undici, grpc to use a new segment.captureExternalAttributes to centralize the necessary data needed to create segment and span attributes (#2179) (ddb6356)

Documentation

Updated compatibility report (#2185) (eb986c9)

Miscellaneous chores

Added workflow for generating compatibility doc (#2183) (9b1d5cb)
Fixed conditionals in CI workflow (#2188) (6b733c0)
Fixed superagent versioned tests (#2190) (297bc01)
Made pre-commit hook require dependency changes (#2172) (e7bd356)
Updated CI to skip expensive actions when not needed (#2184) (8639fb9)
Updated validate-pr workflow (#2186) (6ff4497)

Continuous integration

Updated minimum version of lib-dynamo to work around peer dependency resolution (#2174) (7ddf2c9)

Support statement:

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

Node.js agent v11.18.0

Wed, 29 May 2024 00:00:00 +0000

Notes

Features

Added support for redis v4 legacyMode client.v4.<command> (#2200) (b2284c5)

Code refactoring

Updated shim.recordConsume to use shim.record and added ability to invoke an after hook with callback args (#2207) (4f48fc3)

Documentation

Updated compatibility report (#2223) (a256ca0)

Miscellaneous chores

Removed outdated Slack reference (#2198) (8110d42)
Removed package-lock.json (#2208) (b267695)
Removed unused express5 feature flag (#2197) (366504b)

Tests

Updated langchain versioned tests to separate the vectorstore and other tests. This is to avoid peer resolution of @langchain/community package that is being used to test the elasticsearch vectorstore (#2216) (e768955)
Fixed aws-sdk-v3 bedrock tests (#2211) (050469e)
Fixed aws-sdk-v3 bedrock tests (again) (#2212) (330cc4b)

Continuous integration

Updated the langchain vectorstore test to reference the correct version of @langchain/core getting tested (#2202) (ed81852)
Added updating of docs site with compatibility table (#2205) (c28a938)
Fixed CI jobs (#2215) (8b030fb)
Fixed should-run CI step (#2214) (d0a481d)

Support statement:

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

Node.js agent v11.19.0

Thu, 06 Jun 2024 00:00:00 +0000

Notes

Features

Added instrumentation for kafkajs (enabled through a feature flag) (#2237) (#2244) (#2236) (#2236) (#2251)

Miscellaneous chores

Added KafkaJS instrumentation and versioned tests skeleton (#2224) (fc13916)
Added KafkaJS to compatibility list (#2254) (f003ee7)
Implemented DT header injection for message specs (#2250) (3e6bc6d)
Removed targets for Kafka versioned tests (#2235) (838bab2)
Updated flaky when test (#2241) (4079a0a)
Updated readme to remove no longer relevant information (#2240) (01fb53c)
Updated versioned tests due to update in @newrelic/security-agent V1.3.0 (#2239) (982276c)

Tests

Migrated memcached tests to versioned tests (#2231) (0b3a928)
Ported when and q integration tests to versioned tests (#2233) (9a4dddc)
Updated ioredis tests to assert the host metric getting created on ioredis calls (#2230) (89df06a)
Updated unit tests that were missing constructing specs at instrumentation source (#2252) (54ab238)

Support statement:

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

Node.js agent v11.2.1

Thu, 12 Oct 2023 00:00:00 +0000

Notes

Bug fixes

Updated initialization to return the API on start up to the security agent properly (#1807) (99e5792)

Support statement:

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

Node.js agent v11.2.0

Wed, 11 Oct 2023 00:00:00 +0000

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:

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

Node.js agent v11.20.0

Mon, 24 Jun 2024 00:00:00 +0000

Notes

Features

Added support for Anthropic Claude 3 messages API (#2278) (7e3cab9)

Code refactoring

Replaced instances of substr() with substring() (#2274) (8f96c73)

Documentation

Fixed typos in API jsdoc (#2287) (7b3c8d1)
Updated compatibility report (#2285) (b1b5e3e)

Miscellaneous chores

Added a missing library we instrument to be picked up by the compatibility report (#2261) (6c964b2)
Added a script that generates Dashboard json for reporting on libraries by version (#2267) (d2877c1)
Added AI support docs for automation (#2249) (e2efc1f)
Fixed comment about transaction_tracer.transaction_threshold (#2258) (7cd6aef)
Made elastic versioned tests work on Node 16 (#2284) (143b475)
Updated docker compose configuration (#2268) (eb1cce9)
Updated GitHub Actions versions (#2272) (07a841b)
Updated mysql tests to use MySQL 8.3 (#2280) (11e0f8c)
Updated mysql2 tests to fix CI issue (#2282) (5a37971)
Updated versioned security agent workflow with simpler setup (#2259) (a886187)

Continuous integration

Added ability to run a build step in create release (#2273) (4c2f24c)
Updated security agent workflow to use large runners when available (#2271) (181ec1b)
Updated security agent workflow to use large runners when available (#2270) (761fcd5)

Support statement:

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

Node.js agent v11.21.0

Tue, 25 Jun 2024 00:00:00 +0000

Notes

Features

Added support for getting container ids from ECS metadata API (#2292) (dbca830)

Bug fixes

Handled assigning headers in LambdaProxyWebRequest when there are no headers present (#2293) (e4d22f3)

Documentation

Updated compatibility report (#2290) (b5fc893)

Tests

Fixed log error stack message truncating and failing equality test (#2294) (8e06f0f)
Updated shimmer method in benchmark tests (#2281) (1528d68)

Support statement:

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

Node.js agent v11.22.0

Fri, 28 Jun 2024 00:00:00 +0000

Notes

Features

Added support for Node 22(#2305) (0bf8908)
Added AIM support for Meta Llama3 models in AWS Bedrock (#2306) (ff2e509)

Documentation

Updated compatibility report (#2309) (7bf77c6)

Miscellaneous chores

Added @amychisholm03 to list of contributors 🎉 (#2310) (8a890f1)
Forced re-creation of API docs on gh-pages (#2307) (917110a)

Tests

Updated undici versioned tests to assert an error is present and not the actual message (#2299) (4e38ed4)

Continuous integration

Added Node 22 to CI (#2164) (4b12d9e)
Added Node 22 to smoke tests and nightly versioned test runs (#2316) (af00666)
Moved the docs PR job to before api docs publish (#2300) (2e7252e)

Support statement:

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

Node.js agent v11.23.0

Wed, 10 Jul 2024 00:00:00 +0000

Notes

Features

Added support for account level governance of AI monitoring (#2326) (7069335)

Code refactoring

Removed redundant isExpected in the Exception class (#2328) (38f9825)
Reduced duplication in the error-collector (#2323) (10581bf)
Refactored benchmark tests to complete async functions (#2334) (57a4dfb)

Documentation

Included commands and links for Mac setup (#2327) (6eddb72)
Updated compatibility report (#2318) (3a910ef)

Miscellaneous chores

Fixed copy paste error in post release workflow (#2329) (6f2da7a)
Implemented split jobs for post release docs publishing (#2319) (c14ec3b)

Tests

Fixed recordMiddlewawre benchmark test (#2338) (fb55ac7)

Support statement:

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

Node.js agent v11.23.1

Thu, 11 Jul 2024 00:00:00 +0000

Notes

Bug fixes

Updated redis v4 instrumentation to work with transactions(multi/exec) (#2343) (39eb842)

Documentation

Updated compatibility report (#2342) (5c9e3e6)

Support statement:

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

Node.js agent v11.23.2

Mon, 22 Jul 2024 00:00:00 +0000

Notes

Features

Added support for fs.glob in Node 22+ (#2369) (1791a4e)

Bug fixes

Updated aws-sdk v3 instrumentation to load custom middleware last to properly get the external http span to add aws.* attributes (#2382) (751801b)
Updated cassandra-driver instrumentation to properly trace promise based executions (#2351) (bab9a8b)

Documentation

Removed examples/api/ (#2381) (fb964de)
Removed out of date ROADMAP_Node.md from root of project (#2367) (4be870c)
Updated compatibility report (#2345) (f08adc3)

Miscellaneous chores

Always upload status logs in compatibility report CI (#2341) (b3f1ee3)

Tests

Removed server.start in grpc tests as it is deprecated and no longer needed (#2372) (d212b15)
Updated benchmark test results to output result files (#2350) (1b51a68)

Continuous integration

Added benchmark test GitHub Action (#2366) (afd3ab4)
Increased the limit of installs from 2 to a bigger number for versioned tests (#2346) (f85a385)
Updated bin/create-docs-pr to create an empty array if changelog.json is missing security (#2348) (7d5368c)

Support statement:

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

Node.js agent v11.3.0

Mon, 23 Oct 2023 00:00:00 +0000

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:

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

Node.js agent v11.4.0

Wed, 25 Oct 2023 00:00:00 +0000

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:

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

Node.js agent v11.5.0

Mon, 30 Oct 2023 00:00:00 +0000

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

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

Node.js agent v11.6.0

Wed, 29 Nov 2023 00:00:00 +0000

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:

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

Node.js agent v11.6.1

Thu, 07 Dec 2023 00:00:00 +0000

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:

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

Node.js agent v11.7.0

Thu, 14 Dec 2023 00:00:00 +0000

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:

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

Node.js agent v11.8.0

Wed, 03 Jan 2024 00:00:00 +0000

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:

See the New Relic Node.js agent EOL policy for information about agent releases and support dates.

Node.js agent v11.9.0

Wed, 10 Jan 2024 00:00:00 +0000

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

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

Node.js agent v1.1.0

Wed, 06 Nov 2013 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes:

Added a new call to the API, .noticeError. See the docs for details, but unlike the other calls on the API, you can use this to pass off errors anywhere in your app, not just from within web requests.
Ignoring slow (or polling) requests was only being applied to slow transaction traces. It now applies to metrics and transactions that end in errors.
MongoDB, Redis and Memcached now honor the capture_params and ignored_params settings.
New Relic for Node.js, like New Relic's other agents, has a sophisticated system for repeatedly trying to connect to New Relic's servers when the first attempt results in failure. This had been broken since (roughly) January. It works again now.
The built-in debugging for the transaction tracer was out of date with respect to the production tracer. This is fixed, and you're welcome to satisfy your curiosity by enabling it, but it's really not going to be useful to you unless you feel like taking the time to understand what the tracer is doing at a low level. Do not ever enable it in production, as it degrades the tracer's performance and generates a huge pile of objects per transaction.

Node.js agent v1.10.0

Fri, 15 Aug 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Custom instrumentation

The agent now allows you to annotate your application code to provide customized instrumentation. This includes the ability to time both web and background transactions, and add tracers to measure activity within transactions like querying a database. For more information, see custom instrumentation

Node.js agent v1.10.1

Fri, 22 Aug 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Improvements

MySQL Pooling Support

Better support for mysql pooling, including connections that use createPoolCluster and createPool. Previously connections obtained through a pool could potentially be uninstrumented.

Node.js agent v1.10.2

Mon, 25 Aug 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Fixes

Fix to prevent proxy credentials transmission

This update prevents proxy credentials set in the agent config file from being transmitted to New Relic.

Node.js agent v1.10.3

Thu, 28 Aug 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Fixes

Removed a preemptive DNS lookup of the New Relic servers that could cause errors when behind a proxy.

Node.js agent v1.1.1

Sat, 09 Nov 2013 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes:

Added support for key transactions and New Relic's new alerting policies.
The agent no longer renames transactions for requests that end in error to the gnomic and unhelpful '400/*' (or whatever the final HTTP status code ends up being). This should make the traced errors tab considerably more useful.
Improved instrumentation for legacy http.createClient and http.Client client methods. A few modules still use these legacy API calls, and the old instrumentation was just plain wrong.
Changed how the error tracer deals with certain kinds of errors to deal with differences between Node versions 0.8 and 0.10. It should now convert throws into fatal errors less frequently.
Removed useless fs.readDir instrumentation, which generated a lot of metrics but which New Relic was unable to display in any useful form. Maybe it will come back someday in a more useful incarnation.

Node.js agent v1.11.0

Fri, 05 Sep 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Improvements

PostgreSQL support via the `pg` driver.

The Node.js agent now records the amount of time spent in transactions with PostgreSQL databases. This timing can be viewed in the Transactions page within individual transactions and their traces.

The agent supports all of the following `pg` usage scenarios:
- Using the pure javascript API exposed directly from `pg`
- Using the "native" API exposed from `pg.native`
- Using the "native" API exposed directly from `pg` when the `NODE_PG_FORCE_NATIVE` environment variable is set
- Using the pure javascript API from the `pg.js` module

Node.js agent v1.11.2

Fri, 19 Sep 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Custom Instrumentation functions now pass through the return value of their passed in callback.
Multiple improvements to PostgreSQL instrumentation

When no callback was detected in the query functions, we were inserting our own. The insertion itself caused a crash. Adding a callback also modified the behavior of the pg module. Instead, we now listen for error or end events to finish segments.

We now generate metrics for statement type/table combinations. Look for these in the database tab your APM Account!

Node.js agent v1.11.1

Thu, 11 Sep 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Fixes

Improved MongoDB find instrumentation.

The mongo driver provides many ways to invoke its API and find documents. In previous releases, some API invocations would create transaction trace segments that would not end properly, leading to inaccurately large segment times. This release ensures the agent always instruments finding and iterating through documents, ensuring segment times are accurate.

Node.js agent v1.11.3

Fri, 26 Sep 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Updated hapi instrumentation to support the recently released v6.9.
Fixed a bug where an invalid package.json could cause the agent to crash while it recursed through node_modules gathering version details.
Properly name other SQL queries.

Previously when the agent failed to parse SQL it would create a metric stating the database type, query type, and query table were all unknown. This has been changed to keep track of database type and create an appropriate other operation metric like other agents.

Node.js agent v1.11.4

Fri, 03 Oct 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Fixed a bug where mutibyte characters would cause an error when sending data to the New Relic servers.

Node.js agent v1.12.0

Fri, 10 Oct 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Added support for Cross Application Tracing

The agent now supports Cross Application Tracing, which allows the New Relic APM UI to display traces that span multiple applications.
Fixed a bug that would cause application to crash on request when using the kraken framework.
Loosened the restrictions on the app_name setting. Application names may now include any Unicode characters.

Node.js agent v1.11.5

Mon, 06 Oct 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Fixes

Fixed a type error while checking payload size before reporting to New Relic.

When this occurred the agent would fail to send the payload to New Relic. This was more likely to occur in high throughput applications.

Node.js agent v1.12.1

Thu, 16 Oct 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Added support for Label Categories

The agent now supports setting Labels for your application on a per instance level, using either an environment variable, or a config file setting. https://docs.newrelic.com/docs/apm/new-relic-apm/maintenance/categories-...
Improved transaction names for express 4

express 4 added the ability to mount apps and routers at specific urls. The node agent would previously use only the portion of the route that was the last router or app matched as the transaction name. Transaction names will now include the entire matched route.
Added detection for uninstrumented instances of modules that should be instrumented

The agent will now detect if an application has required a module before require('newrelic') .If this occurs, the agent will add a warning in the log file and display a warning banner in the UI.
Added more logging to custom instrumentation APIs at debug level.

The logging was improved for the benefit of people using the following APIs: createTracer, createWebTransaction, createBackgroundTransaction, and endTransaction. It will log when transactions are created and when transactions are ended. It will also log when it can't create a tracer due to there being no active transaction.
Fixed a bug in PostgreSQL instrumentation where the event emitter from query could not chain .on calls. This patch was contributed by sebastianhoitz.
Fixed a bug in createBackgroundTransaction where if the agent was disabled it didn't take a group argument. This patch was contributed by nullvariable.
Fixed a bug in our URL parsing where in Node v0.11.14 url.parse returns a differently shaped object than expected. This patch was contributed by atomantic

Note: Node v0.11.x is not officially supported, but Node v0.12 will be and this patch helps us get ready for that.

Node.js agent v1.12.2

Thu, 23 Oct 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Fixed a bug that would cause the application to crash on outbound connections when using node 0.8.
Fixed a bug that could sometimes cause the application to crash while parsing MySQL queries.

Node.js agent v1.13.0

Fri, 31 Oct 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Added support for Custom Metrics

Custom metrics provides a way to send additional metrics up to New Relic APM, which can be viewed with Custom Dashboards. We have two APIs for this, recordMetric(name, value) and incrementMetric(name[, value]). Read more about Node.js custom metrics.
Fixed a bug in deeply nested transactions.

Previously we allowed transactions to be nested to any depth. We've found in some cases this causes stack depth problems and are now limiting to 900 segments per transaction. We will still collect metrics on all segments, but transaction traces will only show the first 900.
Fixed a bug where custom tracers would show 0 time if the transaction ended n them.

This may change the times you see for other types of tracers by a small amount. The change will reflect slightly more accurate timing.

Node.js agent v1.13.1

Thu, 06 Nov 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

This release was unpublished from npm due to a bad merge

Node.js agent v1.13.2

Thu, 06 Nov 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Updated support for hapi 7.2 or higher.

Hapi refactored how the server is instantiated and caused the agent to not be able to get transaction names. This release accounts for the update and enables full instrumentation.

Node.js agent v1.13.3

Thu, 13 Nov 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Fixed a bug in Cross Application Tracing where the agent would sometimes attempt to set a header after headers had already been sent.
Replaced the logger with one that is handles file writes properly lowering overall resource usage.

This is a small change with a large impact. fs.createWriteStream returns whether data was queued or not. If it is queued it is recommended to wait on a drain event but this isn't mandatory. Most loggers we've found ignore this event which leads to many writes getting buffered and a rapid increase in native heap size as well as lowering the process's ability to respond to requests.

Node.js agent v1.13.4

Thu, 20 Nov 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Added support for the the aggregate method on mongodb collections. This patch was contributed by taxilian

Node.js agent v1.14.0

Tue, 25 Nov 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

The node agent now instruments connections to Oracle Databases using the oracle driver. This patch was contributed by ryanwilliamquinn
Fixed an issue that would break kraken apps when the node agent was enabled. This patch was contributed by Lenny Markus

Node.js agent v1.14.1

Fri, 05 Dec 2014 00:00:00 +0000

Fixes

Fixed a bug that caused some outbound http requests to show up in the New Relic UI as requests to localhost rather than the specified domain.
The agent no longer reports errors from outbound http requests if they were handled by the user's application

Node.js agent v1.14.2

Thu, 11 Dec 2014 00:00:00 +0000

Notes

Added support for Hapi v8.
briandela contributed a fix for an crash that would occur when using hapi with vhosts.

Node.js agent v1.14.3

Thu, 18 Dec 2014 00:00:00 +0000

Notes

Improved the Express instrumentation to be more defensive before doing property lookups, fixing a crash that could happen in an exceptional state.
Improved logging when the New Relic agent cannot connect to New Relic servers.
Make Cross Application Tracer header injection less aggressive fixing interaction with other libraries such as riak-js.

Node.js agent v1.14.4

Mon, 22 Dec 2014 00:00:00 +0000

Notes

Custom web transactions can have their names changed by nr.setTransactionName(). Thanks to Matt Lavin for this patch!
Fixed a bug where Express instrumentation could crash if transaction state was lost in a sub router.

Node.js agent v1.14.5

Tue, 30 Dec 2014 00:00:00 +0000

Notes:

Errors that occur in background transactions now have custom parameters copied onto them in the same manner as web transactions.
Memcached instrumentation has been updated to account for additional arguments that might be passed to the command function that the agent wraps.

Node.js agent v1.14.6

Fri, 09 Jan 2015 00:00:00 +0000

Notes

The agent now logs the actual error when log file parsing fails. Thanks to knownasilya for this patch!
Fixed a crash where config serialization would fail due to circular objects if domains were enabled.

Node.js agent v1.14.7

Fri, 16 Jan 2015 00:00:00 +0000

Fixed a crash in express instrumentation in the handling of sub-routers.
Fixed a crash in http outbound connections when CAT is enabled and another library has frozen the http request headers.
Updated version checking to allow versions of the runtime >= 1.0.0. Thanks to Mark Stosberg for this patch!

Node.js agent v1.15.0

Fri, 23 Jan 2015 00:00:00 +0000

Notes:

Added an API for recording custom Insights events. Read more about this in our documentation

Node.js agent v1.15.1

Fri, 30 Jan 2015 00:00:00 +0000

Notes

Preliminary Node.js 0.12 support.

HTTP proxies are not supported on 0.12 yet. We don't recommend running the Agent on Node.js 0.11.15+ in production, but if you are testing on it, please let us know of any issues you encounter.

Node.js agent v1.16.1

Fri, 06 Feb 2015 00:00:00 +0000

Notes

Now transaction tracing with synthetic monitoring is on by default.

The previous release had the synthetic transaction tracing feature turned off by default.

Node.js agent v1.16.0

Fri, 06 Feb 2015 00:00:00 +0000

Notes

Added support for synthetic monitoring transaction tracing.

Synthetic monitoring lets you monitor your site from around the world. When you use synthetics to monitor your Node application, up to 20 detailed transaction traces will now be captured every minute when the application is probed from synthetics. To learn more about this feature, visit our documentation.

Node.js agent v1.16.2

Fri, 13 Feb 2015 00:00:00 +0000

Notes

Enable http/https proxy features on all supported Node versions.

Supported versions: Node.js 0.8, 0.10, 0.12 and io.js 1.x.
Fixed a bug in vhost detection in Hapi 8. This bug would result in a crash for users of vhosts.

Node.js agent v1.16.3

Fri, 20 Feb 2015 00:00:00 +0000

Notes

Fixed a bug in hapi 8 view segments. Previously, the segments weren't being ended when the view ended.
Added a configuration option to completely disable logging. logger.enabled defaults to true, if set to false it won't try to create the log file.

Node.js agent v1.16.4

Fri, 20 Feb 2015 00:00:00 +0000

Notes

Fixed a bug in the logger to respect the configured log level in all cases.

Node.js agent v1.17.1

Thu, 05 Mar 2015 00:00:00 +0000

Notes

Added instrumentation support for Node.js PostgreSQL driver pg 4.x.
Added instrumentation support for Datastax's Cassandra driver.
Updated Oracle instrumentation to collect new datastore metrics.

Node.js agent v1.17.2

Thu, 12 Mar 2015 00:00:00 +0000

Notes

Fixed a bug that interfered with listing the routes in Express apps.
Fixed a bug that caused custom transaction names to appear as "unknown".
Added more log detail when instrumentation fails to load.

Node.js agent v1.17.3

Thu, 19 Mar 2015 00:00:00 +0000

Notes

Fixed a bug where external requests report times longer than the transactions that initiated them. External request segments are now always ended when an error occurs.
Fixed a bug that produced incorrect transaction names for some routes in express2 and express3.

Node.js agent v1.18.0

Fri, 27 Mar 2015 00:00:00 +0000

Notes

Reduce agent CPU overhead by omitting setImmediate from traces.

The change to setImmediate makes that function behave the same way as nextTick and other frequently-called functions that are already elided from Transaction Traces.
Mitigate a Node.js memory leak that can occur during TLS connections.

There is an outstanding Node.js Core memory leak involving TLS connections. Clients specifying certificates, such as the New Relic Agent, quickly reveal this leak. We now mitigate this issue by using the default client certificates where possible. A new log message will be printed when the TLS memory leak workaround can not be used, such as when using a custom certificate with an HTTPS proxy.

Node.js agent v1.18.4

Wed, 22 Apr 2015 00:00:00 +0000

Notes

Fixed an inverted if in config loading.

Previously, the config loader would log a warning on success, rather than failure. Configuration loading works as expected now.
Fixed a bug in process.nextTick instrumentation for io.js 1.8.1.

Previously the agent would only pass the callback argument to process.nextTick. This did not cause issues in Node.js and older version of io.js, since additional arguments were ignored. In a recent change to io.js, process.nextTick was changed to pass any additional arguments to the callback, the same way setImmediate does. This change ensures all arguments are handled as expected.

Node.js agent v1.18.5

Fri, 01 May 2015 00:00:00 +0000

Bug fixes

Fixed a bug in environment variable based configuration.

Previously the agent would parse the NEW_RELIC_APDEX environment variable as a string rather than a float this could cause data to be sent to New Relic servers in an invalid format, preventing the data from being collected.
Fixed a bug with the error collector's handling of ignored status codes.

Previously the agent would not properly ignore status codes if the status code was set using a string rather than a number.
Fixed a bug in mysql instrumentation.

Previously the mysql instrumentation could cause errors when making mysql queries using an options object rather than a SQL string. The agent now handles arguments to the query method in a more robust way.

Node.js agent v1.19.0

Wed, 06 May 2015 00:00:00 +0000

Features

Filesystem interactions are now recorded in metrics

The time spent in filesystem functions during a transaction will now be displayed in the transaction overview page per operation.

Bugfixes

Fixed a bug with error handling.

Previously the agent could crash applications in certain situations where null was thrown rather than an Error object.

Node.js agent v12.0.0

Wed, 31 Jul 2024 00:00:00 +0000

Notes

⚠ BREAKING CHANGES

Dropped support for Node.js 16
Removed legacy context manager
Removed support for redis less than version 2.6.0
Removed instrumentation for director
Updated mongodb instrumentation to drop support for versions 2 and 3

Features

Dropped support for Node.js 16 (#2394) (1870010)
Removed legacy context manager (#2404) (321244c)
Removed support for redis less than version 2.6.0 (#2405) (e2c0a31)
Removed instrumentation for director (#2402) (1b355e7)
Added server.address to amqplib spans (#2406) (09636a4)
Updated mongodb instrumentation to drop support for versions 2 and 3 (#2398) (a0ae32a)
Migrated instrumentation for next into agent (#2409) ([b55d8e1](https://github.com/newr elic/node-newrelic/commit/b55d8e1ca09e6055ea09f4fcd773a05245e7203f))
- You no longer need to load Next.js instrumentation via @newrelic/next.
- Instead you must load the agent via NODE_OPTIONS='-r newrelic' next start

Documentation

Updated compatibility report (#2401) (a53085d)

Miscellaneous chores

Added test configs for defined targets in the aws test suite (#2403) (cf514d9)
Added producer and consumer metrics to kafkajs instrumentation (#2407) (41c1cc6)
Switched to using Node built-in test runner (#2387) (b9f64b7)
Updated @newrelic/native-metrics to 11.0.0 (#2412) (aef69e2)
Updated dashboard links in developer-setup.md (#2397) (16866da)
Verified MySQL host:port metric is recorded (#2400) (74176f7)

Tests

Removed mongodb-esm tests as they are not atomic and conflicting with mongodb tests in CI (#2416) (e587b9d)
Updated minimum version of lesser used versions of 3rd party libraries (#2399) (ef8c006)

Support statement:

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

Node.js agent v12.1.0

Mon, 12 Aug 2024 00:00:00 +0000

Notes

Bug fixes

Pick log message from merging object in Pino instrumentation (#2421) (599072b)
Added TLS verification for Redis (#2446) (9a16b70)

Documentation

Updated compatibility report (#2440) (32abe5f)
Updated examples to properly use specs (#2422) (f7e8c58)
Fixed typo in doc header (#2433) (9726e23)

Miscellaneous chores

Added entity relationship attributes to SQS segments (#2436) (578aead)
Converted agent unit tests to node:test (#2414) (b32f793)
Fixed mongodb-esm tests in combination with security agent (#2444) (5d617de)
Limited superagent tests to avoid new breaking release (#2439) (f1dd8e7)
Removed promise resolvers from callback based agent unit tests (#2450) (3766895)

Tests

Moved pkgVersion to collection-common to avoid a conflict with ESM tests (#2438) (7260fa3)
Restored mongodb-esm tests (#2434) (67a12e3)
Updated custom test reporter to only log failed tests when there are failures (#2425) (baa37ec)
Updated tls redis tests to work with older versions of redis v4 (#2454) (ffd9b17)

Support statement

See the New Relic Node.js agent EOL policy for information about agent releases and support dates.

Node.js agent v12.1.1

Thu, 15 Aug 2024 00:00:00 +0000

Notes

Bug fixes

Updated amqplib instrumentation to properly parse host/port from connect (#2461) (91636a8)
Updated redis instrumentation to parse host/port when a url is not provided (#2463) (2b67623)
Updated the kafkajs node metrics to remove /Named from the name (#2458) (37ce113)

Code refactoring

Updated pino instrumentation to separate the wrapping of asJson into its own function (#2464) (81fdde1)

Documentation

Updated compatibility report (#2460) (a4570e9)

Miscellaneous chores

Removed limit on superagent versioned testing (#2456) (b4b6a6b)

Support statement:

See the New Relic Node.js agent EOL policy for information about agent releases and support dates.

Node.js agent v12.10.0

Thu, 09 Jan 2025 00:00:00 +0000

Notes

Features

Added instrumentation for @opensearch-projects/opensearch v2.1.0+ (#2850) (763c0e6)

Bug fixes

Fixed event matcher to use properties specific to web requests (v1/ALB and v2) (#2863) (a93fe6e)

Miscellaneous chores

Fixed mysql2 tests for new mysql2 version (#2853) (30a6de0)
Updated eslint configuration (#2851) (d2fba9d)
Utilize updated @newrelic/eslint-config (#2865) (f53d4fc)

Tests

Removed t.diagnostic from tests (#2858) (23ca237)

Continuous integration

Updated codecov-action to latest released version sha (#2866) (75f8902)

Support statement:

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

Node.js agent v12.11.0

Tue, 14 Jan 2025 00:00:00 +0000

Notes

Features

Removed transaction from segment. Introduced a new enterSegment and enterTransaction to make context propagation more clear (#2646) (d84531a)
Removed children from segments. (#2689) (66f140f)
Added segment tree to transaction trace (#2717) (8fcc239)
Added segment synthesizer and provided ability to convert http client otel spans to external http trace segments (#2745) (c42f8e6)
Added otel consumer span processing (#2854) (82fe9d5)
Added segment and transaction synthesis for http server spans (#2833) (8fa4d05)
Added segment synthesis for db client otel spans to db trace (#2820) (1ad1858)
Added segment synthesis for internal spans (#2840) (436c63d)
Added segment synthesis for otel producer spans (#2839) (30f4995)

Bug fixes

Updated shim.createSegment and shim.handleMqTracingHeaders to be backwards compatible with the changes to context manager (#2844) (554b4bf)

Code refactoring

Removed class construction on the segment synthesis and instrumentation (#2837) (4b7ec0f)

Documentation

Updated compatibility report (#2869) (4bde427)

Miscellaneous chores

Added rules engine to match OTEL spans (#2694) (2c93c68)
Updated rules engine to account for fallbacks (#2831) (19fbdfb)
Updated versioned tests docs (#2874) (73a84d7)

Tests

Updated a langchain test to be less rigid on asserting the tracking metric by @langchain/core version (#2876) (73985ea)

Support statement:

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

Node.js agent v12.11.1

Thu, 16 Jan 2025 00:00:00 +0000

Notes

Bug fixes

Updated undici instrumentation to fix crash with trying to calculate exclusive duration on a segment that no longer exists (#2884) (3b7e4bf)

Documentation

Updated compatibility report (#2878) (e784f84)

Miscellaneous chores

Fixed dns integration tests (#2883) (dd30ad7)

Tests

Restored the branch to test apollo-server-plugin to main (#2879) (978faab)

Support statement:

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

Node.js agent v12.11.2

Thu, 23 Jan 2025 00:00:00 +0000

Notes

Features

Added support for Claude 3+ Chat API in Bedrock (#2870) (6a83abf)

Bug fixes

Added defensive code in shim to prevent crashing when checking parent segment (#2898) (751eb96)

Documentation

Updated compatibility report (#2888) (dce9deb)

Miscellaneous chores

Replaced backtracking regex with new algorithm (#2887) (46462d0)

Tests

Improved test coverage of normalizing claude 3 messages (#2893) (cc65763)

Support statement:

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

Node.js agent v12.11.3

Wed, 29 Jan 2025 00:00:00 +0000

Notes

Bug fixes

Fixed issue with bluebird and when instrumentation where checking active context crashed when transaction prematurely ends (#2909) (4a30d5c)
Fixed transaction-shim to properly create new transactions when the existing transaction is not active (#2912) (3ad8c59)

Documentation

Updated compatibility report (#2902) (cb16516)

Miscellaneous chores

Updated lint rule suppression comment (#2895) (559dc98)

Continuous integration

Move init container release from lambda to GHA (#2848) (8d8608d)

Support statement:

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

Node.js agent v12.12.0

Wed, 05 Feb 2025 00:00:00 +0000

Notes

Features

Added health check support for upcoming feature (#2841) (4c8bf13)
Added OpenTelemetry bridge instrumentation, which includes a context manager and processor to handle synthesizing segments and time-slice metrics (#2906) (d2e8a9e)

Bug fixes

Updated default config to accept undefined as default value (#2917) (e049442)

Documentation

Updated compatibility report (#2914) (acd0c90)

Miscellaneous chores

Added regex note to SQL obfuscator (#2911) (1533111)
deps: Updated @newrelic/security-agent to v2.3.0 (#2918) (ed89f38)

Continuous integration

Optimized the Lambda layers and Kubernetes init containers post-release workflow (#2915) (4be1099)

Support statement:

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

Node.js agent v12.13.0

Wed, 12 Feb 2025 00:00:00 +0000

Notes

Features

Added timeslice metrics for synthesized server segments (#2924) (f404585)
Added timeslice metrics for synthesized producer segments (#2939) (6832637)
Added timeslice metrics for synthesized database segments (#2922) (8606f78)
Propagate agent root context when opentelemetry ROOT_CONTEXT is passed in to trace propagator.(#2940) (b85111c)
- Added logic to handle properly naming and ending transactions for server spans.
Provided ability to disable instrumentation for core Node.js libraries (#2927) (2d232f1)

Bug fixes

Fixed api.getTraceMetadata to handle when there is an active transaction but not active segment (#2944) (6db3b4d)

Documentation

Updated compatibility report (#2920) (c7ae8be)

Miscellaneous chores

Localized OTEL attribute constants (#2928) (965c41b)
Updated import-in-the-middle version (#2923) (aa2781f)

Support statement:

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

Node.js agent v12.14.0

Tue, 18 Feb 2025 00:00:00 +0000

Notes

Features

Added support for region-prefixed Bedrock models (#2947) (6acf535)
Added attribute reconciliation for message producer spans (#2942) (a9ba396)
Added timeslice metrics for synthesized consumer segments (#2938) (acfe953)

Bug fixes

Fixed queueing of logs from child loggers (#2945) (888cfe8)
Fixed undici/fetch instrumentation to properly assign the parent-id portion of the traceparent header on outgoing requests to the active http external span id (#2951) (bc714cf)
Updated api.recordLogEvent to no longer truncate the message key in log event (#2949) (8dd557b)
- Thanks for your contribution @rChaoz 🎉

Documentation

Updated compatibility report (#2948) (8e32ed7)

Support statement:

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

Node.js agent v12.15.0

Mon, 03 Mar 2025 00:00:00 +0000

Notes

Features

Allowed undici error reporting to be disabled with feature flag undici_error_tracking (#2956) (6278107)
- Thanks for your contribution @Voziv :tada:
Added ability to propagate traceparent and tracestate on incoming server/consumer spans and outgoing client http and producer spans (#2958) (258ad7d)
Added server span transaction naming fallback to the url.path (#2966) (770bf6f)
Updated Context class to ensure bi-directional context propagation with opentelemetry bridge (#2962) (dfeec5a)

Code refactoring

Separated context classes for agent in standard and opentelemetry bridge mode (#2967) (d11c071)

Documentation

Updated compatibility report (#2973) (7106c81)

Miscellaneous chores

Added consumer attribute reconciliation (#2957) (8943672)
Added http external span attributes (#2955) (ef697a5)
Limit nestjs to enable successful CI (#2972) (e9699cf)
Refactored otel attribute reconciling (#2964) (1b5ed2c)

Support statement:

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

Node.js agent v12.16.0

Mon, 17 Mar 2025 00:00:00 +0000

Notes

Features

Added support for response streaming Lambda functions (#2981) (61dbbf9)
Added AWS entity linking segment attributes for otel bridge (#2978) (6bf1ccc)
Added error handling on transactions for otel spans (#2985) (4e61e09)

Code refactoring

Updated span event generation to assign the appropriate span.kind based on the segment name (#2976) (697b17e)

Documentation

Updated compatibility report (#2988) (ed17a6d)

Miscellaneous chores

Clarified supported next.js middleware versions in docs (#2984) (15cb454)
Clarified system metrics sampler naming (#2987) (8647d43)
Refactored loops to be simpler (#2990) (79fb8e9)
Removed unused transaction method (#2986) (cb4e2f7)
Reverted restriction in NestJS versioned tests (#2979) (ffddcab)

Tests

Fixed fastify assertions around span kind while running security agent (#2983) (c641645)

Support statement:

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

Node.js agent v12.16.1

Mon, 24 Mar 2025 00:00:00 +0000

Notes

Features

Assigned all attributes on internal spans to segment (#3000) (5403018)

Bug fixes

Fixed tracer.transactionNestProxy to create a new transaction if there is no transaction or transaction is not active (#3007) (ced9e22)

Documentation

Updated compatibility report (#2993) (cdfa042)

Tests

Fixed handling require esm for >20.19.0+ (#3002) (b808e00)

Support statement:

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

Node.js agent v12.17.0

Wed, 02 Apr 2025 00:00:00 +0000

Notes

Features

Azure Function utilization (#3017) (80ab93e)
Support honoring W3C traceparent sampled flag (#3009) (d903413)
- By default the agent will not honor the traceparent sampled flag.
- To control how sampling works with traceparent set the following in config:
  - distributed_tracing.sampler.remote_parent_sampled(when the traceparent sampled flag is 01)
    - always_on: the agent will sample spans
    - always_off: the agent will not sample spans
    - default: the agent will rely on existing priority sampling to make its decisions
  - distributed_tracing.sampler.remote_parent_not_sampled(when the traceparent sampled flag is 00)
    - always_on: the agent will sample spans
    - always_off: the agent will not sample spans
    - default: the agent will rely on existing priority sampling to make its decisions

Code refactoring

Updated otel bridge to centralize mapping rules for a given span attribute to accomondate semantic convention spec updates (#3010) (c20c36b)

Documentation

Updated compatibility report (#3013) (8fab715)

Tests

Pinned openai@4.90.0 to work with @langchain/openai (#3019) (eaa3db0)

Support statement:

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

Node.js agent v12.18.0

Mon, 14 Apr 2025 00:00:00 +0000

Notes

Features

Support Azure functions background trigger types (#3028) (3bf17b0)
Support Azure functions HTTP trigger type (#3021) (90d894b)

Bug fixes

Updated span streamer to properly retry failed batches and handle flushing batch queue every 5 seconds (#3033) (7db0e7c)

Code refactoring

Update otel bridge rules synthesizer to properly handle consumer kind rules (#3003) (3295dd1)

Documentation

Updated compatibility report (#3020) (ce32b67)

Miscellaneous chores

Fixed prisma CI issues (#3031) (1349cae)
Improved logging within utilization detection (#3034) (b47bd46)

Support statement:

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

Node.js agent v12.18.1

Tue, 29 Apr 2025 00:00:00 +0000

Notes

Bug fixes

Only add newrelic header to outgoing headers if has a value (#3052) (6ef0a90)

Code refactoring

Added defensive code when calculating exclusive time on a segment where it cannot locate the segment in the transaction trace tree (#3051) (b4aa25e)
Updated how otel bridge trace propagator assigns traceparent/tracestate headers (#3046) (6e317b8)

Documentation

Updated compatibility report (#3054) (#3050) (#3026)

Tests

Skipped regressions in pg-native versioned tests (#3053) (6ce3670)
Updated elasticsearch image for versioned tests (#3038) (3d73f9f)

Support statement:

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

Node.js agent v12.18.2

Wed, 30 Apr 2025 00:00:00 +0000

Notes

Bug fixes

Updated createSegment to stop adding segments to trace when max_trace_segments is exceeded (#3056) (8f3336e)

Documentation

Updated compatibility report (#3065) (#3063)

Support statement:

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

Node.js agent v12.19.0

Tue, 20 May 2025 00:00:00 +0000

Notes

Features

Added Azure Function HTTP streaming support (#3070) (9865e1c)

Code refactoring

Added check to only set a FakeSpan if transaction.agent.otelSpanKey exists (#3071) (b0c1ac1)

Documentation

Updated compatibility report (#3074) (7dc9aad)

Miscellaneous chores

Fixed redis legacy test suite (#3077) (ec39925)
Updated security agent (#3098) (48ed8cb)

Tests

Added cross agent otel bridge tests (#3057) (1526bed)

Support statement:

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

Node.js agent v12.2.0

Mon, 19 Aug 2024 00:00:00 +0000

Notes

Features

Added instrumentation support for Express 5 beta (#2476) (06a4c2f)
- This will be experimental until express@5.0.0 is generally available

Bug fixes

Updated koa instrumentation to properly get the matched route name and to handle changes in @koa/router@13.0.0 (#2486) (0c2ee2f)

Documentation

Removed reference to @newrelic/next in README (#2479) (8740539)
Updated compatibility report (#2487) (c0a5e64)

Miscellaneous chores

Reverted to upstream require-in-the-middle (#2473) (9bbc41c)
Updated aggregators unit tests to node:test (#2481) (fd2d76f)

Support statement:

See the New Relic Node.js agent EOL policy for information about agent releases and support dates.

Node.js agent v12.20.0

Tue, 27 May 2025 00:00:00 +0000

Notes

Features

Added support for OTEL metrics API (#3109) (4a57721)

Bug fixes

Fixed common.getKeys logic (#3114) (01d4fa5)
Fixed Google Cloud Run hostname issue (#3111) (e233fb7)

Documentation

Updated compatibility report (#3106) (3c47406)

Miscellaneous chores

Added event source type to txn name for Lambda APM Mode (#3110) (ddc2e2a)

Support statement:

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

Node.js agent v12.22.0

Tue, 24 Jun 2025 00:00:00 +0000

Notes

Features

Added openai v5 streaming support (#3148) (6e90d41)
Added support for openai.responses.create api (#3139) (a1204b2)

Bug fixes

Fixed error logging for undefined tracestate header (#3170) (3c915f5)

Code refactoring

Updated transformation rules to remove the bespoke rule to appease @google-cloud/pubsub <5.1.0 (#3151) (2d9b4b4)

Documentation

Gemini compatibility (#3134) (bbdc531)
Updated compatibility report (#3171) (f3361e4)

Miscellaneous chores

Added logging of used New Relic environment variables (#3145) (1a9d9f5)
Added supportability metrics to OTEL metrics API (#3164) (5312db0)
Fixed formatting in Slack PR titles (#3167) (847859f)
Improved output of pending prs script (#3160) (9bafd77)
Improved setup of OpenTelemetry metrics API (#3138) (e91592d)
Pinned google/genai to <1.5.0 (#3154) (04b9bde)
Removed discontinued Bedrock models (#3158) (2c79a31)
Removed usage of shim.argsToArray in favor of rest parameters (#3141) (b144d71)
Tweaked nestjs test manifest (#3152) (51b82aa)

Tests

Added JSDoc annotation for benchmark interface (#3127) (77e7e0a)
fixed test assertion for langchain openai (#3169) (29ec912)
Skips running nest 11+ on node 18 due to dropping support (#3149) (961975b)
unpinned google genai tests (#3168) (cfa7114)

Support statement:

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

Node.js agent v12.21.0

Wed, 04 Jun 2025 00:00:00 +0000

Notes

Features

Added @google/genai Gemini AI LLM instrumentation (#3119) (7f28a29)
Updated opentelemetry bridge to rely on configuration based transformation rules (#3125) (ad116d2)

Bug fixes

Refactored getHostnameSafe to accommodate GCP (#3132) (f1eea8d)
Updated openai instrumentation to work with 5.0.0+ (#3129) (09146a9)
Updated rules to work with 1.17.0 and 1.24.0 for consumer and producer span kind (#3128) (686c747)

Documentation

Updated compatibility report (#3124) (c51d45f) (#3117) (084e599)

Miscellaneous chores

Added preliminary otel configuration (#3121) (664ee4a)

Support statement:

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

Node.js agent v12.24.0

Mon, 07 Jul 2025 00:00:00 +0000

Notes

Features

Implemented configurable attribute value size limit (#3206) (08a6eca)

Documentation

Updated compatibility report (#3190) (72c492c)

Miscellaneous chores

Rename GCP ID config flag (#3205) (8446f29)

Support statement:

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

Node.js agent v12.23.0

Mon, 30 Jun 2025 00:00:00 +0000

Notes

Features

Added ability to report only on entry and exit spans (#3184) (1f909d3)
Added Node.js 24 support (#3080) (a538c2a)

Documentation

Updated compatibility report (#3186) (5498c15)

Miscellaneous chores

Fix issues on Node 24 (#3181) (24832df)
Removed force labels on main CI workflow (#3183) (3aaee17)
Updated undici tests to unblock CI (#3185) (08261eb)

Continuous integration

Fixed the name of todo colum in add to board reusable workflow (#3178) (f216e0c)

Support statement:

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

Node.js agent v12.25.0

Wed, 09 Jul 2025 00:00:00 +0000

Notes

Features

Instrument AWS Bedrock Converse API (#3191) (16ac684)

Bug fixes

eventSegment.addAttribute will not crash if null (#3215) (8955f37)
openai Responses API support changed to >=v4.87.0 (#3219) (19c0c70)

Documentation

Updated compatibility report (#3220) (b4350c7)

Miscellaneous chores

Converted .proto to .json for bundling (#3212) (1e208d4)

Support statement:

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

Node.js agent v12.25.1

Tue, 10 Feb 2026 00:00:00 +0000

Notes

Security

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

Support statement:

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

Node.js agent v12.3.0

Tue, 27 Aug 2024 00:00:00 +0000

Notes

Features

Added new API method withLlmCustomAttributes to run a function in a LLM context (#2437) (57e6be9)
- The context will be used to assign custom attributes to every LLM event produced within the function

Bug fixes

Improved AWS Lambda event detection (#2498) (5e8b260)

Documentation

Updated compatibility report (#2493) (0448927)

Miscellaneous chores

Fixed linting scripts (#2497) (c395779)
Removed examples/shim (#2484) (40d1f5c)
Updated test-utils dependency and added matrix-count only (#2494) (5e04c76)

Tests

Converted the api unit tests to node:test (#2516) (ab91576)
Converted context-manager unit tests to node:test (#2508) (9363eb0)

Continuous integration

Updated codecov action sha to post coverage from forks. Added flag to fail ci if it fails to upload report (#2490) (12fbe56)

Support statement:

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

Node.js agent v12.3.1

Wed, 04 Sep 2024 00:00:00 +0000

Notes

Bug fixes

Fixed detection of REST API type payloads in AWS Lambda (#2543) (adfeebc)

Documentation

Cleaned up formatting of api.js to properly inject example snippets when rendering on API docs site (#2524) (4b34f3d)
Updated compatibility report (#2523) (29784ea)
Updated Next.js Otel cloud provider FAQ (#2537) (6553807)

Tests

Converted db unit tests to node:test (#2514) (bea4548)
Converted grpc, lib, and utilization tests to node:test (#2532) (c207e1e)
Replaced distributed tracing tests with node:test (#2527) (8184c56)
Added a match function for tests (#2541) (51e7f34)
Converted config to node:test (#2517) (1534a73)

Support statement:

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

Node.js agent v12.4.0

Wed, 11 Sep 2024 00:00:00 +0000

Notes

Features

Added support for express@5 (#2555) (252f3b2).
Provided ability to disable instrumentation for a 3rd-party package (#2551) (abfb9f0).
- To disable instrumentation, set config.instrumentation.<library>.enabled to false. The values of <library> are the keys listed here.
- Be cautious when using this feature, as disabling instrumentation for a library could affect instrumentation of other libraries executed afterwards.

Miscellaneous chores

Added CI for publishing agent as Azure site extension (#2488) (468943a).
Added Azure site extension installation scripts (#2448) (a56c4e1).

Tests

Converted llm-events tests to use node:test (#2535) (ebfa2e9).
Migrated test/unit/spans to use node:test (#2556) (9319071).
Migrated test/unit/util to use node:test (#2546) (0b07be8).
Migrated tests in test/unit/instrumentation to use node:test (#2531) (47b8398).
Converted collector unit tests to node:test (#2510) (762511b).
Converted errors unit tests to node:test (#2540) (ae82760).

Support statement:

See the New Relic Node.js agent EOL policy for information about agent releases and support dates.

Node.js agent v12.5.0

Thu, 12 Sep 2024 00:00:00 +0000

Notes

Features

Added utilization info for ECS (#2565) (6f92073)

Bug fixes

Ensured README displays for Azure site extension (#2564) (a30aed5)

Documentation

Updated compatibility report (#2562) (8f7aebe)

Tests

Convert metric and metrics-recorder tests to node:test (#2552) (7ae4af4)
Updated serverless unit tests to node:test (#2549) (619f23c)

Support statement:

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

Node.js agent v12.5.1

Mon, 23 Sep 2024 00:00:00 +0000

Notes

Bug fixes

Fixed handling of Pino merging object (#2600) (de3c266)

Documentation

Updated compatibility report (#2589) (2f45a4a)

Miscellaneous chores

deps: Udpated @newrelic/security-agent to v2.0.0 (#2594) (92e6978)

Tests

Converted transaction* and urltils tests to node:test (#2585) (d169546)
Fixed @koa/router tests. path-to-regex differs between @koa/router and koa-router now (#2587) (608dd98)
Removed transitive deps from versioned tests as they will auto-install if required as peer deps (#2580) (0db6599)
Updated a missing minSupported in aws-sdk-v3 versioned tests (#2582) (c997af6)
Updated fastify versioned tests to work with fastify@5.0.0 (#2584) (a5a1526)
Updated how we handle the koa-router nuance of wildcard routes (#2588) (ddeb097)
Updated koa-router to tests to handle bug fixes from 13.0.1 (#2578) (a28e2e6)
Migrate block of unit tests to node:test (#2570) (5cd1d8a)
Migrate second block of unit tests to node:test (#2572) (943a83e)
Reduce koa-router version to enable CI (#2573) (f44a99b)
Removed noisy test log (#2583) (3766ed6)

Continuous integration

Added workflow run trigger to Azure site extension publish job (#2575) (e8ae942)

Support statement:

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

Node.js agent v12.5.2

Wed, 23 Oct 2024 00:00:00 +0000

Notes

Features

Updated shim/when instrumentation to use tracer to run in context (#2642) (1a80ad5)

Bug fixes

Fixed amqplib instrumentation via ESM (#2668) (a36deba)

Documentation

Remove SECURITY.md (#2633) (41002cd)
Updated compatibility report (#2670) (281c0fa)
Updated match custom-assertion jsdoc (#2636) (c37abe5)

Miscellaneous chores

Upgraded import-in-the-middle to work around a bug introduced in 1.11.1 (#2618) (9ad476a)

Tests

Migrated aws-sdk-v2 and aws-sdk-v3 tests to node:test (#2620) (e0dc015)
Migrated test/unit/shim to node:test (#2599) (8d1acff)
Migrated test/versioned/amqplib to node:test (#2612) (7bdada6)
Migrated test/versioned/express to node:test (#2609) (bd2f1a5)
Migrated bluebird versioned tests to node:test (#2635) (6e28fad)
Migrated last group of unit tests to node:test (#2624) (386f546)
Migrated unit tests to node:test (#2623) (86231b7)
Updated tests that relied on tspl by awating the plan.completed instead of calling end to avoid flaky tests (#2610) (935ac14)
Updated tests that used the context manager directly and instead use the tracer to access the segment context (#2643) (b917b3e)
Updated the mininum version of pg-native in pg-esm tests to align with the pg tests (#2616) (16be714)
Migrated bunyan, pino, and winston tests to node:test (#2634) (69c1ab8)
Migrated fastify tests to node:test (#2632) (b522477)
Migrated block of unit tests to node:test (#2607) (e33807b)
Migrated block of unit tests to node:test (#2604) (cd90ce1)
Migrated block of unit tests to node:test (#2593) (6d4d49e)

Continuous integration

Added delay to site extension publishing to wait for NPM (#2665) (e412020)

Support statement:

See the New Relic Node.js agent EOL policy for information about agent releases and support dates.

Node.js agent v12.6.0

Wed, 30 Oct 2024 00:00:00 +0000

Notes

Features

Added ARN and provider to Lambda segments (#2674) (a23294c)
Added IAST configurations for scan scheduling and restrictions (#2645) (13a627a)

Documentation

Updated compatibility report (#2673) (e4d0503)

Miscellaneous chores

Replaced static openssl cert usage with in-process cert (#2671) (72872f4)

Support statement:

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

Node.js agent v12.6.1

Thu, 07 Nov 2024 00:00:00 +0000

Notes

Features

added cloud.aws.account_id to default config (#2691) (0ccee8e)

Bug fixes

Fixed issue parsing docker container id (#2705) (0c897ab)

Documentation

Updated compatibility report (#2679) (3c19cdf)

Miscellaneous chores

Moved recorders to lib/metrics/recorders (#2666) (d8dfe84)

Tests

Fixed file extensions for aws-sdk v2 and v3 versioned tests to reflect they have been migrated to node:test (#2687) (4ec09ba)
Migrated elasticsearch and esm-package versioned tests to node:test (#2680) (0e0c2b2)
Updated cls and connect tests to node:test (#2676) (1e74434)
Reorganized custom assertions and improved test reporter (#2700) (9e98b18)
Updated cassandra-driver tests to node:test (#2678) (bd4f7ff)

Support statement:

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

Node.js agent v12.7.0

Mon, 11 Nov 2024 00:00:00 +0000

Notes

Features

Added cloud.resource_id attribute to dynamo spans (#2701) (904f41b)
Enhance Proxy Request Handling to Display Actual External URLs (#2698) (3ef7bbe)
- Thanks for the contribution @mstarzec386

Documentation

Updated compatibility report (#2712) (82f0e98) (#2699) (4432c42)

Miscellaneous chores

Added a benchmark script for our sql parser (#2708) (9b6de68)
Updated express-esm, generic-pool, grpc, & grpc-esm tests to node:test (#2702) (a229bbf)

Tests

Migrated mysql and mysql2 versioned tests to node:test (#2711) (fc767e0)

Support statement:

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

Node.js agent v12.8.0

Tue, 19 Nov 2024 00:00:00 +0000

Notes

Features

Added labels.enabled and labels.exclude to config defaults (#2727) (36adb13)
Added new configuration options to add custom tags (labels) to logs (#2743) (d20c874)
- With custom tags on logs, platform engineers can easily filter, search, and correlate log data for faster and more efficient troubleshooting, improved performance, and optimized resource utilization. To learn more about this feature see the documentation
- To enable set config.application_logging.forwarding.labels.enabled to true or the environment variable NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LABELS_ENABLED to true (#2727) (36adb13)
- To exclude labels that were set on application from logs use config.application_logging.forwarding.labels.exclude or the environment variable NEW_RELIC_APPLICATION_LOGGING_FORWARDING_LABELS_EXCLUDE
Added support for Bedrock Claude 3.5 invoke model user request (#2721) (a901a24)
Moved entity.guid, entity.name, entity.type, and hostname to common.attributes on logs payload instead of in every log message (#2736) (a7f14de)

Bug fixes

Corrected expected shape of user input in get Prompt() (#2741) (a8eef8b)

Documentation

Updated compatibility report (#2755) (459a3f1)

Miscellaneous chores

Fixed test reporter (#2751) (5878ef9)
Improved unit test speed (#2728) (9640030)

Tests

Fixed two assertions to work against older versions of openai (#2726) (8996fc3)
Migrated ioredis, prisma and undici versioned tests to node:test (#2746) (449ae03)
Migrated memcached, nestjs, and restify versioned tests to node:test (#2752) (653f614)
Migrated nextjs versioned tests to node:test (#2749) (d385af6)
Migrated redis versioned tests to node:test (#2725) (9752827)
Updated hapi tests to node:test (#2722) (636899b)
Updated kafkajs, langchain, & openai tests to node:test (#2723) (b6e4c5d)
Updated koa tests to node:test (#2744) (86c22a4)
Updated mongodb tests to node:test (#2738) (295e7e6)
Updated pg and pg-esm tests to node:test (#2750) (40aea36)

Support statement:

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

Node.js agent v12.8.1

Wed, 04 Dec 2024 00:00:00 +0000

Notes

Bug fixes

Fixed matching for ALB and API Gateway (v1 & v2) events for Lambda (#2780) (2f1a6c6)
Updated mysql2 instrumentation to work with 3.11.5+ (#2811) (3ec4fee)

Documentation

Fixed changelog to group the labels in logs work (#2776) (04271da)
Fixed links to next.js apps (#2812) (834440c)
Updated compatibility report (#2809) (fc1fbda)

Tests

Migrated test/integration/api tests to node:test (#2787) (03b01a3)
Migrated test/integration/core tests to node:test (#2781) (36bc0e7)
Migrated test/integration/instrumentation tests to node:test (#2784) (963fb30)
Migrated test/integration/transaction tests to node:test (#2783) (68e1a0c)
Migrated test/integration/utilization tests to node node:test (#2794) (db237e9)
Migrated test/smoke/api tests to node:test (#2772) (af3bbcd)
Migrated CAT integration tests to node:test (#2778) (bd9df5f)
Migrated integration tests at root to node:test (#2803) (a7ef080)
Migrated root smoke tests to node:test (#2771) (78f2709)
Migrated smoke tests in test/smoke/agent, test/smoke/e2e, and test/smoke/index to node:test (#2774) (440a0af)
Removed t.diagnostic as they're better suited as code comments (#2786) (ee24027)
Fixed flaky test on macOS (#2790) (eebf06b)
Removed reference to pino internals (#2805) (0382ee2)
Restricted mysql2 version to get CI working (#2808) (ad60ed4)
Updated agent integration tests to node:test (#2782) (d556512)
Updated config integration tests to node:test (#2777) (fe8d2df)
Updated distributed-tracing integration tests to node:test (#2798) (83ad1f3)
Updated grpc integration tests to node:test (#2789) (ea8f743)
Updated index, issue-2155, and metric integration tests to node:test (#2801) (80b55c2)
Updated q, superagent, and when tests to node:test (#2773) (ff2d8d0)
Updated shimmer, uninstrumented, environment, flatten, and logger integration tests to node:test (#2802) (83fd7ee)
Added per test file timing to test reporter (#2785) (00d9940)

Support statement:

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

Node.js agent v12.8.2

Mon, 09 Dec 2024 00:00:00 +0000

Notes

Bug fixes

Fixed mysql2 promise instrumentation to properly handle createPool and createPoolCluster (#2823) (a679872)
Fixed matching for Lambda events containing resource but which aren't API Gateway (#2825) (64d2042)

Documentation

Updated compatibility report (#2814) (580a27f)

Miscellaneous chores

Improved documentation for assertSegments (#2819) (298473c)

Tests

Added test/custom-assertions.js to the apollo-server external versioned tests config (#2817) (568525a)
Fixed flakey when versioned test (#2821) (54f034b)

Support statement:

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

Node.js agent v12.9.0

Wed, 18 Dec 2024 00:00:00 +0000

Notes

Features

Added entity linking attributes to aws-sdk v3 Lambda segments (#2845) (8820265)
Provided ability to define newrelic config as newrelic.mjs (#2836) (972b59d)

Documentation

Updated compatibility report (#2828) (d5fe8e3)

Miscellaneous chores

deps: Updated @newrelic/security-agent to v2.2.0 (#2842) (170941e)
Updated borp configs to target tests correctly (#2835) (66ae59d)

Tests

Removed tap and cleaned up left over tap helpers (#2804) (37407b6)
Updated match to fail if you pass in an object that lacks the expected keys (#2843) (a3db8bd)

Support statement:

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

Node.js agent v1.2.0

Sat, 07 Dec 2013 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes:

Before, there were certain circumstances under which an application would crash without New Relic installed, but wouldn't crash with it. This has been fixed, and applications with New Relic installed now crash consistently. The error tracer is now also considerably simpler.
Added a security policy. See the new section in README.md or read SECURITY.md.
Future-proofed the MongoDB instrumentation and prevented the module from breaking GridFS.
Made a small tweak that should reduce the amount of blocking file I/O done by the module.
The module's instrumentation and harvest cycle will now not hold the process open in Node 0.9+. This should make it easier for processes to shut themselves down cleanly with New Relic running.
The environment information gatherer will no longer crash if it tries to read a directory where it's expecting a file.
Errors thrown during the execution of Express routes or Connect middlewares that were attached to requests that ended in HTTP status codes configured to be ignored by default will now be ignored correctly.
Made the module play nicer with Node's REPL. It no longer assumes that an application necessarily has a main module.
A few tweaks were made to support the CoolBeans dependency injection framework.
Several log messages were demoted to a less chatty level.

Node.js agent v1.20.1

Thu, 11 Jun 2015 00:00:00 +0000

Notes

Fixed a bug in custom event recording limits.

Previously, the agent would use the config value for max events (default of 1000) for the first harvest of custom events, then would use an internal default for the reservoir with max of 10 events for each harvest after that, resulting in less than the expected number of events being sent.
Exposed the custom_insights_events settings in the user config.

You can now set custom_insights_events.enabled and custom_insights_events.max_samples_stored in your newrelic.js.

Read more about these settings in our documentation.

Node.js agent v1.21.0

Fri, 10 Jul 2015 00:00:00 +0000

Notes

This release has been unpublished from npmjs.org. Use v1.21.1 or higher instead.
Support for display host names.

The agent now has configuration settings to allow configuration of custom host names. Set process_host.display_name to enable this.

If this config is not set, the agent will continue to use the host name found through an os.hostname() call. Should this lookup fail somehow, process_host.ipv_preference can now be set to 4 or 6 to configure the type of ip address displayed in place of the host name.

Node.js agent v1.20.2

Tue, 23 Jun 2015 00:00:00 +0000

Notes

Fixed a bug where custom events weren't being sent.

In a refactor of our data collection cycle, we omited the custom events from the list of commands, this is now fixed.
Fixed a very rare bug where the custom event pool could be set to 10 instead of the user config value. This patch was contributed by shezarkhani, thanks!

This case would only be hit if you disabled custom events via server sent config while there were custom events ready to be sent. Then you later reenabled it via server sent config. It would only occur for one data collection cycle then reset back to the correct size.

Node.js agent v1.21.1

Mon, 13 Jul 2015 00:00:00 +0000

Notes

Moved concat-stream from dev dependencies to production dependencies.

Last week we released v1.21.0 but forgot to move a dependency. We've removed v1.21.0 from npmjs.org and this release contains the changes from that version.
Support for display host names (originally in 1.21.0).

The agent now has configuration settings to allow configuration of custom host names. Set process_host.display_name to enable this.

If this config is not set, the agent will continue to use the host name found through an os.hostname() call. Should this lookup fail somehow, process_host.ipv_preference can now be set to 4 or 6 to configure the type of ip address displayed in place of the host name.

Node.js agent v1.21.2

Thu, 06 Aug 2015 00:00:00 +0000

Notes

Corrected a defect in the handling of uncaught exceptions

This defect was surfaced in versions of node that did not have process._fatalException, namely v0.8. When an uncaught exception occurs, the agent now records the error and passes it along to the other uncaught exception handlers that have been registered. This was inverted before, passing along errors when there were no other error handlers present and rethrowing otherwise.

Node.js agent v1.22.0

Thu, 20 Aug 2015 00:00:00 +0000

Notes

Errors will now respect its transaction's ignore state.

When ignoring transactions, related errors will now also be ignored.
The agent can now handle immutable and frozen error objects.

In rare cases the agent gets passed an immutable error object. The agent would then crash when trying to tag the error object with the current transaction. We now handle these errors properly.

Node.js agent v1.22.1

Mon, 21 Sep 2015 00:00:00 +0000

Notes

Express and Connect instrumentation will no longer crash on Node 4

As of ES6, the Function.name attribute will track if the function is a getter/a setter/is bound to (i.e. fn.bind().name -> 'bound ' + fn.name). This new behavior caused the agent to crash on start up due to the way connect and express are instrumented. The agent is now more defensive of future implementations of ES6.

Node.js agent v1.22.2

Wed, 14 Oct 2015 00:00:00 +0000

Notes

Removed client support of the RC4 stream cipher for communicating with the New Relic servers.

The RC4 cipher is considered unsafe and is generally being deprecated.
Fix for logging version number in Express instrumentation. Thanks @tregagnon.

When an unsupported version of Express is detected, we log a message that contains the Express version number. The version is a string and was being logged as a number, resulting in NaN in the log message.
Agent is now more safe when recording memory stats.

Previously, the agent would crash the process as it was gathering memory usage information (i.e. when process.memoryUsage threw an error). This defect is now guarded against with a try-catch.

Node.js agent v1.23.0

Thu, 29 Oct 2015 00:00:00 +0000

Notes

The New Relic Node Agent now officially supports Node v4!

We are excited to announce that the New Relic Node Agent officially supports Node v4.x! We've tested the agent across all major versions of Node used by New Relic customers to ensure a quality Node APM experience. New Relic recommends upgrading to Node v4.x for best Node Agent performance.
Corrected a parsing issue in the slow sql query parsing step.

Previously, the agent would not be able to parse inputs to database libraries that specified sql as an option param. This was an issue with node-mysql, namely. The agent now correctly handles this case and registers the queries as expected.

Node.js agent v1.23.1

Thu, 05 Nov 2015 00:00:00 +0000

Notes

newrelic.getBrowserTimingHeader() API now includes the full transaction name.

Previously, the agent would use a fragment of the transaction name, causing Browser Monitoring transactions and APM transactions to not be cross linked. This change makes the cross linking work correctly.

Node.js agent v1.24.0

Wed, 18 Nov 2015 00:00:00 +0000

New features

Advanced Analytics for APM Errors

With this release, the agent reports TransactionError events. These new events power the Advanced Analytics for APM Errors feature. The error events are also available through New Relic Insights.

Advanced Analytics for APM Errors lets you see all of your errors with granular detail, filter and group by any attribute to analyze them, and take action to resolve issues through collaboration.

Bug fixes

NEW_RELIC_LOG_ENABLED environment variable is now treated as a boolean.

Previously, this option was treated as a string, causing it to not work for some use cases. Thanks to @jakecraige for contributing this fix!

Node.js agent v1.24.1

Wed, 30 Dec 2015 00:00:00 +0000

New features

Error totals are now reported.

The agent now reports metrics that reflect the total number of errors that have occurred in web and background transactions.

Bug fixes

Disabling SSL no longer requires the setting of a port.

Previously, the agent required changing port in the config to 80 when disabling SSL. The agent will now default to port 80 if a port is not supplied and SSL is turned off.
Logging functions have been improved.

The agent will now properly log error stack traces and can rate limit logging messages. To aid in debugging we have provided more logging about the public API.

Node.js agent v1.25.0

Wed, 20 Jan 2016 00:00:00 +0000

New Features

Added support for the new Response Time Line and better representation of asynchronous data.

This has many implications in the UI. The first is the Application Overview, in the past we've always just shown "node" and maybe "request queueing" on the response time graph. We now show you an application breakdown like our other language agents! This means you'll be able to see how much time was in HTTP externals, your various datastores, or spent in node itself. Overlaid on this will be your response time as a blue line.

Next page that has been affected is our Transaction Overview page. Specifically when you click into a Transaction to see more detail. Previously we showed you a breakdown of the top time consumers in that transaction, both as a graph and as a table. Unfortunately that graph didn't show response time and the table would show percentages over 100%. Now, like the Application Overview, you will get a blue response time line and the breakdown table will have numbers that add up much more intuitively!

Finally, our Transaction Trace view has also been updated. The change is very similar to the changes mentioned above for the breakdown table in the Transaction Overview page. You should no longer see percentages over 100% here either.

Improvements

Transaction trace serialization is now 4x faster than before.

This speedup will primarily affect those with large, deeply nested transactions. Though small transactions have seen some improvement as well.

Node.js agent v1.25.1

Tue, 26 Jan 2016 00:00:00 +0000

Fixes

Corrected an issue where the agent would sometimes crash looking up the port of the HTTP server that a request came from.

Previously, the agent assumed the HTTP server would always have an address, unfortunately this isn't the case if the HTTP server's .close() has been called.

Node.js agent v1.25.3

Thu, 18 Feb 2016 00:00:00 +0000

Fixes

Fixed crashing bug on unhandled rejections in Q.

Previously, the agent would cause the process to crash in the event of an unhandled rejection.

Thanks to @mdlavin for this fix!

Node.js agent v1.25.2

Wed, 17 Feb 2016 00:00:00 +0000

Fixes

Added Q instrumentation.

The node agent now accurately records programs using Q for promises.

Thanks to @mdlavin for the contribution!
Added node-mysql2 support.

Thanks to @jhollingworth for adding node-mysql2 support to the agent.
Query streaming in node-mysql now works while using the agent.

Previously, due to the way node-mysql was instrumented query streaming would be forced off when the agent was collecting data. This is no longer the case and query streaming will work and be recorded as expected.

Node.js agent v1.25.4

Wed, 24 Feb 2016 00:00:00 +0000

New features

Added more HTTP request/response parameters to transactions.

The agent now collects additional request/response HTTP headers (e.g. contentType, HTTP method, response status code). These can be used to filter and group errors in the Error analytics page, as well as events in Insights.

Fixes

Fixed an issue with collecting errors when an Express error handler removed message and stack properties from the error object.

Node.js agent v1.25.5

Wed, 09 Mar 2016 00:00:00 +0000

Fixes

Added instrumentation of Bluebird promises.

Previously, the transaction state could get lost when multiple promises resolved close to each other.
Fixed issue with PostgreSQL native instrumentation.

Previously, calling require('pg').native more than once was causing the agent to crash.
Fixed issue with hapi instrumentation not returning value from Server.connection().
Various improvements to tests to make them more stable.

Node.js agent v1.26.0

Wed, 23 Mar 2016 00:00:00 +0000

Notes

Express instrumentation has been fundamentally reworked.

This refactor includes a few bug fixes around error handling and transaction naming, as well as optional higher resolution traces.

Setting feature_flag.express_segments to true in the agent config will make the agent report the amount of time spent in each individual middleware per request

Fixes

The agent will not report errors handled in an error handler it is monitoring - this is more in line with how the agent does error handling in other contexts.

The agent will now name transactions correctly when an application responds from a middleware.

Node.js agent v1.26.2

Thu, 07 Apr 2016 00:00:00 +0000

New features

Added ioredis instrumentation.

Big thanks to Guilherme Souza (@guilhermef) for the contribution!
Added a new shutdown call to the public API.

Thanks to @echmykhun for the contribution!

The new shutdown API call will gracefully stop the agent. It can optionally harvest any pending data waiting to be sent to the New Relic servers before shutting down.

To read more about this new API, please read our README, or visit our docs page.
Added support for truncated segment notifiers.

Segments related to work that happens after a transaction has finished will now be labeled as Truncated in the UI.

Bug fixes

Fixed an issue in the express instrumentation related to inactive/lost transaction state.

Thanks to Jacob Page (@DullReferenceException) for submitting this fix.

Previously, the agent would crash if there was no active transaction when an Express middleware would handle the request.

Improvements

The agent now uses MongoDB's APM API for its instrumentation.

Method discovery for instrumentation is now done through MongoDB's APM API in newer versions of the MongoDB driver.

Node.js agent v1.26.1

Thu, 31 Mar 2016 00:00:00 +0000

New features

Added capturing errors from the unhandledRejection global event.

If a promise is rejected with an error, and the error is not handled, the error will now be reported to New Relic.

Bug fixes

Fixed issue with attaching an event handler every time Express was required.
Fixed issue with chained promises losing context.

Previously the transaction state was getting lost when an error was thrown early in a promise chain.
Fixed issue with the agent crashing when an http Server did not have the address() getter.
Fixed issue with Express instrumentation when a wrapped layer object was missing a method.

Improvements

Added more logging around the CAT feature.

Node.js agent v1.27.0

Thu, 21 Apr 2016 00:00:00 +0000

Notes

This release has been unpublished from npmjs.org. Use version 1.27.1 or higher.

New Features

Reworked promise instrumentation to be more reliable and reusable.

Promise instrumentation has been rewritten to be applicable to any A+ compliant promise library. This change brings more consistent instrumentation of Bluebird promises.

This change also allows users to see the execution order of chained promises in their Transaction Traces. This is an opt-in process and can be achieved by setting feature_flag.promise_segments to true in the agent config.

Bug fixes

The agent now properly checks for custom SSL certificates.

The check previously was falsely positive if there was an empty list of custom certificates. This caused red herrings to be admitted into the debug logs. Thanks to Seth Shober (@sethshober) for the fix!
Promise error handling is now more consistent.

Previously the agent would notice errors being emitted on unhandledRejection regardless of other listeners. Errors coming in on the unhandledRejection event will not be recorded if there are handlers for the event - this is more in line with our error handling practices in other instrumentations.

Improvements

Added a .npmignore file to exclude non-essential files.

The agent will now omit tests and examples on install from npm, drastically improving download times. Thanks to Serge Havas (@Sinewyk) for the contribution!
Logging has been reworked to reduce CPU overhead.

The check to see if a logging call was valid happened fairly late in the logic, causing unnecessary work to be done regardless of logger state. This has been rectified, netting a large decrease in CPU overhead.

Node.js agent v1.27.1

Tue, 03 May 2016 00:00:00 +0000

Bug fixes

Fixed issue with checking listener count for uncaughtException and unhandledRejection global events.
Fixed a number of issues with promise instrumentation of Bluebird.

Node.js agent v1.27.2

Thu, 05 May 2016 00:00:00 +0000

Bug fixes

Fixed duplicated external transactions for https requests in Node > 0.10.

Any external transaction that used the https module to make the request would appear twice in transaction traces due to https.request internally using http.request. This has now been resolved.
Updated eslint dev dependency to 2.9.0 (was 0.24.1).
Fixed an issue with transaction naming precedence.

Custom naming of transactions will no longer be replaced by names generated by the instrumentation.
Fixed tests which broke under Node 6.0.

Node 6.0.0 changed some messaging and internal functionality which our tests were asserting on. These tests have been updated to work with either the new version or the older ones.
Fixed installing GCC 5 in Travis for testing native modules in Node >= 3.0.

Starting in Node 3.0, native modules were compiled with C++11 features enabled. The version of GCC preinstalled on Travis was too old to support that so we now manually install GCC 5 and set it as the system compiler.
Fixed metrics that were being scoped to themselves.

Some metrics were scoped to themselves, causing a strange visual glitch in the New Relic UI. This self-scoping has been removed.
Added tests for transaction naming with parallel requests in Express.

Node.js agent v1.28.0

Wed, 25 May 2016 00:00:00 +0000

New features

Express middleware metrics are now enabled by default.

Improvements

The following attributes are now sent to Insights along with transaction events: externalDuration, externalCallCount, and queueDuration.
Custom SSL certificates (from the agent configuration) are now used even when a proxy is not explicitly defined. This is useful in some environments that use an implicit proxy for all network traffic.

Node.js agent v1.28.1

Wed, 15 Jun 2016 00:00:00 +0000

Improvements

The following attributes are now sent to Insights along with transaction events: databaseDuration, databaseCallCount.
Updated Redis instrumentation to work with version 2.x of the redis module.
Improvements to error tracking on systems that have a lot of errors.
Minor improvements in tests and logging.

Bug fixes

Fixed a few issues with the Express instrumentation.

Middleware functions mounted with a path variable now generate the correct middleware metrics. Routers mounted using route methods now generate the correct trace segments and times. Routers mounted on root path are now not included in trace when they contain no matching routes.

Node.js agent v1.28.2

Thu, 07 Jul 2016 00:00:00 +0000

Improvements

Director instrumentation that will now name the transaction correctly, as well as create segments corresponding to the handlers registered with director.
Transaction naming refactor - this should clear up some inconsistent naming issues in our router instrumentations.

Previously the instrumentation was tasked with the maintenance of the transaction state name, now this has been abstracted into its own class to be used by instrumentations.
Express instrumentation refactored to scope transaction storage to the incoming request object.

Previously the express instrumentation used a stack to track which router was expecting middleware to finish and keep track of which transaction is being executed. The new implementation has a stronger guarantee on scoping work to the correct transaction.

Bug fixes

The agent now uses the correct units (was seconds, now milliseconds) for slow queries - this fixes and issue where query traces in the databases tab were slower than the reported maximum.

Node.js agent v1.28.3

Thu, 14 Jul 2016 00:00:00 +0000

Improvements

Improved agent startup speed by '~'10% by simplifying environment checks.

Removed prolific fs.exists and fs.stat checks, instead simply handling the error for mis-used files which greatly reduces disk access.
Added slightly more trace-level logging around the creation of segments.
Added examples for using the newrelic.createBackgroundTransaction method in a number of different use cases.

Bug fixes

Removed excessive segment creation from PG instrumentation.

For queries with many results we would create a segment for each result. This would result in excessive object allocation and then cause harsh GC thrashing.
Fixed a bug in agent connect that could cause an identity crisis under specific use cases.

When using the agent with multiple app names, transaction information could be misattributed to other services if they share the same first app name. This resolves that by using all of the host names to uniquely identify the agent.

Node.js agent v1.29.0

Thu, 14 Jul 2016 00:00:00 +0000

Improvements

Domain error handlers will now be scoped to the transaction the error occurred in.

Previously, the 'error' event handlers would not be scoped to a transaction causing our API methods to not associate data correctly (e.g. using noticeError would not associate the error with the transaction and would instead be unscoped).

Bug fixes

Reworked the SQL parser to handle new lines in the query.

Previously the agent would have difficulty classifying queries with new lines in them. Thanks to Libin Lu (@evollu) for the fix!
Postgres instrumentation is now compatible with inputs with text getter attributes.

Thanks again to Libin Lu (@evollu) for the fix!

Node.js agent v13.0.0

Wed, 23 Jul 2025 00:00:00 +0000

Notes

⚠ BREAKING CHANGES

This version of the Node.js agent is a SemVer MAJOR update and contains the following breaking changes. MAJOR versions may drop support for language runtimes that have reached End-of-Life according to the maintainer. Additionally, MAJOR versions may drop support for and remove certain instrumentation. For more details on these changes please see the migration guide.

Dropped support for Node.js 18
Updated min supported version for fastify to 3.0.0, pino to 8.0.0, and koa-router to 12.0.0

Features

Dropped support for Node.js 18 (#3097) (cb7c080)
Updated min supported version for fastify, pino, and koa-router (#3108) (ae9e21d)

Documentation

Updated AI Monitoring compatibility docs with new AWS Bedrock APIs (#3230) (e1ff0d3)
Updated compatibility report (#3237) (dc85e4e)

Tests

Fixed assertSegments to insert all expected segments (#3239) (de183fb)
Updated tests to mock outgoing calls to avoid issues in CI (#3234) (66694c6)

Continuous integration

Updated prepare release to exclude semver major copy for repos other than node-newrelic (#3242) (82d9689)
Updated release prep to add copy around breaking changes (#3199) (ca1131c)

Support statement:

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

Node.js agent v13.1.0

Wed, 13 Aug 2025 00:00:00 +0000

Notes

Features

Added support for OTEL logs API (#3228) (19a9c78)
Added supportability metrics when instrumentation has been disabled for a package (#3252) (6098a5b)
Disabled timers instrumentation by default in the sample configuration (#3253) (72eb8d4)

Bug fixes

Fixed transaction.url obfuscation (#3280) (dc09492)

Code refactoring

Updated http-outbound to parse url only once (#3270) (5bb0f8d)

Documentation

Updated distributed tracing example target to use the correct repo (#3254) (1fb3859)
Updated compatibility report (#3299) (8b85342)
Updated compatibility report (#3267) (2712c94)
Updated compatibility report (#3265) (daedadd)
Updated compatibility report (#3261) (bd7d3fa)
Updated compatibility report (#3246) (c289fb5)
Updated compatibility report (#3241) (64529e1)

Miscellaneous chores

Added guardrail for OTEL bridge (#3283) (ff71865)
Refactored API bootstrapping (#3281) (97be8f6)

Tests

Cleaned up engines and version ranges in versioned tests (#3260) (c7fd60e)
Fixed failing http benchmark test (#3258) (7e8cd48)
Fixed a failing span-event benchmark test (#3255) (05b955f)
Fixed CI issues with latest 24 (#3277) (960d169)
Fixed tests that assumed timers instrumentation was always enabled (#3257) (40cfda1)
Forced install of peer deps on nestjs test app (#3269) (4e454ff)

Continuous integration

Updated CI to fail if benchmark tests fail (#3256) (a6a7a15)
Added sending benchmark metrics to NR One (#3285) (7fc8e40)

Support statement:

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

Node.js agent v13.10.0

Tue, 20 Jan 2026 00:00:00 +0000

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:

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

Node.js agent v13.11.0

Thu, 29 Jan 2026 00:00:00 +0000

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:

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

Node.js agent v13.12.0

Mon, 02 Feb 2026 00:00:00 +0000

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:

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

Node.js agent v13.13.0

Tue, 17 Feb 2026 00:00:00 +0000

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:

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

Node.js agent v13.14.0

Tue, 24 Feb 2026 00:00:00 +0000

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:

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

Node.js agent v13.15.0

Mon, 09 Mar 2026 00:00:00 +0000

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:

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

Node.js agent v13.16.0

Wed, 11 Mar 2026 00:00:00 +0000

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:

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

Node.js agent v13.17.0

Thu, 19 Mar 2026 00:00:00 +0000

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:

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

Node.js agent v13.18.0

Mon, 30 Mar 2026 00:00:00 +0000

Notes

Features

Instrumented grpc server stream to bind async context to stream event handlers (#3855) (92c70a8)

Code refactoring

Refactored when instrumentation to subscribe to events emitted (#3866) (1b55c5a)
Refactored memcached instrumentation to subscribe to events emitted (#3849) (915b320)
Refactored bluebird instrumentation to subscribe to events emitted (#3858) (e3d84c2)
Refactored q instrumentation to subscribe to events emitted (#3853) (9fdb0b8)
Refactored grpc-js client instrumentation to subscriber type (#3856) (057fca2)
Refactored grpc-js server instrumentation to subscriber type (#3805) (ca3010a)
Updated @langchain/core subscribers to properly instrument the tool class methods (#3850) (2d17eed)

Documentation

Updated compatibility report (#3831) (9156a6a)

Miscellaneous chores

Added subscriber packages to load-externals (#3868) (83adcc4)

Tests

Removed unused context manager feature flag for running versioned tests (#3851) (15c9757)
Updated core tracing cross agent tests (#3860) (08e4570)
Fixed issue with span links test (#3863) (23a8594)
Removed segment duration timing threshold in memcached tests (#3869) (bd24410)

Support statement:

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

Node.js agent v13.19.1

Wed, 15 Apr 2026 00:00:00 +0000

Notes

Bug fixes

Fixed detecting AWS SDK message attributes presence (#3903) (e81dc61)

Tests

Updated minAgentVersion for Anthropic versioned tests (#3900) (e1f6c32)
Reorganized the test utilities in AWS versioned tests (#3895) (3025571)

Support statement:

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

Node.js agent v13.19.0

Mon, 13 Apr 2026 00:00:00 +0000

Notes

Features

Added instrumentation support for @anthropic-ai/sdk (#3881) (e8713bb)
Updated OTel DB attributes to stable names from semantic conventions 1.40.0 (#3826) (6d3000d)
Added distributed tracing propagation to SNS (#3893) (8fc1144)

Code refactoring

Refactor @aws-sdk v3 instrumentation to subscribe to events emitted
- Added @aws-sdk/smithy-client subscriber (#3877) (0e350fc)
- Added @smithy/smithy-client send subscriber with AWS Bedrock Middleware (#3864) (5e0a6d1)
- Moved generic AWS Client middleware to subscriber (#3889) (3cb1e1b)
- Updated aws-sdk/dynamodb instrumentation to a subscriber middleware (#3891) (ff677a2)
- Updated aws sdk v3 instrumentation to split out bedrock utilities from actual wrapped middleware (#3883) (eed340e)
- Updated Lambda instrumentation to a subscriber middleware (#3890) (12f8284)
- Refactored SNS instrumentation to subscriber type (#3876) (b9f3326)
- Refactored SQS instrumentation to subscriber type (#3880) (de46dee)
Refactored LlmErrorMessage to use vendor-specific subclasses (#3882) (5b0fd2b)
Refactored amqplib to use message broker constants (#3879) (77621fb)

Documentation

Updated compatibility report (#3874) (ae887c4)

Miscellaneous chores

Updated @apm-js-collab/tracing-hooks to 0.6.0 (#3884) (f6ef470)
Updated Undici tests to cover version 8 (#3896) (f27e75f)

Support statement:

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

Node.js agent v13.19.2

Mon, 20 Apr 2026 00:00:00 +0000

Notes

Bug fixes

Fixed child_process instrumentation to avoid leaking event handlers subscribed to once (#3907) (ad0b1f6)

Documentation

Updated compatibility report (#3897) (0ed2202)

Support statement:

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

Node.js agent v13.2.0

Wed, 20 Aug 2025 00:00:00 +0000

Notes

Features

Added ability to register Supportability/Features/Instrumentation/OnRequire/<pkg> metrics for subscriber based instrumentation (#3312) (87bfa40)
Added esm loader hook and commonjs patch to work with orchestrion-js (#3312) (415aeba)
Added instrumentation for @modelcontextprotocol/sdk client calls client.callTool, client.readResource, and client.getPrompt (#3312) (5d9790b)

Bug fixes

Fixed logic around detecting OTEL packages (#3326) (4df30e5)
Updated shimmer.setupSubscribers to properly setup and skip subscribers that are disabled (#3312) (cf5b3ec)

Code refactoring

Added ability to disable subscribers via config.instrumentation.<pkg-name>.enabled (#3312) (55f8fe7)
Added ability to prevent creation of segments in subscriber based instrumentation when parent is marked as internal and of the same package (#3322) (91f91c2)
Removed id parameter from opensearch class (#3312) (8be00ce)
Updated opensearch instrumentation to subscribe to events emitted (#3312) (9a27a5d)
Updated elasticsearch instrumentation to subscribe to events emitted (#3312) (a3e2348)
Updated ioredis instrumentation to subscribe to events emitted (#3312) (90b97d2)
Updated pino instrumentation to subscribe to events emitted (#3312) (28bbe9f)
Updated subscribers to have a common createSegment that creates, assigns attributes, starts segment (#3317) (aa3f8d9)
Updated undici instrumentation to remove its reliance on shim. Also updated storing the relevant segments on context instead of symbols on the request object (#3312) (ec17fa7)

Documentation

Updated compatibility report (#3313) (749ddc9) (#3304) (cc000a7)

Miscellaneous chores

change from ending segment to touching for feature parity with shim (#3312) (4d39fc5)
Updated eslint configuration (#3296) (5c168a6)

Tests

Fixed obtaining opensearch package version for older versions we instrument (#3314) (e45ab27)
Removed unnecessary prisma.$use in tests to unpin (#3303) (db20324)

Continuous integration

Allow users to run benchmark tests even if not sending metrics (#3307) (1be1514)
Change benchmark tests to use TEST_LICENSE (#3325) (1f7f733)

Support statement:

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

Node.js agent v13.2.1

Thu, 21 Aug 2025 00:00:00 +0000

Notes

Code refactoring

Updated agent to use @apm-js-collab/tracing-hooks for the CJS/ESM registration for tracing channel based instrumentation (#3324) (4b2c14f)

Documentation

Updated compatibility report (#3330) (2831a89)

Support statement:

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

Node.js agent v13.3.1

Tue, 09 Sep 2025 00:00:00 +0000

Notes

Bug fixes

Default requestParameters to an object to avoid crash in transaction.addRequestParameters (#3361) (ecd0d1d)

Support statement:

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

Node.js agent v13.3.0

Mon, 08 Sep 2025 00:00:00 +0000

Notes

Features

Added MCP StreamableHTTPClientTransport support (#3337) (7189a35)

Code refactoring

Removed instances of url.parse. Streamlined how http instrumentation creates relevant attributes. (#3340) (1fc1e1a)
Updated openai instrumentation to subscribe to events emitted (#3331) (04dd677)

Documentation

Updated compatibility report (#3344) (e422919)

Miscellaneous chores

Refactored OTEL bridge signals setup (#3244) (ec8edef)

Tests

Added more cassandra-driver tests (#3323) (d2e9d10)
Fixed long running benchmark test and add shimmer.subscribers benchmark test (#3349) (15253c0)
Fixed langchain openai streaming tests by explicitly passing streaming: true to chat model (#3346) (4f12499)
Fixed openai test after migration to tracing channel (#3336) (0d01e29)
Hardened batch-span-streamer.test.js to avoid random failures in CI (#3338) (2077ce3)

Continuous integration

Set benchmark host default to staging (#3332) (55f6b8d)
Updated the redis container to use the official redis image as bitnami/redis is moving and no reason to use a 3rd party image (#3342) (8ffb393)

Support statement:

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

Node.js agent v13.3.2

Wed, 10 Sep 2025 00:00:00 +0000

Notes

Bug fixes

Added defensive code for obtaining protocol in outbound http calls (#3367) (ecda4e8)

Code refactoring

Benchmark test names (#3357) (229ff0d)

Documentation

Updated compatibility report (#3351) (cf9f95d)

Continuous integration

Benchmark tests run on push on main (#3359) (c0f81c3)
Changed NUGET_SOURCE workflow to variable (#3364) (10692db)
Fix benchmark workflow (#3365) (7da99b5)
Updated the GH_RELEASE_TOKEN to point to our bot user PAT instead of python agent (#3363) (06eb5c1)

Support statement:

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

Node.js agent v13.4.0

Mon, 29 Sep 2025 00:00:00 +0000

Notes

Code refactoring

Update amqplib instrumentation to subscribe to events emitted (#3377) (fecbb08)
Updated cassandra-driver instrumentation to subscribe to events emitted. (#3372) (bb87cd8)

Documentation

Updated compatibility report (#3385) (b79be72)

Miscellaneous chores

Updated @apm-js-collab/tracing-hooks to latest to take advantage of wasm optimizations (#3398) (cda56cc)

Styles

Require jsdoc/valid-types and jsdoc/check-param-names (#3368) (5d1b1d9)
Require jsdoc require-param-description and require-param-type (#3391) (3785d0c)

Support statement:

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

Node.js agent v13.3.3

Mon, 22 Sep 2025 00:00:00 +0000

Notes

Features

Added support for tracing callback on subscribers (#3371) (e6ad52e)

Bug fixes

Updated openai instrumentation to properly return APIPromise to avoid crashing when using completions.parse or responses.parse (#3382) (c7ccf26)

Documentation

Updated compatibility report (#3370) (754c2f0)

Miscellaneous chores

Removed unused loader.mjs (#3376) (66a9fd5)
Updated metrics for OTel Bridge enablement/disablement (#3381) (b976c37)
Updated supportability metric names for OTel Bridge enablement… (#3383) (c7c1d6c)

Support statement:

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

Node.js agent v13.5.0

Tue, 14 Oct 2025 00:00:00 +0000

Notes

Code refactoring

Updated fastify instrumentation to subscribe to events emitted (#3407) (51e361e)
Updated pg and pg-native instrumentation to subscribe to events emitted (#3397) (04af258)
Updated config.instrumentation.timers.enabled to false to disable timers.setTimeout and timers.setInterval by default. (#3414) (b925d3d)
- To re-enable, set config.instrumentation.timers.enabled to true in config or set NEW_RELIC_INSTRUMENTATION_TIMERS_ENABLED=true

Documentation

Updated compatibility report (#3413) (fef98dd)

Miscellaneous chores

Added a new diagnostics base class and migrated undici to use new class (#3408) (8047bf1)
Created directory for samplers (#3419) (dd2d3df)

Styles

Require check-types and require-returns-type jsdoc (#3400) (e4cd687)
Require jsdoc check*, implements-on-classes, and some no-undefined-types (#3404) (4fa645b)
Require jsdoc require-returns-check and require-property-* (#3403) (1008073)

Tests

Added helper to get version of package when package.json not exported, and updated tests that need it (#3411) (5ae02c7)
Fixed fastify segment tree assertion when security agent is enabled (#3422) (b2cf6ed)
Refactored mcp tests to listen on new port for every streaming test, removed unncessary shutdown of process (#3420) (17db813)
Updated an openai assertion with setTimeout disabled (#3421) (ceec8f9)

Support statement:

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

Node.js agent v13.6.0

Mon, 27 Oct 2025 00:00:00 +0000

Notes

Features

Added instrumentation for http2 client methods (#3284) (bda7aea)

Bug fixes

Updated ioredis instrumentation to handle breakage of errors when using .pipeline. (#3457) (49f4d93)
Updated openai instrumentStream function to handle empty chunk when include_usage is set (#3427) (f804940)

Code refactoring

Update express instrumentation to subscribe to events emitted (#3424) (bbf3d01)
Updated instances in instrumentation of Array.forEach for a more performant for...of or for index loop (#3463) (99484ce)
Updated instances of Array.forEach for a more performant for...of or for index loop (#3440) (48c37bf)
Updated token calculation for aws-bedrock LLM Events (#3445) (9450181)
Updated token calculation for google-genai LLM Events (#3431) (41d32be)
Updated token calculation for openai LLM Events (#3430) (b8678cc)

Documentation

Updated compatibility report (#3459) (f253b97)

Miscellaneous chores

Update release workflows (#3444) (d1ec158)

Tests

Added a randomString helper to agent_helper and use it in ioredis to avoid flappy tests, also updated local instances of random strings in kafka, elasticsearch and opensearch tests (#3462) (4deb6d8)
Fixed conflict between ioredis and ioredis-esm by running flushdb instead of flushall to avoid index getting removed mid test (#3464) (5e3f0a8)
Fixed express async error test to purposely misspell a method to emit a crash (#3435) (ff9f064)
Moved aws-sdk-v3 common.js requirement of semver (#3461) (6a380ef)
Pinned Next.js tests to <16.0.0 (#3446) (10787a1)
Updated minimum tested version of @langchain/core to 1.0.0 (#3437) (b61f67a)

Support statement:

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

Node.js agent v13.6.1

Tue, 28 Oct 2025 00:00:00 +0000

Notes

Bug fixes

Updated middleware wrapper to not wrap handler if it is not a function (#3469) (c702689)

Documentation

Updated compatibility report (#3466) (5853657)

Support statement:

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

Node.js agent v13.6.2

Wed, 29 Oct 2025 00:00:00 +0000

Notes

Bug fixes

Updated express instrumentation to properly instrument an array of middleware defined on a route (#3473) (e383c4e)

Documentation

documented how to use the subscriber based instrumentation (#3432) (3b3ab72)
Updated compatibility report (#3471) (964543b)

Support statement:

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

Node.js agent v13.6.3

Tue, 11 Nov 2025 00:00:00 +0000

Notes

Bug fixes

Updated @google/genai to properly handle assigning token counts to LlmCompletionSummary message (#3495) (f805d38)
Updated AWS Bedrock instrumentation to properly assign token counts (#3491) (b1687f6)
Updated openai instrumentation to properly handle streaming when stream_options.include_usage is set (#3494) (37c43f5)

Code refactoring

Update mysql and mysql2 instrumentation to subscribe to events emitted (#3423) (2e38914)

Documentation

Cleaned up README links and outdated verbiage (#3484) (51e6d7a)
Updated compatibility report (#3477) (859f27f)

Support statement:

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

Node.js agent v13.6.4

Thu, 13 Nov 2025 00:00:00 +0000

Notes

Bug fixes

Updated MessageConsumerSubscriber to end transaction created for a given message consumption (#3503) (ba30818)
Updated MessageProducerSubscriber to properly set the sampled flag on traceparent (#3505) (0b1a9a8)
Updated the bedrock middleware to be registered with a high priority to ensure payload is properly deserialized (#3500) (63e531b)

Support statement:

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

Node.js agent v13.6.6

Wed, 19 Nov 2025 00:00:00 +0000

Notes

Bug fixes

Updated app.use or router.use Express instrumentation to properly wrap all middleware defined (#3520) (d3b20d0)

Documentation

Updated compatibility report (#3522) (72ec652) (#3516) (35defb0)

Tests

Pinned next.js to skip 11.0.10 and 11.0.11 (#3521) (20977ee)

Support statement:

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

Node.js agent v13.6.5

Mon, 17 Nov 2025 00:00:00 +0000

Notes

Bug fixes

Updated express instrumentation to ignore error when the next handler passes route or router (#3513) (724b218)
Updated MessageConsumerSubscriber to wait for consumer callback to end when it is a promise (#3510) (45667a0)

Documentation

Updated compatibility report (#3498) (ef41b38)

Tests

Updated aws sdk v3 s3 test to no longer test DeleteBucketCommand (#3512) (df27448)

Support statement:

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

Node.js agent v13.7.0

Mon, 08 Dec 2025 00:00:00 +0000

Notes

Features

Updated koa instrumentation to properly wrap Router when using @koa/router@15.0.0+ (#3550) (f1e08ad)
Added ability to configure a ratio based sampler (#3501) (f300bd5)
- To assign a ratio based sampler, set config.distributed_tracing.sampler.root, config.distributed_tracing.sampler.remote_parent_sampled, or config.distributed_tracing.sampler.remote_parent_not_sampled to { trace_id_ratio_based: { ratio: <float between 0 and 1> }}
- To assign via environment variables set NEW_RELIC_DISTRIBUTED_TRACING_SAMPLER_<TYPE>='trace_id_ratio_based' and NEW_RELIC_DISTRIBUTED_TRACING_SAMPLER_<TYPE>_RATIO=<float between 0 and 1> where <TYPE> is one of ROOT, REMOTE_PARENT_SAMPLED, or REMOTE_PARENT_NOT_SAMPLED
Updated configuration to allow adaptive.sampling_target to be set for config.distributed_tracing.sampler.root, config.distributed_tracing.sampler.remote_parent_sampled, and config.distributed_tracing.sampler.remote_parent_not_sampled (#3532) (44f51dd)
Added support for OTEL span links (#3528) (e840690)
Replaced default with adaptive as the default for samplers (#3543) (3f03162)
Preliminary support for partial granularity traces (Not available for production use)
- Added essential type for partial granularity traces (#3547) (3d85fb5)
- Added reduced type for partial granularity traces. (#3540) (cfa8f41)
- Added partial granularity samplers and assign transactions with isPartialTrace when partial granularity sampling decisions have been made (#3544) (1535a82)
- Refactored samplers into classes and store them on agent.sampler.* (#3527) (ad63441)
- Updated Samplers class to normalize logger messages, short circuit when applicable and remove optional chaining checks (#3546) (4f7684c)
- Updated samplers to assign priority between 0-1 when DT is disabled or both full and partial granularity are disabled (#3559) (7a1c37e)
- Updated transaction to store partial granularity indicator as .partialType (#3561) (a7f20d8)
- Updated when partial granularity rules are applied (#3553) (a4bdf4f)
- Added toString and get [Symbol.toStringTag]() to default Sampler class (#3562) (771168d)

Bug fixes

Fixed normalization of OTEL hrtime (#3564) (707fe7d)

Documentation

Updated compatibility report (#3551) (02268a4)
Added internal doc for attributes (#3539) (68543b6)

Miscellaneous chores

Improved logging around preconnect payload
- Added more logging around assigning hostname during preconnect (#3568) (3ee4d38)
- Improved GCP utilization logging (#3552) (e6c4141)
Utilization resolution is now done concurrently (#3556) (8386360)
Collected OTEL instrumentation scope metadata on all OTEL spans. (#3554) (75703c4)
Improved OTEL hrtime processing (#3557) (8f187b1)
Renamed config opentelemetry_bridge to opentelemetry (#3565) (c9d156f)

Support statement:

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

Node.js agent v13.8.0

Thu, 11 Dec 2025 00:00:00 +0000

Notes

Features

Added support for @langchain/aws (#3563) (56c4a78)
Additional support for partial granularity traces (Not available for production use)
- Added partial granularity tracking metrics (#3566) (061f0fc)
- updated AlwaysOn sampler to set priority to 3 for full trace and 2 for partial trace (#3577) (e7bcff4)
- Updated the span generation process (#3585) (74777d5)

Code refactoring

Converted AWS Bedrock's LlmError to use LlmErrorMessage (#3567) (8b2bb42)
Updated @google/genai instrumentation to subscribe to events emitted (#3467) (e8d9ba1)
Updated bunyan instrumentation to subscribe to events emitted (#3589) (f1e5f12)

Documentation

Updated compatibility report (#3592) (7455533)

Miscellaneous chores

Refactor span link serialization (#3574) (103044d)

Tests

Moved mock aws bedrock server creation to test/lib/aws-server-stubs/index.js (#3593) (270df81)

Support statement:

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

Node.js agent v13.8.1

Mon, 15 Dec 2025 00:00:00 +0000

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:

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

Node.js agent v13.9.2

Wed, 14 Jan 2026 00:00:00 +0000

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:

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

Node.js agent v13.9.0

Thu, 08 Jan 2026 00:00:00 +0000

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:

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

Node.js agent v1.3.0

Sat, 18 Jan 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Support for Spumko's Hapi! This support works with both Hapi 1.x and 2.0.0, and like our Express and Restify instrumentation will automatically name transactions after Hapi paths (get it) and time how long it takes to render views.
Before, transaction naming and ignoring rules didn't work with Express and Restify routes. This has been addressed and the documentation has been clarified. Much gratitude to everyone who helped us figure out how to get this right, and for dealing with the previous, unclear documentation.
Parameters in the ignored params list weren't being ignored in all cases.
A very annoyingly chatty log message had its priority level dropped several levels.

Node.js agent v13.9.1

Mon, 12 Jan 2026 00:00:00 +0000

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:

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

Node.js agent v1.30.0

Thu, 25 Aug 2016 00:00:00 +0000

New features

A number of improvements and fixes to transaction naming rules.

Added attributes terminate_chain, replace_all, and precedence to allow more control over how naming rules are executed. Please see the updated documentation in our README file.

The order in which naming rules are executed can now be reversed with a feature flag reverse_naming_rules.

When applying naming rules, the regular expression matching is now case insensitive.

We have added a tool for testing naming rules. When the agent is installed, the tool can be run in terminal by executing node node_modules/.bin/newrelic-naming-rules.

We have also improved our trace logging around transaction naming.

Improvements

Added trace logging to track number of transactions and segments in progress, and to better track segments created with the Express instrumentation.
Fixed mysql2 tests that were not being run correctly.

Bug fixes

Fixed issue with reporting errors from domains.

When an error is handled by using the error event of the domain, it is no longer reported as an uncaught exception.

Node.js agent v1.30.2

Tue, 13 Sep 2016 00:00:00 +0000

Notes

This release has been unpublished from npmjs.org. Please use version 1.30.3 or higher.

New features

Added instrumentation of the param() function in Express.

The agent will now create metrics and transaction segments when the Express param() function is called as a part of a route. This also fixes an issue with transaction naming when the HTTP response is ended within a param() method.

Bug fixes

Fixed an issue with naming Express transactions that result in 404 errors.

Previously transactions were not always correctly normalized for URLs that caused 404 errors. The transactions will now always be reported with the same normalized name (e.g. "get /").
Fixed instrumentation of Express v4.0 - v4.5.

Previously transactions were not correctly named on older versions of Express 4.

Improvements

Minor upates to logging.

Node.js agent v1.30.1

Thu, 01 Sep 2016 00:00:00 +0000

Bug fixes

The shutdown method is now on the stub API.

Previously when the agent was disabled the stub API passed back on require did not have the shutdown method. Thanks goes to Vlad Fedosov (@StyleT) for this contribution!
Global timers will now be wrapped correctly regardless of being wrapped by something else.

The logic to check whether to wrap the global timers was looking to see if the global timers were the same function reference as the ones in the timers module. This would break in cases where either the global or timers functions had been wrapped.
Director instrumentation now correctly handles the case of null route handlers being passed in.

Previously the agent's director instrumentation would crash in cases of null route handlers in director.

Node.js agent v1.30.3

Wed, 14 Sep 2016 00:00:00 +0000

Notes

This release is the same as v1.30.2 except it has been published using npm 2 to make sure all nested bundled dependencies are included.

Node.js agent v1.30.4

Tue, 27 Sep 2016 00:00:00 +0000

Improvements

Fixed format of external calls metric.

External service URLs will now be formatted the same as they are in the originating application.
Improved instrumentation of native promises.

Native promises now use the same instrumentation as Bluebird, making instrumentation easier to maintain and more consistent across libraries.

Bug fixes

Fixed issue with reloading normalization rules from the server.

Upon reset, the agent will clear the existing naming rules, removing any vestigial rules that may have changed or been disabled.
Fixed issue with key transactions Apdex metric.

Key transactions now effect the global Apdex metric according to their own ApdexT instead of the default ApdexT value.
Fixed issue with closing transactions when the request is aborted.

Previously, aborted requests would result in the transaction remaining open indefinitely. Now the transaction will be correctly finished and its resources freed.

Node.js agent v1.30.5

Tue, 04 Oct 2016 00:00:00 +0000

Bug fixes

Fixed issue with aborted requests causing the agent to crash in some cases.

Previously the agent would crash when the client request aborted before Express server sent a response and encountered an error.

Improvements

Upgraded integration tests to work with the latest version of node-tap.

Node.js agent v1.3.1

Sat, 01 Feb 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Always cast ignored status codes to numbers so that people using environment-variable configuration or strings in config still get error status ignored properly.
If you disabled server-side configuration, the server was still able to set the value of apdex_t for your app. This was an oversight, and has been corrected.
Before, if you had request renaming rules, if the end result was the same as the match pattern (mapping /path to /path), they would be silently ignored. This has been fixed.
MySQL instrumentation handles callback more consistently, so the transaction tracer doesn't get confused and stop tracking transactions with MySQL calls in them.

Node.js agent v1.31.0

Wed, 12 Oct 2016 00:00:00 +0000

New features

The agent now collects database instance information for PostgreSQL and Redis operations. This information (database server and database name) is displayed in transaction traces and slow query traces.

Node.js agent v1.3.2

Fri, 14 Feb 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Includes a nearly total rewrite of the connection layer that the module uses to communicate with New Relic's servers:

More useful logs! All of the logging has been reviewed closely to maximize its value and usefulness at pretty much every level. In practice, this means that the messages logged at 'info' and higher should only be for things that are relevant to you as a customer, and at 'debug' and 'trace' should be much more useful for us when we help you isolate issues with New Relic in your applications.
See data faster! As part of the connection handshake with New Relic, the module will now send any performance metrics gathered during the startup cycle immediately, instead of waiting a minute for the first full harvest cycle.
Get data to New Relic more reliably! When the module has issues connecting to New Relic, it's more consistent and resilient about holding your performance data for later delivery.
Use less bandwidth! Performance data delivery to New Relic is now sequential instead of simultaneous. This means that the bandwidth used by New Relic will be less bursty, especially on hosts running many instrumented applications (or cluster workers).
Better implementation! There were a number of architectural problems with the old version of the connection layer, which (among other things) made it difficult to test. The new version is simpler, has a much cleaner API, and has many, many more tests.

Node.js agent v1.32.0

Thu, 20 Oct 2016 00:00:00 +0000

New features

The agent now collects database instance information for MySQL and MongoDB operations. This information (database server and database name) is displayed in transaction traces and slow query traces.
Datastore instance configuration can now be done through environment variables. These can be set through NEW_RELIC_DATASTORE_INSTANCE_REPORTING_ENABLED and NEW_RELIC_DATASTORE_DATABASE_NAME_REPORTING_ENABLED

Bug fixes

The agent will no longer crash the process when an express param handler is executed when a transaction is not active.

Node.js agent v1.34.0

Thu, 10 Nov 2016 00:00:00 +0000

New features

The agent now collects CPU metrics when running under Node 6.1.0 and higher.

Node 6.1.0 introduced an API to get CPU time usage of the running Node process. We are now collecting this data as new metrics.
The agent now has a separate configuration for audit logging.

Previously the data that the agent sends to the collector was logged only in trace logging mode, making the logs unnecessarily large and noisy. The agent can now include this data independent of the logging level using separate configuration settings.
A new API method addCustomParameters() has been added to allow adding multiple custom parameters at once. Thanks to Austin Peterson (@AKPWebDesign) for this contribution!

Improvements

Updated tests to run on Node 7.

Node 7 is officially supported as of the previous release, v1.33.0.
The shutdown() API now waits for connection to collect pending data.

When a flag to collect pending data is provided to the shutdown() method, the agent now ensures a connection to the collector has been established. This is useful when the Node process is short-lived, such as in AWS Lambda.
Added running the nsp (Node Security Platform) tool to the test suite to help with detecting security-related vulnerabilities.

Bug fixes

The setIgnoreTransaction() API now works for background transactions.
Fixed issue with synthetic result not displaying a link to the corresponding transaction trace.

Node.js agent v1.33.0

Mon, 31 Oct 2016 00:00:00 +0000

New features

The agent now collects database instance information for Memcached operations.

This information (database server and database name) is displayed in transaction traces and slow query traces.

Improvements

socket.io long-polling requests are now ignored by default.

Collecting metrics for these requests is typically not desirable since they are frequent and do not represent business transactions. Previously we recommended adding an ignore rule manually. Now it is included by default.
Improved test coverage for Postgres and MongoDB instrumentations.

Node.js agent v1.35.0

Mon, 12 Dec 2016 00:00:00 +0000

Notes

This release has been unpublished from npmjs.org. Please use version 1.35.1 or higher.

New features

The agent will now report garbage collection statistics on supported platforms.

On node versions 0.10, 0.12, 4, 6, and 7 the agent will now record the time spent in, the number of, and type of garbage collection cycles. You can read more about it on our docs site!

Bug fixes

The agent no longer double counts MySQL query times when using a connection pool.

Previously, when using a pool of connections a query done through the pool would be recorded as the time it took on the pool, as well as the connection, effectively counting the time twice. This is no longer the case.
The agent will no longer lose transaction state across Bluebird's promise.nodify.

Thanks to Matt Lavin (@mdlavin) for this contribution!

Node.js agent v1.35.1

Tue, 13 Dec 2016 00:00:00 +0000

Bug fixes

Removed automatic installation of @newrelic/native-metrics.

Due to the way npm v3+ flatten dependencies, a bug in the version of npm packaged with Node v5, and npm v1's ungraceful handling of scoped packages we have opted to not automatically install this module.

If you would like to see native metrics for your application, you can add the @newrelic/native-metrics module to your package.json and the Node Agent will automatically pick it up.
Corrected attribution of the Bluebird patch in the last release's notes.

Thanks to Matt Lavin (@mdlavin) for this correction!

Node.js agent v1.35

Wed, 21 Dec 2016 00:00:00 +0000

New Features

Added CPU metric gathering to Node.js versions <6.1

As of this release the agent will attempt to gather CPU usage metrics via the optional @newrelic/native-metrics module.
Added additional memory usage classification metrics.

The agent will now report memory metrics that break down memory by its current use.

For more information on these features, see our documentation.

Node.js agent v1.36.1

Thu, 12 Jan 2017 00:00:00 +0000

Bug fixes

Stop collecting URL parameters from the HTTP referer header

The Node agent collects the request headers during an error trace to help determine the root cause of problems. The referer header is the URI that identifies the address of the webpage that linked to the resource being requested. It is possible that the referer URI may contain sensitive information in the request query parameters. New Relic has found that the query parameters are not properly stripped during the error trace. This update fixes this by stripping the query parameters from the referer in the request header before sending this data to New Relic.

This release fixes New Relic Security Bulletin NR17-01.

Improvements

Improved logging of modules that did not get instrumented.

Node.js agent v1.36.2

Thu, 26 Jan 2017 00:00:00 +0000

Bug fixes

Fixed issue with timing Redis operations when called without a callback.

Previously these operations would continue to be timed until the transaction ended, and as a result reported incorrect times.
Transactions that result in a 404 HTTP error are now named "(not found)".

Previously these transactions were reported with no name (e.g. get /).
When the newrelic.js configuration file is not present, the agent now logs a message to the console and no longer prevents the app from starting up.

Node.js agent v1.37.0

Thu, 09 Feb 2017 00:00:00 +0000

New features

The agent now reports event loop metrics on supported platforms.

The agent will now record the number of event loop ticks per minute and CPU time spent in each tick. This feature requires v2.1.0 or higher of the optional @newrelic/native-metrics module, and is supported on Node versions 0.12, 4, 6, and 7.
You can read more about it on our docs site!

Bug fixes

The agent no longer creates a segment for each row returned from a PG query when the pg-query-stream module is used.
Internal properties used in our promise instrumentation are now non-enumerable to prevent unexpected keys showing up for clients.
Agent now uses safe stringification when encoding payloads in order to prevent an issue with circular references.
Fixed issue with the agent holding the process open when retrying to connect to the collector.

Improvements

Removed io.js from our test suite, since it has not been supported for some time.
Quieted a log message warning users about their own settings.
Fixed typo in a log message. Thanks to Dave Bobak (@davebobak) for the contribution.

Node.js agent v1.37.2

Thu, 16 Feb 2017 00:00:00 +0000

Notes

This release is the same as v1.37.1 except it has been re-published to npm due to an issue with shrinkwrapping the previously published package.

Node.js agent v1.37.1

Thu, 16 Feb 2017 00:00:00 +0000

Notes

This release has been re-published to npm as 1.37.2. Please use version 1.37.2 or higher.

Improvements

Agent now wraps emit on http request/response objects instead of relying on listeners.
Improved documentation for newrelic.noticeError() and ignore_status_codes configuration.

The documentation now makes it clear that errors recorded using noticeError() do not obey the ignore_status_codes configuration value.
Removed unused yakaa dependency.

Bug fixes

Fixed a bug in normalization rules when replacements do not maintain initial /.
Better de-duplication of errors when the same error instance is used multiple times.
Server-side naming rules are now applied even when user defined ones have matched.
Errors reported outside of a transaction now include their stack trace on the error analytics page.
A potential stack overflow in trace serialization has been removed.
Fixed an issue with our Express and domain instrumentation related to a loss of transaction state that could result in incorrect transaction names, traces, and events.
Nested background transactions now report the correct number of metrics.

Node.js agent v1.38.1

Fri, 17 Mar 2017 00:00:00 +0000

Bug fixes

Fixed issue with when.js instrumentation not preserving all properties on wrapped Promise constructor.

Previously, the when.js instrumentation would cause an unhandled exception when private methods on the Promise constructor were called (e.g. when adapting functions that do not use promises).

Node.js agent v1.38.0

Thu, 16 Mar 2017 00:00:00 +0000

Improvements

We're excited to announce the addition of a new Node VMs page to the UI that provides a curated view of the cpu, memory, garbage collection, and event loop metrics that we have added over the past several releases of the node agent and native-metrics module.

For more information, see our documentation.
Added instrumentation of When.js promise library.

Previously, the transaction state could get lost when multiple promises resolved close to each other.
Fixed name of environment variable in error message when configuration file cannot be found. Thanks to @Maubic for the contribution!
Updated tests to work with the latest version of Node 7.

Node.js agent v1.38.2

Thu, 30 Mar 2017 00:00:00 +0000

Bug fixes

When.js hooks similar to Promise.onPotentiallyUnhandledRejection now function as intended.

Previously, hooks like Promise.onPotentiallyUnhandledRejection would not work due to the way the agent wraps the promise constructor. When.js expects these handles to be assigned directly onto the promise constructor, and our wrapper was intercepting the assignment. The wrapper will now properly proxy these values and assign them onto the original constructor, restoring the proper behavior.
Express route parameters will now be properly attached to the corresponding transaction.

Previously, our express instrumentation would read the route parameters and place them on the segment responsible for matching the parameters. This behavior did not place the parameters on the transaction that the segments belonged to, causing the parameters to not show up properly on transaction traces and transaction events.

Node.js agent v1.39.0

Tue, 02 May 2017 00:00:00 +0000

New features

Error messages are redacted in High-security mode now.
New configurations were added for disabling some New Relic API methods. These default to enabled and are all disabled in High-security mode.
- api.custom_parameters_enabled controls newrelic.addCustomParameters()
- api.custom_events_enabled controls newrelic.recordCustomEvent()
- api.notice_error_enabled controls newrelic.noticeError()
Updated the default value for transaction_tracer.record_sql to obfuscated.

This value was previously off by default. This change brings the New Relic Node Agent defaults in line with other New Relic Agents.

Bug fixes

Our when instrumentation better detects when a module is actually when.

Thanks to Pasi Eronen (@pasieronen) for the contribution!
Quiet a warning in our native promise instrumentation on Node 0.10.
Fixed a bug in the generic pool instrumentation affecting version 3.

Node.js agent v1.39.1

Thu, 11 May 2017 00:00:00 +0000

Bug fixes

Fixed a transaction state loss introduced in Node 7.10.0 when using net.createConnection.

Added a new segment for net.connect, net.createConnection, and http.Agent#createConnection. Sockets created within a transaction also have their emit bound to the segment.
Fixed a typo about the name of the default configuration file. Thanks Jacob LeGrone (@jlegrone)!

Node.js agent v1.4.0

Fri, 14 Mar 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Browser monitoring! Real User Monitoring! Which is also known as RUM! Whatever it's called, it allows you to see how long your pages take to load, not just on the server side, but in the browser! Wow! It's super cool! We know a lot of you have been waiting for this, and it's here! It's manually set up with an API call! Check the README for details!
By default, all communication between New Relic for Node and New Relic's servers is now protected with crisp, clean TLS encryption. To minimize the CPU overhead of running connections over SSL (and it can be configured, see the README and the online documentation for details on how to return to plain HTTP), New Relic for Node is now using a keep-alive connection that will properly pipeline connections, for both HTTP and HTTPS.
Improved the timings for a large class of MongoDB / Mongoose use cases. If you've encountered the issue where MongoDB trace segments last for an absurdly long duration, this should help.

Node.js agent v1.40.0

Wed, 07 Jun 2017 00:00:00 +0000

New features

Node v8 is officially supported with the exception of async/await.

Support for the new async/await keywords is coming in a future release. Until this support is added, New Relic does not support and highly discourages using the Node.js agent with applications that utilize async/await, as it could result in transaction state loss and data being mixed between transactions.

Fixes

Fixed issues related to changes in the core networking modules that resulted in transaction state loss. Also instrumented new asynchronous API methods in crypto and inspector.

Node.js agent v1.5.0

Fri, 11 Apr 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Add high-security compliance for accounts with enterprise security enabled. By default, the agent now works with high-security accounts, whereas previously agents would receive an Access Violation.
Add a .addCustomParameter(name, value) api call for adding custom parameters to transaction traces, and extend the .noticeError(error, customParameters) for adding additional parameters to error traces.
Documentation fix in the README.md for ignoring socket.io routes.
Better support for disabling browser timing headers server side. Previously the agent would not pick up the server change until restart. The agent will now disable browser timing headers as soon as the next harvest cycle.
Fix a socket hangup error that was causing some agents to fail to handshake with the New Relic servers.

Node.js agent v1.5.1

Fri, 18 Apr 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Upgrade continuation-local-storage dependency to 3.0.0. The newrelic node module uses cls to help join asynchronous transaction segments. The latest cls module includes a fix that prevents contexts from leaking across transactions.

Node.js agent v1.5.2

Thu, 24 Apr 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Fix issue where dangling symbolic links in the node_modules folder would crash the environment scraper.

Node.js agent v1.5.4

Thu, 08 May 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

On connect, the full newrelic module configuration is pushed to New Relic APM. Full config will be visible under the Agent initialization tab, under the Settings button in the APM application page.

The reported settings will reflect the running agent config, which may differ from the newrelic.js file depending on server-side, and environmental configuration.

Node.js agent v1.5.3

Thu, 01 May 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Express 4 support.

Express 4 apps now have their transactions named correctly. Errors in the middleware chain are properly recorded.

Node.js agent v1.6.0

Thu, 22 May 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

New Relic Insights support no longer requires a feature flag. If you are a paying customer, you'll begin to see data show up in Insights as soon as you upgrade to 1.6.0. The agent will send event data for every transaction up to 10,000 per minute. After that events are statistically sampled. Event data includes transaction timing, transaction name, and any custom parameters. You can read what is sent in more detail here.

You can read more about Insights here. Documentation for configuring this feature can be found here.

Node.js agent v1.5.5

Thu, 15 May 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Fix a bug where if the user disabled the error collector, error count would be carried over harvest cycles instead of reset. This would result in an ever increasing error count until the app was restarted.
New Relic Insights beta support. This is a feature for our paying customers. The support of Insights in the agent is beta, this means we don't recommend turning the feature on in production, but instead trying it out in development and staging environments.

To enable Insights support add the following to your newrelic.js:
```
feature_flag : {
insights: true
}
```

Node.js agent v1.7.0

Thu, 29 May 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Client side setting of high_security is now supported.

High-security mode is a feature to prevent any sensitive data from being sent to New Relic. The local setting for the agent must match the server setting in the New Relic APM UI. If there is a mismatch, the agent will log a message and act as if it is disabled. A link to the docs for High-security mode can be found here

Attributes of high-security mode (when enabled):
- requires ssl
- does not allow capturing of parameters,
- does not allow custom parameters
The default setting for High-security mode is ‘false’.

Note: If you currently have high-security mode enabled within the New Relic APM UI, you have to add high_security: true to your local newrelic.js.
Fixed a bug in our instrumentation of restify, where if you were using the restify client with express as a web server, req.query would be overridden.

Node.js agent v1.7.2

Fri, 13 Jun 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Captured parameters for express, restify, and hapi have been normalized.

When capture_params is enabled the agent will collect route and query parameters. Previously express and restify only captured route params, and hapi only captured query params. This normalizes the behavior across the frameworks.
Fixed an issue with restify instrumentation that caused the agent to always collect route parameters.

Users of restify who want to continue capturing route (and now query) parameters are advised to enable capture_params.
Fixed an issue where circular configs caused the agent to crash.

Node.js agent v1.7.1

Thu, 05 Jun 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Fixed an issue where collected errors did not include captured and custom parameters.
Added the environment variable NEW_RELIC_HIGH_SECURITY. This correlates to the high_security setting in your newrelic.js for High-security mode.

Node.js agent v1.7.5

Wed, 02 Jul 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Plain http routes (i.e. routes outside of a framework) now apply config naming rules early. See rules for naming and ignoring requests.

This fixes a bug where generating the Browser Timing Header would not work without a framework (i.e. express, restify, hapi).
Beta support for connecting to newrelic via ssl through a proxy.

Node.js agent v1.7.3

Fri, 20 Jun 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Support for instrumenting a standalone express 4 router. See issue 154.
Set the default log level to info.

Node.js agent v1.7.4

Thu, 26 Jun 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

The agent now reports the value of the NODE_ENV environment variable to New Relic.

This will show up in your Settings -> Environment tab in APM. The data is being collected for debugging and to aid support.

Node.js agent v1.8.0

Fri, 11 Jul 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

General release of proxy support for the agent to connect to New Relic.
- HTTP/HTTPS support from the newrelic module to the proxy
- HTTP/HTTPS support from the newrelic module to New Relic.
- Basic proxy authentication.
- Allow custom certificates during TLS negotiation.
- For more information, read our docs here
Fix for enabling High-security mode via an environment variable
Optimization to allow early garbage collection of TLS slab buffers.

Node.js agent v1.8.1

Fri, 18 Jul 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Notes

Agent now tracks metrics for router queue time. In addition to X-REQUEST-START, the agent now supports X-QUEUE-START header times. This metric will show up as "Request Queueing" in the Overview tab.

Node.js agent v1.9.1

Wed, 30 Jul 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Added a check for invalid characters in the app_name setting.

The agent will now emit a warning and disable itself if any application name is invalid. Allowed characters are alphanumerics and certain punctuation characters ({}.?!')
Router queue time now properly handles floating point values.
Fixed a bug where a socket connection could throw a synchronous error and cause the application to crash.

Node.js agent v1.9.0

Thu, 24 Jul 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

We now support Cassandra via the node-cassandra-cql driver.

New database instrumentation means that we can present you with the timing data for how long those queries take. Thanks to Aaron Silvas from GoDaddy for the initial implementation of the Cassandra instrumentation.
Router queue time now supports t=<number> in the X-REQUEST-START and X-QUEUE-START headers.

Node.js agent v1.9.2

Fri, 08 Aug 2014 00:00:00 +0000

The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.

Fixes

Fixed a bug in the express instrumentation where if you named an error handler function handle it would cause a recursion depth error.

Node.js agent v2.0.0-beta

Thu, 04 Aug 2016 00:00:00 +0000

Notes

You must read and agree to the Beta Agreement before using this beta version of the agent.

Dropped support for Node.js 0.6 and 0.8 as well as node-mysql package versions < 1.0.0.

New features

Improved API for writing instrumentation.

Introduced new classes for writing instrumentation, Shim and DatastoreShim. These classes along with the new newrelic.instrument and newrelic.instrumentDatastore methods make writing 3rd party instrumentation much easier.
Rewrote instrumentation for Cassandra, Redis, ioredis, MySQL, and MongoDB.

These instrumentations were rewritten using the new DatastoreShim interface. Their functionality is largely unchanged but the new code should be easier to maintain and extend.
Added public API documentation.

Documentation for the New Relic agent API has been generated using JSDoc and is now hosted on GitHub at https://newrelic.github.io/node-newrelic. There you can find documentation on the new classes as well as the pre-existing API methods.

Node.js agent v2.0.0

Tue, 18 Jul 2017 00:00:00 +0000

Notes

The New Relic Node Agent v2 is here!

This release contains major changes to the agent instrumentation API, making it easier to create and distribute your own instrumentation for third party modules. Check out Upgrade the Node agent or the Migration Guide for more information on upgrading your application to this version.
BREAKING: Reversed naming and ignore rules.

Naming rules are now applied in the order they are defined.
BREAKING: De-duplicated HTTP request transactions.

Only one transaction is created per request event emitted by an HTTP server. Previously this was one transaction per listener per event emitted.
BREAKING: Stopped swallowing outbound request errors.

Errors emitted by outbound HTTP requests will no longer be swallowed by the agent.
BREAKING: Node v0.8 is no longer supported. Minimum version is now v0.10.

The v1 agent will continue to support Node 0.8 but will no longer receive updates.
BREAKING: npm v1 is no longer supported. Minimum version is now v2.0.0.

New features

Added API for writing messaging framework instrumentation.

Introduced new MessageShim class for writing instrumentation. This shim can be accessed using the newrelic.instrumentMessages() API method.
Added amqplib instrumentation.

Applications driven by amqplib consumers will now have transactions automatically created for consumed messages. See Troubleshoot message consumers for more information on this instrumentation and its limitations.
Advanced instrumentation API is now generally available.

New methods for instrumenting common modules were introduced during the Agent v2 beta. These APIs are now available to everyone:
- newrelic.instrument()/Shim: This method can be used to instrument generic modules, such as connection pooling libraries, task schedulers, or anything else not covered by a specialized class.
- newrelic.instrumentDatastore()/DatastoreShim: This method is good for instrumenting datastore modules such as mongodb, mysql, or pg.
- newrelic.instrumentWebframework()/WebFrameworkShim: This method is used for instrumenting web frameworks like restify or express.
Documentation and tutorials for the new API can be found on our GitHub documentation page: http://newrelic.github.io/node-newrelic/

Improvements

Rewrote built-in instrumentation using the new Shim classes.

The following instrumentations have been rewritten:
- Datastores
  - cassandra-driver
  - ioredis
  - memcached
  - mongodb
  - mysql
  - node-cassandra-cql
  - pg
  - redis
- Web frameworks
  - director
  - express
  - hapi
  - restify
The @newrelic/native-metrics module is now included as an optional dependency.

This module will be installed automatically with Agent v2. If it fails to install the agent will still function.

Node.js agent v2.0.1

Tue, 25 Jul 2017 00:00:00 +0000

Bug fixes

Fixed issue with transaction events not including correct duration values.

This issue was introduced in v2.0.0, and it has affected web transactions histogram and percentile charts.
Fixed issue with Redis instrumentation causing the agent to crash in some cases.

Previously, the Redis instrumentation would crash the agent when Redis commands were called without a callback and after the transaction has ended.
Fixed issue with the agent crashing on Node v4.0-4.4 and v5.0-5.9.

This issue was caused by incorrect shim for Buffer.from(), and it affected older minor versions of Node v4 and v5.

Node.js agent v2.1.0-beta

Mon, 29 Aug 2016 00:00:00 +0000

Notes

You must read and agree to the Beta Agreement before using this beta version of the agent.

New features

Added rowCallback property to datastore segment descriptors.

With this parameter the shim will record the given function/parameter as a per-row callback which may be called multiple times. These calls will be counted up for traces.

Improvements

Incorporated fixes from v1.30.0
Rewrote PostgreSQL instrumentation using new DatastoreShim class.
Reversed reverse_naming_rules default.

Naming rules now default to evaluating in forward order.

Node.js agent v2.0.2

Tue, 01 Aug 2017 00:00:00 +0000

Improvements

Improved documentation for newrelic.start*Transaction and TransactionHandle.

Formatting for the startWebTransaction and startBackgroundTransaction methods was fixed and documentation for the TransactionHandle class which getTransaction returns was added.

Bug fixes

Fixed parsing the table name from SQL queries.

Quotes around the table name are now stripped after parsing the query and before constructing the metrics.
Fixed unhandled rejection error caused by ioredis instrumentation.

Node.js agent v2.1.0

Tue, 08 Aug 2017 00:00:00 +0000

Improvements

Improved metadata collection for AWS, Azure, GCE, and Pivotal Cloud Foundry.

Bug fixes

Fixed a bug in PG query obfuscation for $ placeholders.

The agent used to mis-detect $1 value placeholders as unmatched dollar-quoted strings causing the whole query to be obfuscated to just ?. These placeholders are now correctly detected and obfuscated.

Node.js agent v2.1.1-beta

Fri, 16 Sep 2016 00:00:00 +0000

Improvements

Incorporated fixes from v1.30.1, v1.30.2, and v1.30.3.

Node.js agent v2.2.0-beta

Wed, 09 Nov 2016 00:00:00 +0000

Improvements

Incorporated new features and fixes from v1.30.4, v1.30.5, v1.31.0, v1.32.0, and v1.33.0.

Node.js agent v2.2.1

Mon, 11 Sep 2017 00:00:00 +0000

Improvements

Added metrics for enabled/disabled feature flags.

Bug fixes

Fixed transaction naming for Hapi plugins.

Thanks to Marc Höffl (@KeKs0r) for providing a reproduction!

Node.js agent v2.2.0

Wed, 23 Aug 2017 00:00:00 +0000

New features

Added support for ignoring ranges of status codes.

The configuration error_collector.ignore_status_codes can now take ranges of numbers. For example, ignore_status_codes: ['400-404'] would ignore 400, 401, 402, 403, and 404.
Experimental instrumentation for async/await

This is experimental instrumentation and has not yet been tested in a wide array of production environments. The feature is currently off by default behind a feature flag. To enable this experimental instrumentation, add await_support: true to the feature_flag setting in your agent config file.

Improvements

Updated examples and documentation regarding custom transaction creation.

All examples and documentation now point at the newrelic.start*Transaction methods.
Transaction state is now maintained in ChildProcess event listeners.
Reducing logging verbosity in the SQL query obfuscator.

Bug fixes

Fixed a bug when a custom collector port was provided in the configuration that prevented redirected connections from working.
Fixed a bug in Shim#record that could cause an exception when trying to create a new segment as part of an ended/inactive transaction.
Fixed issue with custom Hapi handlers causing an error.

Previously custom Hapi handlers defined using the server.handler() method were causing the Hapi server to return a 500 error. Now they are correctly handled and recorded as middleware functions.

Node.js agent v2.3.0-beta

Thu, 05 Jan 2017 00:00:00 +0000

New features

The @newrelic/native-metrics module is now an optional dependency of the agent.

Now npm will attempt to install the module when the agent is installed. If it fails for whatever reason, the agent itself will still be installed correctly and the rest of the npm install will finish normally.

Improvements

Incorporated new features and fixes from 1.34.0, 1.35.1, and 1.36.0

Node.js agent v2.2.2

Tue, 26 Sep 2017 00:00:00 +0000

Bug fixes

Hapi handlers will now preserve the defaults associated with them.

Previously when wrapping handlers, the agent would drop the associated defaults on the ground, these are now properly forwarded to the wrapper. Big thanks to Sean Parmelee (@seanparmelee) for finding the root cause of this bug and reporting it!
Fixed starting the agent with an invalid process version.
Pinned request version for testing old versions of Node.
Added tests for feature flags created at agent initialization.

Node.js agent v2.3.0

Mon, 16 Oct 2017 00:00:00 +0000

New features

The agent will now support the Node 8 await keyword by default.

Improvements

Added benchmark for performance of function wrapping.
Added Garbage Collection information to async_hooks benchmark.
Improved trace-level logging for capturing queries.
Added cases for omitting the agent with and without async hooks to the async hooks microbenchmark.

Bug fixes

Pinned version of Mocha to 3.x due to the incompatibility of Mocha v4 and Node v0.10 and v0.12.

Node.js agent v2.3.1-beta

Thu, 12 Jan 2017 00:00:00 +0000

Improvements

Incorporated fixes from 1.36.1

Node.js agent v2.3.1

Tue, 24 Oct 2017 00:00:00 +0000

Improvements

Agent will attempt to reconnect to the collector forever after backing off to 5 minute delays.

Bug fixes

Refactored environment scan to improve startup time and fix cyclical symlink resolving.

Node.js agent v2.3.2

Thu, 02 Nov 2017 00:00:00 +0000

Improvements

Added Node 9 to test suite.
Removed problematic tests for ancient version of Hapi (7.1).
Document purpose of throw in tracer to prevent developer confusion.
Added script for running agent micro benchmarks.
Added benchmarks for all the Shim and Tracer methods.

Bug fixes

Fixed a bug with Node >=8.9 that prevented https externals from being recorded.

Node.js agent v2.4.0-beta

Wed, 25 Jan 2017 00:00:00 +0000

Improvements

Rewrote the cassandra-cql and memcached instrumentations using the DatastoreShim.
Improved instrumentation matching.

Previously, the agent would determine which instrumentation would run for a given module being loaded using the basename of the file path. This lead to false positives (e.g. myapp/lib/express.js would trigger the express instrumentation) which we previously just ignored. Matches are now determined using the string passed to require. This means you can now match local relative paths (./lib/something) as well as package-relative paths (amqplib/callback_api).

Node.js agent v2.4.1

Tue, 28 Nov 2017 00:00:00 +0000

Improvements

Added promise benchmarks to test non-async_hooks instrumentation.
Added logging for external calls made outside of a transaction.
Added logging for when unhandledRejection is noticed.
Improved performance of creating and merging metrics.
Improved performance of tracer.bindFunction.
Removed try-catch around internal property setting on older versions of Node.

Bug fixes

Moved require calls for vendor metadata to module-level.

Node.js agent v2.4.0

Wed, 15 Nov 2017 00:00:00 +0000

New features

Instrumentation will now only modify the arity of wrapped functions when needed.

This can be controlled with the matchArity property on a WrapSpec. Disabling arity matching has a significant, positive impact on the performance of instrumentation.

Improvements

Added benchmarks for shimmer methods.
Pinned hapi tests at v16 due to incompatibility in hapi v17 with Node.js versions <8.
The agent's parsed queries will now only hold onto the stack that the query was made at, instead of an error object instance.

Previously, the parsed query objects would hold onto an error instance, which would in turn hold onto references to all the functions in the stack when the error was created. This could cause memory issues if the functions were holding onto references to other pieces of data.

Bug fixes

Revert wrapping of https for Node ^8.9.1.

The original cause for this problem was reverted by Node.

Node.js agent v2.4.2

Tue, 12 Dec 2017 00:00:00 +0000

Notes

Added Peter Svetlichny to the contributors list!

Improvements

Optimized NameState#getPath.
Optimized shim.record.
Optimized shim.recordMiddleware.
Upgraded eslint to v4.

Bug fixes

Fixed parsing SQL for queries containing newlines.

Node.js agent v2.5.0-beta

Wed, 22 Feb 2017 00:00:00 +0000

New Features

Added support for recording interfaces that return promises instead of taking callbacks. See RecorderSpec.promise for more details.

Thanks to Gert Sallaerts (@Gertt) for this contribution.

Improvements

Incorporated fixes and features from 1.36.2, 1.37.0, and 1.37.1.
Domains are no longer preemptively instrumented, thus applications that do not use domains will not load the domain module.

Including the domain module causes a small amount of extra overhead in other core libraries that must keep the domain state set correctly.

Node.js agent v2.5.0

Wed, 03 Jan 2018 00:00:00 +0000

New features

Added hapi v17 instrumentation

Hapi v17 added support for promise-based middleware which broke transaction tracking in the agent. This caused issues in naming, as the agent will name the transaction after the path to the middleware that responded to a request.
Added instrumentation for vision@5

Due to the way vision is mounted to the hapi server when using hapi v17.x, the agent's instrumentation would not pick up on the middleware being mounted. This new instrumentation now correctly times rendering done in the vision middleware.
Added unwrapOnce method to shim object

This new method can be used to unwrap a single layer of instrumentation. unwrapOnce is useful in cases where multiple instrumentations wrap the same method and unwrapping of the top level is required.
Added isErrorWare checks around nameState.appendPath/nameState.popPath calls to avoid doubling up paths in transaction names

Previously, the agent would append its transaction name with the path fragment where an error handler middleware was mounted. The extraneous path fragment will now be omitted, and the transaction will be named properly after the middleware that threw the error.
Added support for pg 6 on Node 5 or higher

Improvements

Added parent property to webframework-shim segment description
Refactored existing hapi instrumentation for different server.ext() invocations
Refactored webframework-shim _recordMiddleware to construct different segment descriptions for callback- or promise-based middleware
Updated node-postgres@^6 versioned tests to avoid deprecation warning on direct module connect and end calls
Fixed running domain tests on Node 9.3.0.
Improved logging for CAT headers and transaction name-state management.
All json-safe-stringify calls now wrapped in try/catch
Removed lib/util/safe-json

Bug fixes

Fixed creating supportability metric when mysql2 goes uninstrumented.
Added a segmentStack.popto the middleware after in cases when an error is caught and there is no next handler
Fixed determining parents for middleware segments when transaction state is lost and reinstated
Added check to _recordMiddleware to avoid prepending a slash if original route is an array
Changed logic in http instrumentation to attach response.status to the transaction as a string
Updated startWebTransaction and startBackgroundTransaction to add nested transactions as segments to parent transactions

Node.js agent v2.6.0-beta

Wed, 03 May 2017 00:00:00 +0000

Notes

Dropped support for Express <4.6.

New features

Improved API for writing web framework instrumentation.

Introduced a new WebFrameworkShim class for writing instrumentation. This shim can be accessed using the newrelic.instrumentWebframework API method.

Improvements

Incorporated fixes and features from 1.38.0, 1.38.1, and 1.38.2.
Only one transaction is created for each request emitted by a server.

Previously we created a transaction for each listener on the request event.
Fixed the beta sign up link in the README.md.
Rewrote instrumentation for Connect, Director, Express, Hapi, and Restify.

These instrumentations were rewritten using the new WebFrameworkShim. As a consequence of this rewrite, all our instrumentations now have feature parity, meaning every instrumentation will create Middleware metrics for your server.

Tutorials on using the new instrumentation shim can be found on our API docs: http://newrelic.github.io/node-newrelic/.
Removed express_segments feature flag.

This configuration previously controlled the creation of middleware metrics in our Express instrumentation. With the move to the WebFrameworkShim this was dropped.

Node.js agent v2.6.1

Thu, 18 Jan 2018 00:00:00 +0000

Improvements

Added regression test for promise instrumentation and stack overflows.

Bug fixes

Fixed naming bug in Restify instrumentation regarding parameters to next.

The instrumentation previously considered any truthy value passed to next to be an error. It is possible to pass a string or boolean to next in Restify to control further routing of the request. This would cause the middleware's mounting path to be erroneously appended to the transaction name.
Fixed access to bluebird.coroutine.addYieldHandler.

This was accidentally not copied by our instrumentation making access to the function fail. This has been resolved and tests expanded to ensure no other properties were missed.

Node.js agent v2.6.0

Wed, 10 Jan 2018 00:00:00 +0000

New features

Added transaction_tracer.hide_internals configuration.

This configuration controls the enumerability of the internal properties of the agent. Making these properties non-enumerable can have an impact on the performance of the agent. Disabling this option may decrease agent overhead.

Improvements

Refactored promise instrumentation.

This new instrumentation is far more performant than the previous and maintains a more sensible trace structure under a wider range of sequences.
Added concurrent environment scanning, limited to 2 reads at a time.

This improves the performance of dependency scanning at agent startup, allowing the agent to connect to our services more quickly.
Refactored instrumentation tests to run against wide range of module versions.

Instrumentation tests will be run against all supported major versions of every instrumented module. For releases, we will test against every supported minor version of the modules. This vastly improves our test coverage and should reduce the instances of regressions for specific versions of modules.
Added tests for all of bluebird's promise methods.

These tests ensure that we 100% instrument bluebird. Some gaps in instrumentation were found and fixed. Anyone using bluebird should upgrade.

Bug fixes

Fixed a crashing error in the hapi instrumentation.

When recording the execution of an extension listening to a server event (for example, 'onPreStart') the agent would crash due to the lack of a raw property on the first argument passed to the extension handler. The agent now checks the event before wrapping the extension handler and checks for the existence of the raw property before attempting to dereference off of it.
Fixed an incompatibility with the npm module mimic-response.

The agent's HTTP instrumentation previously did not play well with the way mimic-response copied properties from an http.IncomingMessage. This caused modules that relied on that process, such as got, to hang.
Fixed naming rule testing tool to use same url scrubbing as the agent itself.

Node.js agent v2.7.0

Thu, 01 Feb 2018 00:00:00 +0000

New features

Added agent attribute filtering via include and exclude rules.

Agent attributes can now be controlled using fine grained include and exclude rules. These rules, described below, replace capture_params and ignored_params. Any attributes listed in ignored_params will be migrated to attributes.exclude internally, unless attributes.exclude is explicitly set.

There are three new configuration properties added to the root config and each destination (more on destinations later). These new configurations are:
- attributes.enabled - Enables collection of attributes for the destination.
- attributes.include - A list of attributes or wildcard rules to include.
- attributes.exclude - A list of attributes or wildcard rules to exclude.
The include and exclude rules can be exact rules (for example request.headers.contentLength), or wildcard rules which match just the beginning of attribute keys (for example request.headers.* would match any request header).

These rules can be specified globally at the root of the configuration, or for specific destinations. These destinations are:
- transaction_tracer - Controls transaction trace attributes.
- transaction_events - Controls transaction event attributes.
- error_collector - Controls error event attributes.
- browser_monitoring - Controls browser/RUM transaction attributes.
Renamed addCustomParameter to addCustomAttribute.

The addCustomParameter method is now deprecated and will be removed in a future release of the agent. The addCustomAttribute method is a drop-in replacement for it.
Added cache to agent attribute filtering.

To minimize the overhead of applying attribute rules, the agent caches results of filtering specific attribute keys and destinations. The cache is limited to 1000 destination-key pairs by default but can be configured with attributes.filter_cache_limit. This cache offers a 10x improvement for applying filter rules for cache-hits.
Added allow_all_headers to config options and updated http instrumentation.

When set to true, the agent will collect all request headers. This collection respects the agent attribute include and exclude rules. A default set of exclusion rules are provided in newrelic.js. These rules exclude all cookies and authentication headers.
Segments may now be flagged as opaque, causing internal segments to be omitted from the transaction trace.

Improvements

Added limits for agent attributes to keep monitoring overhead down.

Attribute keys and values are limited to 255 bytes each. Keys which are larger than 255 bytes are dropped, and a warning message is logged. Values larger than 255 bytes are truncated to 255 bytes, respecting multi-byte UTF-8 encoding. Custom attributes are limited to 64 per transaction. Attributes beyond the 64th are silently ignored.
Added error to collector connection failure log message.
Renamed request_uri attribute to request.uri.

This brings the attribute name in line with all other request attributes.
Updated https-proxy-agent dependency from ^0.3.5 to ^0.3.6.
Updated versioned tests where applicable to ensure most minor versions of instrumented modules work as expected.
Fixed stalling test for v1 line of Mongo driver.
Added tests verifying Hapi 404 transactions result in correctly named metrics.

The Hapi instrumentation was doing the correct thing, but we did not have tests for this specific case.

Bug fixes

The agent will no longer crash when crypto.DEFAULT_ENCODING has been changed.

Previously, the agent would assume the result of hash.digest() was an instance of a Buffer. If crypto.DEFAULT_ENCODING is changed, hash.digest() will return a string and the agent would crash. The agent now ensures that the value is a Buffer instance before moving on.
Fixed error if process.config.variables.node_prefix missing.

If process.config.variables.node_prefix is falsey (which can happen if using electron, leading to this issue https://discuss.newrelic.com/t/new-relic-on-electron-nodejs/53601) the getGlobalPackages function in lib/environment.js will give an err when it shouldn't.

Thanks to Jarred Filmer (@BrighTide) for the fix!

Node.js agent v2.7.1

Wed, 07 Feb 2018 00:00:00 +0000

Notes

Changed attributes.enabled to true by default.

In the previous version we defaulted this to false to maintain parity with capture_params which defaulted to false. However, this is a invalid parity because attribute.enabled controls more attributes than capture_params.

Improvements

Removed unnecessary checks around Timer.unref() calls.

unref has been supported since Node v0.9, meaning it will always be present in timers set by the agent (with 0.10 being the earliest supported version).
Added a split in the node versions for the mysql2 and cassandra versioned tests.

As of mysql2 v1.3.1 and cassandra v3.4.0 the minimum supported version of Node is 4.
Replaced as many instances of {} as possible with Object.create(null).
Removed extraneous logger arg in addCustomAttribute call.

Bug fixes

The agent will no longer generate browser data for ignored transactions.
Expanded Hapi instrumentation to support route pre handlers.

This is a Hapi route config option that was previously uninstrumented, causing transaction names to become invalid. This expanded instrumentation ensures that all additional handlers are wrapped and associated with the main route.

Node.js agent v2.8.0

Wed, 21 Feb 2018 00:00:00 +0000

Note

This release is deprecated due to an issue where the agent may capture transaction attributes regardless of agent settings. If you are using this release, upgrade your agent to agent version 2.9.1 or higher. For more information, see Security Bulletin NR18-06.

New features

Added instrumentation support for MongoDB version 3.

Version 3 of mongodb is now supported. Previously datastore host information (instance metrics) was incorrectly captured by the agent with mongodb v3. This has been fixed and all features should be functional now.

Improvements

Updated documentation for apdex_t setting and removed environment variable.

This was never configurable on client side and the documentation was misleading.
Documented environment variables for slow_sql configurations.

Thanks to Olivier Tassinari (@oliviertassinari) for the update!
Updated hapi/hapi-pre-17/package.json to run errors.tap.js in more versions.
Added internal cache to unwrapped core modules for agent use.
Improved logging around environment facts gathering.

Bug fixes

Enable certain agent attributes when high-security mode is enabled.

During the switch from the old capture_params/ignored_params to the new attribute include/exclude rules, high-security mode was over-zealous in what attributes it disallowed. This has been trimmed back to be in line with other agents.

Node.js agent v2.9.0

Tue, 27 Feb 2018 00:00:00 +0000

Note

Improvements

Added the WebFrameworkShim#savePossibleTransactionName method.

This method may be used to mark the current running middleware as a potential responder. savePossibleTransactionName should be used if a middleware can't be determined to be a terminal middleware while it executes, but may be responsible for responding after execution has finished.
Fixed dns.resolve results assertion.
Expanded async_hooks tests around maintain transaction context.
Added Koa to metric naming objects.
Added callback prop to middlewareWithPromiseRecorder return spec.

While we aren't actually wrapping any callback, this is a workaround that gives us access to the active segment. This ensures that all segments inside Koa transaction traces are named correctly, particularly in cases when transaction context may be lost.
Updated after prop in middlewareWithPromiseRecorder return spec to set txInfo.errorHandled = true in cases when there is no error.

Because Koa has no concept of errorware in the same sense as Express or Connect ((err, req, res, next)), the agent now assumes if a middleware resolves, any error that may have occurred can be marked as handled.

Fixes

Added check for parentSegment in async_hooks instrumentation, to help ensure that transaction context is maintained.

Node.js agent v2.9.1

Mon, 05 Mar 2018 00:00:00 +0000

Bug fixes

Security bulletin NR18-06:

Fixes issue introduced in 2.8.0 where the agent may have captured all transaction attributes, even with High-security mode enabled on the account. This may have included sensitive data attached to transactions.
Removed support for agent attributes include/exclude rules.

These will be coming back in Node Agent v3.0.0. The fix for the above security bulletin required a backwards incompatible change to our attributes.
Fixed bug in Bluebird instrumentation.

Some methods were not instrumented correctly. This would cause a problem if a function was passed to these methods.

Special thanks to Andreas Lind (@papandreou) for helping us find this bug.

Node.js agent v3.0.0

Wed, 07 Mar 2018 00:00:00 +0000

Improvements

Removed the ssl configuration option.

TLS is now always used in communication with New Relic Servers. The ssl configuration value and NEW_RELIC_USE_SSL environment value are no longer used. Setting either value to anything other than true will result in a warning.
Security bulletin NR18-05:

Fixes issue introduced in 2.8.0 where the agent may have captured all transaction attributes, even with High-security mode enabled on the account. This may have included sensitive data attached to transactions.
All request parameters now prefixed with request.parameters..

Previously request parameters such as route and query parameters were added as attributes without any name changes. For example /foo?bar=value would add the attribute bar to the transaction. Now this attribute would be named request.parameters.bar.

Any Insights dashboards, alerts, or other NRQL queries using these attributes must be updated to use the new attribute names.
Adds support for EU Datacenter

Node.js agent v3.1.0

Tue, 13 Mar 2018 00:00:00 +0000

Improvements

Promise based web framework middleware instrumentation now supports callback based sequencing.

Previously, a promise based middleware was assumed to continue to the next middleware once the promise it returned resolved. This assumption has been relaxed to allow for a callback to be supplied to the middleware to invoke the next middleware.

Node.js agent v3.2.0

Wed, 14 Mar 2018 00:00:00 +0000

New features

Added @newrelic/koa as a dependency.

This introduces instrumentation for Koa v2.0.0 or higher. It will be treated as first-party instrumentation within the agent, but publishing it as a separate module allows it to be installed independently according to users' needs.

Improvements

Refactored instrumentation hooks to work with modules.

With this change it is now possible to link against external instrumentation modules.

Node.js agent v3.3.0

Tue, 27 Mar 2018 00:00:00 +0000

New features

Added newrelic.startSegment(), which replaces newrelic.createTracer().

This new API method allows you to create custom segments using either callbacks or promises.

Bug fixes

Fixed bug in pre route config option in Hapi instrumentation.

Only applies to Hapi v16 and below. The pre handler wrapping was not properly returning in cases when the element was a string referring to a registered server method, and as a result these elements would be replaced with undefined.

Node.js agent v3.3.1

Tue, 10 Apr 2018 00:00:00 +0000

Fixes

Added a type check to attribute validation, restricting values to primitive types (but not undefined).

Previously the agent was only enforcing byte limits on string values, resulting in overly large arrays being collected. This brings the agent in line with other language agents.
The DatastoreShim will now respect specified after handlers.

Previously on methods like DatastoreShim#recordQuery the after handler would be dropped. The property is now correctly propagated to the underlying Shim#record call.
The agent will now check that a specified parent segment is part of an active segment before running a method under instrumentation.

Previously the agent would unconditionally run a method under a specified parent. The shim expects the parent to exist and be active, and will throw errors in the case where the parent belongs to an inactive transaction.

Node.js agent v4.1.0

Mon, 23 Apr 2018 00:00:00 +0000

Improvements

Added PriorityQueue class for collecting events.

This replaces the Reservoir class for event sampling. Using priority sampling allows the agent to maintain randomness across a given time period while improving the chances that events will be coordinated across Transaction, Error, and Custom event pools.
The agent will now allow external instrumentation modules to fail in a safe way.

Previously, the agent would stop running if an externally loaded instrumentation failed for any reason. Due to the way external instrumentations can be updated independently, the agent should allow them to fail and carry on after logging a warning.
Added the strip_exception_messages.enabled config option.

The agent can now be configured to redact error messages on collected errors.
Added the attributes.include_enabled config option.

The agent can now be configured to disallow attribute include patterns to be specified.

Fixes.

Updated logic around wrapping route handlers when config object is present.

Before, the agent would only attempt to wrap config.handler when any config object was present, without defaulting to the root handler if it didn't exist.

Node.js agent v4.0.0

Thu, 12 Apr 2018 00:00:00 +0000

Fixes

BREAKING: Updated the version of https-proxy-agent to v2.x - Dropped support for v0.10 and v0.12 of node.

The version of https-proxy-agent used in the agent has a known security issue you can read about here: https://snyk.io/vuln/npm:https-proxy-agent:20180402 In order to resolve this issue, the dependency had to be updated to at least v2.2.0, which only supported node versions >=4. The update to this dependency forces the incompatibility of the agent with versions 0.10 and 0.12 of node.

In order to use use the Node.js agent, please upgrade node to version >=4, or you can continue to use the agent on node versions 0.10 and 0.12 by pinning the agent to v3.

You can read more about the issue here: https://docs.newrelic.com/docs/using-new-relic/new-relic-security/securi...

Node.js agent v4.10.0

Thu, 01 Nov 2018 00:00:00 +0000

New features

Added DatastoreShim#getDatabaseNameFromUseQuery

This new method can be used to extract the database name from USE SQL queries.

Improvements

Added link to CONTRIBUTING.md file in README.md

Thanks to Yuri Tkachenko (@tamtamchik) for the contribution.
Added VS Code settings to git ignore.
Fixed bug preventing Distributed Tracing (DT) from fully functioning when Cross Application Tracing (CAT) was disabled.
Renames better-cat integration test organization to be distributed-tracing and updated some test verbiage to use DT or distributed tracing instead of CAT or cross application tracing.

Bug fixes

The agent will no longer break express routers in the case of using regex paths in a list.

Previously, the agent would overwrite the regex with the source of the regex. The agent now makes a copy of the route array and mutates that instead.
Attributes will now be properly propagated to PageView events.

The agent may now be configured to pass attributes along to the browser agent. The attributes that match the include/exclude rules in the browser_monitor.attributes section will now be placed on PageView events.

Node.js agent v4.1.1

Tue, 15 May 2018 00:00:00 +0000

Improvements

Optimized unhandledRejection reporting when using async_hooks.
Replaced all uses of util._extend with Object.assign.
Completed TODOs regarding the Node 0.10 and 0.12 deprecation.
Added PriorityQueue serialization benchmarks.

Bug fixes

The agent no longer resizes the metric timeslice start time to be the earliest start time of the transactions that finish during the timeslice.
Background transactions created may now be named through API#setTransactionName.

Previously, the agent didn't respect the transaction naming precedence for background transactions. Background transaction naming behavior is now in line with web transaction behavior.
Logger no longer tries to create very large log messages.

When a message is created that would be too large to log, a process warning is emitted.
The agent will now respect event count limits when merging data from a failed send.

Previously, when merging data into an event pool the agent wouldn't maintain the size limit of the reservoir.
Added check for a route prefix when wrapping Hapi route handlers.

Previously, route prefixes specified via plugin options weren't being included in transaction names. Now, if the agent finds a route prefix associated with a given realm, it is prepended to the route path in the transaction name.

Node.js agent v4.11.0

Thu, 15 Nov 2018 00:00:00 +0000

New features

Added protocol_17 feature flag.

Flag will be removed and protocol will be hard-coded to 17 once functionality is released on New Relic backend.
This release also includes changes to the agent to enable monitoring of Lambda functions. If you are interested in learning more or previewing New Relic Lambda monitoring please email lambda_preview@newrelic.com.
Added waitForIdle option to API#shutdown.

This new option will make the agent wait for all active transactions to finish before actually shutting down. This does not pre-empt creation of new transactions, so care must be taken to ensure the active transaction pool drains or the agent will never shut down.

Improvements

Added switch statement indenting standard to eslintrc
Introduced "warn" level 2 space rule to eslintrc
Upgraded @newrelic/test-utilities to v2.

Bug fixes

Changed totalTime attribute to be in decimal seconds instead of milliseconds for transaction events.
Agent no longer produces spans on ignored transactions.

Previously, the agent would produce distributed tracing span events regardless of the ignored status of the transaction the events originated from.
Extended Restify instrumentation to mark possible transaction names in order to account for async response methods.
Updated hapi@16 versioned tests to only run on Node 6 and above.
Pinned mysql2 to <1.6.2 in versioned tests.

Node.js agent v4.1.2

Tue, 22 May 2018 00:00:00 +0000

Fixes

Updated use of fs.unlink without a callback to fs.unlinkSync.

As of Node v10, the callback is no longer optional, which was causing a false test failure.
Fixed access to properties on promisified methods.

Node.js agent v4.12.0

Mon, 03 Dec 2018 00:00:00 +0000

New features

Added IP address collection and forwarding of metadata headers for upcoming protocol 17.

These features are currently behind the protocol_17 feature flag until all parts of protocol 17 are implemented.

Improvements

Converted error handling in CollectorAPI and RemoteMethod to callbacks.

Previously many of the errors were thrown. For consistency with async errors, these are now handed to the callback instead of thrown. The old behavior could result in a crash under a few circumstances, such as when the agent exceeded a configured maximum payload size. These errors came from RemoteMethod._safeRequest. Since these errors are handed to the callback instead of thrown, this bug is no longer a potential.
Refactored harvest interactions in preparation for protocol 17 status codes.

Node.js agent v4.13.0

Thu, 20 Dec 2018 00:00:00 +0000

New features

The agent now reacts to failed New Relic requests based on response code, as opposed to parsing an exception message in the response body.

Improvements

Fixed clearing of active harvest via _stopHarvester()
Fixed handling of harvest endpoints when not all fail.
Added agent state "connecting" to indicate when handshake with New Relic servers is starting. This can be triggered on startup and restarts.
Added --no-package-lock to unit and integration rules.
Released protocol_17 feature flag.
Replaced nsp with npm audit in security checks.
Collector now specify application/json content-type when data is compressed instead of octet-stream.
Bumped ecmaVersion in test .eslintrc to 8

Node.js agent v4.1.3

Tue, 29 May 2018 00:00:00 +0000

Fixes

Fixed metric merging when using debug.internal_metrics.

The debug metrics cache would cause timestamps for harvested metrics to get stuck at agent startup. This will no longer happen, and the debug cache is reset each harvest.

Improvements

Modularized configuration constants to improve readability.

Node.js agent v4.13.1

Tue, 23 Apr 2019 00:00:00 +0000

Fixes

Fixed bug where agent would stop sending data to New Relic servers when a connectivity issue was encountered.
The agent will no longer crash the process in the event of unexpected calls to the harvest callback.

Node.js agent v4.2.0

Tue, 19 Jun 2018 00:00:00 +0000

New features

Added an option for using the finally method on promises for instrumentation.

The promise instrumentation would use Promise#finally if available. This change is in response to Node v10 promises calling then inside their finally method, which caused infinite recursion in the agent's promise instrumentation.
Added seen/sent/dropped supportability metrics for all event collections.

Improvements

Refactored harvest cycle into separate class.

This refactoring eases managing harvested data and re-merging unharvested values on failure.
No longer download gcc on test suites that do not require it.

Bug fixes

Updated WebFrameworkShim to handle arrays of routes when wrapping middleware mounters.

Previously, a transaction that hit a shared middleware (eg, app.use(['/one', '/two'], ...)) would always be tagged with <unknown> in its name, due to the agent not interpreting arrays of paths. Now transaction names will include all paths for a shared middleware, comma-delimited, followed by the current route ('WebTransaction/Expressjs/GET//one,/two/one').

Node.js agent v4.1.5

Mon, 11 Jun 2018 00:00:00 +0000

Fixes

Make require() statements explicitly reference package.json as a .json file.

This solves a problem when requiring/importing newrelic from a Typescript file.

Check if process.mainModule.filename exists before using in missing config file check.

When the agent is preloaded with Node's --require flag, mainModule is not yet defined when the agent checks for a config file, resulting in a TypeError in the event that no config file exists. Defaulting to the file path being executed in process.argv ensures that the app will not crash when preloaded without a config file.

Updated dev dependency tap to v12.0.1.
Fixed identification of errors with express.

Previously the call next('router') was considered an error. This is actually valid usage of express and will no longer generate an error.

Removed debug.internal_metrics configuration.

This legacy debug configuration was never used since trace-level logging provides everything this did and more.

Upgraded optional dependency @newrelic/native-metrics to v3.

With this update comes pre-built binaries for Node 5 and 7. GC metrics are also now aggregated in C++ until the agent is ready to harvest them instead of hopping into JS for each event.

Added additional checks to uninstrumented ensuring that files with names matching instrumented modules do not result in a false uninstrumented status.

For example, some users load config/env info before the agent. In that case, a file responsible for exporting DB config information (config/redis.js), may result in a false uninstrumented status, because the agent would interpret redis.js as the module itself.

Node.js agent v4.2.1

Mon, 02 Jul 2018 00:00:00 +0000

Improvements

Added more tests for transaction naming with Restify.

Fixes

Fixed issue with tracking external requests to default ports.

Special thanks to Ryan King for pinpointing the cause of this issue.
Added extra check for handling arrays of functions when wrapping middleware mounters.

This fixes a bug with the agent incorrectly assuming that arrays passed as the first argument in middleware would only contain route paths, causing a fatal error.
The agent now reports the total time of the transaction on transaction events.

Node.js agent v4.3.0

Mon, 09 Jul 2018 00:00:00 +0000

Improvements

Added nonce option for newrelic.getBrowserTimingHeader()

This allows people to pass in a string to be injected as the nonce property of the generated script tag. Special thanks to João Vieira (@joaovieira) for contributing this feature!
Expose the External segment on the http request instance for outbound calls.

Fixes

Added check to mark Hapi 'onPreResponse' extensions as error handlers.

Previously, the agent was unable to mark any Hapi errors as handled, even if they were, resulting in inaccurate reporting. This change assumes that 'onPreResponse' extensions act as error handlers, so errors are only reported if they persist to the final response.

Node.js agent v4.5.0

Mon, 16 Jul 2018 00:00:00 +0000

New features

Feature flags may now be set from environment variables.

Using the naming convention NEW_RELIC_FEATURE_FLAG_<feature flag name in upper case>.

Improvements

Transaction events may be harvested in two payloads now.

This change reduces the occurrence of harvests being rejected due to large payloads. Payloads will only be split when they are large (greater than 1/3 the maximum).

Bug fixes

Updated Hapi v17 instrumentation to wrap server export, in addition to Server.

Node.js agent v4.4.0

Thu, 12 Jul 2018 00:00:00 +0000

Improvements

Replaced trusted_account_ids array with trusted_account_key.
Added node v10 to the test matrix.

Bug fixes

Added config utilization env vars to the BOOLEAN_VARS set.

This ensures that if these boolean config values are set outside of a config file, their values are respected, particularly when they are disabled.

Node.js agent v4.5.1

Wed, 18 Jul 2018 00:00:00 +0000

Fixes

The agent will now properly remerge event data on collection failure.

Previously, the agent wouldn't observe the correct format for remerging, causing undefined events to be pushed into the reservoir.

Node.js agent v4.6.0

Tue, 24 Jul 2018 00:00:00 +0000

New features

Added full support for Node v10.
Added instrumentation for crypto.scrypt.
Added instrumentation for fs.realpath.native.
Added instrumentation for process.setUncaughtExceptionCaptureCallback.

Fixes

Updated tests to use asyncResource.runInAsyncScope instead of emitBefore and emitAfter

Node.js agent v4.7.0

Tue, 31 Jul 2018 00:00:00 +0000

New features

Added support for distributed tracing.

Distributed tracing lets you see the path that a request takes as it travels through your distributed system. By showing the distributed activity through a unified view, you can troubleshoot and understand a complex system better than ever before.

Distributed tracing is available with an APM Pro or equivalent subscription. To see a complete distributed trace, you need to enable the feature on a set of neighboring services. Enabling distributed tracing changes the behavior of some New Relic features, so carefully consult the transition guide before you enable this feature.

To enable distributed tracing, set distributed_tracing.enabled to true in your newrelic.js file, or set NEW_RELIC_DISTRIBUTED_TRACING_ENABLED in your environment.
Added a warning for too-new versions of Node.js during agent startup.
Appropriately obfuscated SQL statements will now be included in all transaction traces.

Previously, the agent would only include the SQL statements if the corresponding query was sufficiently slow.
Added ability to execute instrumentation functions in the context of the segment the segment descriptor is describing.

All record* methods supplied by all instrumentation shim classes now allow for a function to be executed under the context of the segment the record call will produce. This may be done by supplying a function in the inContext key for the segment descriptor passed to the record method.
Reservoirs will now respect setting their size to 0.

Node.js agent v4.8.0

Mon, 13 Aug 2018 00:00:00 +0000

Improvements

Implemented enforcement of max_payload_size_in_bytes config value.

Any payload during the harvest sequence that exceeds the configured limit will be discarded.
Added JSON-formatted output to benchmarks to enable automated benchmark comparison.
Updated the benchmark runner to measure specifically userland CPU overhead.
Added DatastoreShim benchmarks.

Bug fixes

Fixed MongoDB instrumentation for driver versions greater than 3.0.6.

Mongo 3.0.6 removed metadata the Agent relied upon to instrument the driver. This fixes that by going back to the old method of manually listing all objects and methods to instrument.
Updated MySQL versioned tests to run against the latest release.

Node.js agent v4.8.1

Mon, 27 Aug 2018 00:00:00 +0000

Improvements

Converted File System instrumentation to use newer shim style.
Converted DNS instrumentation to newer shim style.
Added tracking of callbacks to DNS instrumentation.
Converted crypto instrumentation to newer shim style.
Updated domains instrumentation to use an instrumentation shim.
Refactored the global instrumentation to use the shim API.
Ported inspector instrumentation to use an instrumentation shim.
Ported async_hooks based promise instrumentation over to using shims.
Added shim types for core instrumentations.
Improved benchmark comparison output.
Added http benchmark tests.

Bug fixes

Agent instrumentation will no longer interfere with promisification of core methods.

Some core methods expose pre-promisified versions of the methods as a reference on the method itself. When instrumenting these methods, it neglected to forward these references onto the wrapper function. Now the instrumentation will properly forward property look ups to the original method.
Fixed outbound https call to use example.com to resolve integration test issue.
Fixed tests for ioredis 4.0.0 and above.

Node.js agent v4.9.0

Mon, 01 Oct 2018 00:00:00 +0000

New features

Added superagent as built-in instrumentation.

This instrumentation just maintains transaction state when using the superagent module to make HTTP requests with either callbacks or promises.
Updated noticeError API method to be partially functional in High-security mode.

In HSM, any custom attributes will be ignored, but the error will still be tracked. This brings the Node agent in line with the behavior of other language agents.
Added PromiseShim class for instrumenting promise libraries.
Support for setting transaction_tracer.transaction_threshold to 0 has been added.

Improvements

Updated DT payload creation to use primary_application_id from connect response.
Added protection against functions with modified prototypes in shim.applySegment.
Replaced SQL ID hash generation algorithm with SHA1 instead of MD5 to allow usage in FIPS compliant environments.
Leveraged 16 hex digits for creation of SQL ID.
Upgraded ejs module to get rid of Github security warnings. The ejs module was only used for tests and not in main agent code.
Changes DT payload configuration log messages to debug level as it is not uncommon for calls to occur before server configuration has been retrieved.
Converted net instrumentation to use shim api.
Converted child_process instrumentation to newer shim style.
Converted Timers instrumentation to newer shim style.
Converted zlib instrumentation to use shim API.

Bug fixes

Fixed codec.decode() callback bug that would re-call a callback with an error thrown within the callback.
Fixed bug requiring Cross Application Tracing (CAT) to be enabled for Distributed Tracing (DT) createDistributedTracePayload and acceptDistributedTracePayload APIs to function. DT configuration will no longer consider CAT configuration.
Fixed bug in wrap() that would fail to wrap callbacks if the callback index was 0.
The agent now respects NEW_RELIC_TRACER_THRESHOLD.

Previously, this environment variable was stored as a string. The environment variable is now stored as a float.

Node.js agent v5.0.0

Tue, 08 Jan 2019 00:00:00 +0000

Notes

Dropped support for Node versions less than 6.
Agent no longer creates transactions when in a stopped, stopping or errored state.
Removed public API methods that have been deprecated since Agent v2: createTracer, createWebTransaction, createBackgroundTransaction, and addCustomParameter/(s). See the Migration Guide for more information.
Flagged API#setIgnoreTransaction as deprecated; TransactionHandle#ignore should be used instead.
Released several feature flags. These flags are no longer used:
- feature_flag.custom_instrumentation
- feature_flag.custom_metrics
- feature_flag.synthetics
- feature_flag.native_metrics
Added plugins.native_metrics.enabled configuration value.

This configuration value controls the use of the @newrelic/native-metrics module. When set to false the agent will not attempt to load that module.
Custom metrics recorded via recordMetric and incrementMetric API calls now automatically have the name prepended with 'Custom/'. Usages of these APIs that manually prepend with 'Custom/' will need to remove the manually specified one or will end up with metrics prepended with 'Custom/Custom/'.
Dropped support for node-cassandra-cql.
Removed from ignore_server_configuration config setting.
Removed deprecated configuration settings capture_params and ignored_params.
The agent will no longer cause a stack overflow when logging at trace level to stdout.

Previously, the agent would inadvertently trigger a trace level log from its trace level log (through wrapping a nextTick call), causing a stack overflow. The agent now detects this case and aborts the nested call.

Node.js agent v5.10.0

Wed, 12 Jun 2019 00:00:00 +0000

New Features

Enables ability to migrate to Configurable Security Policies (CSP) on a per agent basis for accounts already using High-security mode (HSM).

When both HSM and CSP are enabled for an account, an agent (this version or later) can successfully connect with either high_security: true or the appropriate security_policies_token configured. high_security has been added as part of the preconnect payload.

Improvements

The agent now allows installation on node v11 and v12.

This change relaxes the engines restriction to include Node v11 and v12. This does not constitute official support for those versions, and users on those versions may run into subtle incompatibilities. For those users who are interested in experimenting with the agent on v11 and v12, we are tracking relevant issues here: https://github.com/newrelic/node-newrelic/issues/279.

Fixes

Lambda invocations ended with promises will now be recorded properly.

Previously, the lambda instrumentation was not intercepting the promise resolution/rejection returned from a lambda handler. The instrumentation now properly observes the promise, and ends the transaction when the promise has finished.
Lambda invocations will only attempt to end the related transaction a single time.

In the event of two lambda response events (e.g. callback called, and a promise returned), the agent would attempt to end the transaction twice, producing an extraneous empty payload. The agent now limits itself to a single end call for a given transaction.
The agent will now properly end transactions in the face of uncaught exceptions while in serverless mode.

Node.js agent v5.1.0

Thu, 17 Jan 2019 00:00:00 +0000

New features

Added new shim type: ConglomerateShim

This shim class is useful for instrumenting modules which implement several service interfaces of different types.

Improvements

Disabled logging by default when serverless_mode is enabled. Please note serverless/lambda monitoring is not yet officially released.
null trace attribute values are no longer sent to New Relic.

This change brings the Node agent in alignment with the behavior of other language agents.

Node.js agent v5.13.0

Tue, 01 Oct 2019 00:00:00 +0000

New Features

Support for Real Time Streaming
- Event data is now sent to New Relic every five seconds, instead of every minute. As a result, transaction, error, and custom events will now be available in New Relic and Insights dashboards in near real time. For more information on how to view your events with a five-second refresh, see the real time streaming documentation.
- Note that the overall limits on how many events can be sent per minute have not changed. Also, span events, metrics, and trace data is unaffected, and will still be sent every minute.
Now supports Restify 7 and 8.
Distributed Tracing is now enabled by default in serverless mode.
HTTPS connections to New Relic now use a keep alive HTTP-Agent.

Improvements

Maximum event limits are now enforced by the server. This includes a new maximum of 10000 transaction events per minute.
Harvesting is now completed by individually scheduled harvesters per data type.
Drops old odd-numbered node versions that are no longer supported by node from travis testing matrix
Updated Mocha and Docker links in CONTRIBUTING.md.

Fixes

Bumps tap version to move beyond handlebars audit warning.
Bumps Restify dev dependency past audit warning.
Fixed bug where segment reference on the outbound request was enumerable.
Fixed bug where incorrect config information was sent to New Relic.
The agent will now end/serialize transactions in the event of an uncaught exception while operating in serverless mode.

Node.js agent v5.11.0

Wed, 31 Jul 2019 00:00:00 +0000

New Features

Implements Expected and Ignored Errors functionality
Adds support for scoped package name introduced in hapi v18 (@hapi/hapi).

This will provide functionality at parity with instrumentation for hapi v17. Any new features may not yet be supported.

Improvements

Bumps jsdoc and lodash dev dependency to avoid upstream vulnerability warning.
Adds detailed logging through harvest/collector code to increase supportability.

Fixes

Fixed bug where agent would count errors towards error metrics even if they were dropped due to the error collector being disabled.
The agent will now properly track cached paths to files in loaded modules on Node versions >10.

As of Node v11, the path to a file in a module being loaded will only be resolved on the first load; subsequent resolution of that file will use a cached value. The agent records this resolved path and uses it for relative file look ups in order to deep link into modules using Shim#require. Since the agent couldn't reliably get at the path on the subsequent calls to require, it now replicates the caching logic and hold onto the resolved path for a given file.

Node.js agent v5.13.1

Thu, 10 Oct 2019 00:00:00 +0000

Improvements

Added diagnostic code injector.

The agent may now be configured to make transaction state checks via code injection. This may be turned on by setting code_injector.diagnostics.enabled to true. While this option is enabled, code around async boundaries will be added to track transactions, and log a message when they are not properly reinstated.
Added back generation of entity stats logging and uninstrumented support metric generation on metric harvests.
Removed legacy harvest code from main agent.
Upgraded tap to latest version
Upgraded mocha to latest version.
Adds --exit flag to mocha test runs to prevent infinite runs on CI.

Fixes

primary_application_id now defaults to 'Unknown' in serverless mode to allow Distributed Tracing to function correctly when NEW_RELIC_PRIMARY_APPLICATION_ID is not defined.
Updated https-proxy-agent to v3 for security fix.

Shoutout to @asturur for the contribution.
Fixed bug where API.shutdown() would not properly harvest when configured to.
Fixed bug where multiple agent restarts would cause the number of 'stopped' listeners to exceed limit.
Fixed inconsistent async return from collector API.

This could result in an infinite loop due to attempting to merge before clearing. This bug should not have impacted normal agent runs but was uncovered for certain test cases.
Fixed tests that leave work scheduled on the event loop.
Fixed issue that could result in vendor utilization detection failure. As a part of this fix, the request that hits the timeout will immediately abort instead of hanging around for the default timeout.

Node.js agent v5.2.0

Wed, 23 Jan 2019 00:00:00 +0000

New features

Added Neptune to the known database names.

Improvements

Updated log messages for missing configuration files to point at the base configuration.

Previously the log messages pointed at an internal file defining default values for every configuration.
Upgraded to @newrelic/native-metrics v4.
Removed outdated config files.
Removed old, outdated examples.

Bug fixes

Fixed an issue where old CAT headers would be injected while distributed tracing was enabled.

This would happen if both cross_application_tracing.enabled and distributed_tracing.enabled were set to true and an instrumentation disabled tracing for an outbound request.
Fixed access to ConglomerateShim in shimmer.

Node.js agent v5.2.1

Tue, 29 Jan 2019 00:00:00 +0000

Improvements

Removed installation of Oracle container test scripts.
Replaced explicit config.high_security === true checks with general truthiness checks.

The agent will now treat any truthy value in the high_security config setting as if it is enabled.

Bug fixes

Fixed bug where agent would stop sending data to New Relic servers when a connectivity issue was encountered.
Fixed unit test with incorrect usage of cross application tracing.

Node.js agent v5.3.0

Mon, 11 Feb 2019 00:00:00 +0000

New features

Added span_events and transaction_segments attribute destinations.

Span event and segment attributes can now be filtered using the same include/exclude config rules as other types. See agent attribute configuration for more details.
Added metadata field to connect payload, for collecting NEW_RELIC_METADATA_-prefixed environment variables.
Added DynamoDB to datastores.
Added opaque option to datastore operation spec.
Added Kubernetes utilization detection.
Upgraded concat-stream and readable-stream to next major version.

These modules had previously been held back due to support for Node <6. Since v5.0.0 we dropped that support thus enabling these updates.
Added SQS as a supported messaging library name.
Enabled tracking of callback via message-shim.recordConsume when no messageHandler provided.

Improvements

Replaced make rules with npm scripts.

Bug fixes

The agent will now consistently harvest in all response cases when in serverless mode.

Previously, the agent's harvest was in a race with process suspension in the event of an uncaught exception, or responding without calling a callback. A synchronous harvesting process is now used to circumvent this racing issue.
Fixed issue with socket connection errors causing the agent to stop attempting to connect at startup.
Fixed opaque segment functionality for message-shim.recordProduce.
Fixed opaque segment functionality for message-shim.recordConsume.

Node.js agent v5.6.0

Mon, 04 Mar 2019 00:00:00 +0000

New features

Added product attribute to existing datastore instrumentations.
Added db.collection to datastore span event attributes.

Improvements

trusted_account_key, account_id, and primary_application_id may now be configured via a configuration file while in serverless mode.
Optimized exclusive time duration calculator.

Previously, the agent would spend a lot of time sorting redundant arrays while calculating the exclusive time for the segments of a trace. This has been refactored into a single postorder traversal over the tree which will calculate the exclusive time for all segments in the subtree rooted at a given segment.

Fixes

Fixed a bug where data belonging to distributed traces starting in the Node.js agent would be prioritized over data produced from traces starting in other language agents. Previously, the agent would use the same random number for both the transaction priority (used for data sampling) and the distributed tracing trace sampling decision (whether to create DT data for a given transaction). This random number reuse resulted in a bias that caused data from distributed traces started in the Node.js agent to be prioritized above data that belongs to distributed traces started in other language agents. The agent now makes individual rolls for each of these quantities (i.e. the transaction priority and trace sampling decision), eliminating the bias.
Prevent a split on undefined location under certain conditions in Memcached.

Node.js agent v5.5.0

Tue, 19 Feb 2019 00:00:00 +0000

New features

Added SNS to message shim library names.
Added check for collect_span_events in config sent from the server on connect.

Collection of span events can be disabled from the server configuration, but not enabled.

Improvements

Refactored Segment#toJSON to be more readable.
Added a try/catch to config initialization to safely handle invalid setting combinations.

When an error is caught the agent is marked as disabled, which ultimately returns a stub API and keeps the process running.
String truncation is now done using a binary search over the byte length of the string.

Previously this truncation was done using a linear search for the proper byte length.
Optimized segment and span attribute filtering.

Fixes

Fixed issue where shim.createSegment() could result in modifying the parent when opaque.
Fixed issue where http-outbound would modify parent segments when parent is opaque.
Moved processing of exclusive time attribute out of toJSON and into finalize to only be calculated once.

Previously, serializing a segment would result in calculating and caching exclusive time which could result in issues if serialized prior to ending.

Node.js agent v5.6.1

Mon, 11 Mar 2019 00:00:00 +0000

Fixes

Updated log message for not adding attributes and change the log level to debug.
Fixed an issue where exclusive time would be improperly calculated in some cases.

Node.js agent v5.6.2

Mon, 25 Mar 2019 00:00:00 +0000

Improvements

Agent now respects attribute type restrictions on trace/segment attributes, as well as error event/trace attributes.

Bug fixes

Fixes potential for RangeError: Maximum call stack size exceeded error on Transaction/Trace end.
Custom events no longer accept attributes with invalid types.

The only attribute types accepted by the backend are boolean, string, and number; any attribute assigned to a custom event outside these types would be dropped on ingest. The agent now filters these attributes out, and logs out a helpful message detailing the issue.

Node.js agent v5.6.4

Tue, 16 Apr 2019 00:00:00 +0000

Bug fixes

Refactored config to log warning and disable distributed tracing if enabled in serverless mode, but missing required config setting.
Serverless mode no longer sets different data collection limits.
The agent will no longer crash the process in the event of unexpected calls to the harvest callback.
Updated required config values when using distributed tracing in serverless_mode to only include account_id.

Node.js agent v5.6.3

Mon, 01 Apr 2019 00:00:00 +0000

Bug fixes

The agent will now accurately filter out request parameters while operating under CSP or HSM.

You can find more information about this change in the Security Bulletin.

Node.js agent v5.8.0

Mon, 06 May 2019 00:00:00 +0000

New Features

Modifies MiddlewareSpec route property to allow functions. Defers route processing and segment naming until just before needed (each middleware invocation).

Improvements

Fixed outdated license ref in package.json.
Middleware instrumentation now honors spec.appendPath for more cases and will not pop paths when it has not appended a path.

Node.js agent v5.7.0

Wed, 24 Apr 2019 00:00:00 +0000

New Features

Added getStatusName to NameState.

Now web transactions will be named after known status code messages (404, 405, and 501).
Added appendPath option to MiddlewareSpec.

Improvements

Broke apart integration script test globs.

Node.js agent v5.9.0

Mon, 20 May 2019 00:00:00 +0000

New Features

serverless_mode feature flag is now enabled by default.
Added instrumentLoadedModule method to the API, allowing end-users to manually apply an instrumentation to a loaded module. Useful for cases where some module needs to be loaded before newrelic

Improvements

Removed older versions of Cassandra from versioned tests
For debug/test runs, shimmer will now cleanup the __NR_shim property on instrumented methods. This leftover property did not result in any negative behaviors but cleaning up for thoroughness and to prevent potential confusion.
Fixes recordMiddleware promise parenting for certain cases where child segments are created within resolving middleware next() promises.

Node.js agent v6.10.0

Mon, 22 Jun 2020 00:00:00 +0000

New Features

Additional Transaction Information applied to Span Events
- When Distributed Tracing and/or Infinite Tracing are enabled, the Agent will now incorporate additional information from the Transaction Event on to the currently available Span Event of the transaction.
  - The following items are affected:
    - aws-lambda related attributes
    - error.message
    - error.class
    - error.expected
    - http.statusCode
    - http.statusText
    - message.*
    - parent.type
    - parent.app
    - parent.account
    - parent.transportType
    - parent.transportDuration
    - Request Parameters request.parameters.*
    - request.header.*
    - request.method
    - request.uri
- Custom Attributes
  - Custom transaction attributes added via API.addCustomAttribute or API.addCustomAttributes will now be propagated to the currently active span, if available.
- Security Recommendation:
  - Review your Transaction Event attributes configuration. Any attribute include or exclude setting specific to Transaction Events should be applied to your Span Attributes configuration or global attributes configuration. Please see Node.js agent attributes for more on how to configure.

Improvements

Upgraded @grpc/grpc-js from 1.0.3 to 1.0.4
Modified redis callback-less versioned test to use commandQueueLength as indicator redis command has completed and test can continue. This is in effort to further reduce these test flickers. Additionally, added wait for client 'ready' before moving on to tests.
Updated force secret test runs to run on branch pushes to the main repository.

Node.js agent v5.9.1

Tue, 28 May 2019 00:00:00 +0000

Improvements

Shim#require will now operate as expected.

Previously, the module interception code made the faulty assumption that a module's filepath would be resolved before the module load call was invoked. This caused the wrap filepath to be attributed to the modules being instrumented. This meant that attempted relative require calls using Shim#require would resolved from the incorrect path. The logic has been changed to keep a stack of the resolved filepaths, resolving the issue.
Shim#wrapReturn now uses ES6 proxies to wrap its methods.

This will accurately propagate look up and assignment onto the underlying wrapped function, while maintaining all previous functionality.
Updated versioned test configurations to reflect current engine support.
Moved third party notices to THIRD_PARTY_NOTICES.md
Updates error message for license check to indicate all places that need to be updated.

Node.js agent v6.11.0

Tue, 07 Jul 2020 00:00:00 +0000

New Features

Updated to Apache 2.0 license
Added CODE_OF_CONDUCT.md file
Streamlined README.md file
Updated CONTRIBUTING.md file
Added additional guidance to bug report template
Added copyright headers to all source files

Improvements

Added Distributed Tracing option to config file used for first time customers
Converted some test files to Node-tap
Removed "hidden" and unused code injector diagnostic capability
Upgraded @grpc/grpc-js from 1.0.4 to 1.0.5

Node.js agent v6.12.0

Mon, 10 Aug 2020 00:00:00 +0000

Improvements

Updated guidelines and templates for contributing to the project.
Updated SECURITY.md with coordinated disclosure program link.
Upgrade async to v3.2.0. Special thanks to Yohan Siguret (@Crow-EH) for the contribution.
Bumped @newrelic/native-metrics to ^5.3.0.
Bumped @newrelic/aws-sdk to ^2.0.0.
Bumped node-test-utilities to ^4.0.0.
Bumped @newrelic/superagent to ^3.0.0.
Bumps @newrelic/koa to ^4.0.0.

Fixes

Fixes obfuscation of SQL queries with large data inserts. Special thanks to Tomáš Hanáček (@tomashanacek) for tracking down the issue and providing the fix.
On failed instrumentation, prevent multiple requires from re-wrapping shims. Special thanks to Ryan Copley (@RyanCopley) for the contribution.

Node.js agent v6.12.1

Thu, 20 Aug 2020 00:00:00 +0000

Fixes

Security fix: Resolves an issue where transaction traces will still capture the request URI when the Node.js agent is configured to exclude the 'request.uri' attribute. This can be problematic for certain customers in environments where sensitive information is included in the URI. See security bulletin NR20-02.

The request URI will now be excluded from transaction traces if the 'request.uri' attribute has been set to be excluded at either the top-level 'attributes.exclude' configuration or at the 'transaction_tracer.attributes.exclude' configuration.

Node.js agent v6.13.0

Tue, 25 Aug 2020 00:00:00 +0000

New Features

Added ability for the agent to write to a named pipe, instead of stdout, when in serverless mode.

Node.js agent v6.13.1

Thu, 24 Sep 2020 00:00:00 +0000

Fixes

Fixed named-pipe check for lambda invocations to avoid race-condition.

Named-pipe existence will now be checked just prior to first write and then cached.

Improvements

Updated README with community-plus header.
Updated README config copy example.
Added Open Source Policy workflow.
Removed repository CoC in favor of centralized CoC at org root.

Node.js agent v6.13.2

Tue, 13 Oct 2020 00:00:00 +0000

Fixes

Removed lodash as a development dependency
Check for named pipe existence before each flush

This removes the cached value used in 6.13.1

Improvements

Update shim documentation

Thank you to @ronen-e for the contribution!

Node.js agent v6.0.0

Tue, 29 Oct 2019 00:00:00 +0000

Notes

Added official parity support for Node 12.
- Exception: Errors resulting in unhandled rejections will no longer be scoped to the transaction that was active when the rejected promise was created.
  
  As of Node 12, the promise responsible for triggering the init async hook will no longer be passed through on the promise wrap instance. This breaks the linkage used to relate a given promise rejection to the transaction it was scheduled in.
BREAKING Removed support for Node 6, 7, and 9.

The minimum supported version is now Node v8. For further information on our support policy, see: https://docs.newrelic.com/docs/agents/nodejs-agent/getting-started/compa....
- Bumped version of @newrelic/superagent instrumentation to v2.0.0.
- Bumped version of @newrelic/native-metrics to v5.0.0.
BREAKING Bumped version of @newrelic/koa instrumentation to v3.0.0 @newrelic/koa update includes changes to transaction naming in addition to dropping Node versions 6, 7, and 9. See @newrelic/koarelease notes for what was included in v2.0.0 and v3.0.0 updates. https://github.com/newrelic/node-newrelic-koa/blob/master/NEWS.md.
BREAKING max_samples_stored behavior has changed to replace max_samples_per_minute. max_samples_per_minute is no longer a configuration parameter.

The new behavior for max_samples_stored is as follows: "The agent will collect all events up to this number per minute. If there are more than that, a statistical sampling will be collected." This usage of the configuration is consistent with other New Relic APM agents.

If your application has previously used max_samples_per_minute as an upper bound, you may need to lower the threshold to a valid maximum to avoid data being dropped on the server. No larger than 10k is recommended.
Updated utilization callback test to point to a host that can't represent a valid provider. Previously, location where CI provider runs tests could cause test to fail.
Added support for Promise.allSettled() method in Bluebird 3.7.
Bumped mongodb dev dependency past security warning.
Fixed mongodb versioned tests so they are self-contained by using version under test for setup/teardown instead of agent dev-dependency version.
Forced filename resolution if not already cached on module load. This should not occur in normal/non-test scenarios but provides a fall-back to maintain functionality.
Refactored restify versioned tests to be less dependent on the order of asynchronous operations.
Updated README to reference Pug rather than Jade.

Node.js agent v6.14.0

Wed, 28 Oct 2020 00:00:00 +0000

We recommend updating to the latest agent version as soon as it's available. If your organization has established practices that prevent you from upgrading to the latest version, ensure that your agents are regularly updated to a version at most 90 days old. Read more about keeping your agent up to date.

Fixes

Fixed issue where gRPC connection used for infinite tracing could throw if the server shutdown during disconnect of an existing connection.
Fixed bug where errors would still be collected for transactions with ignored error status codes in certain situations.

Improvements

Added Node 14 to CI test coverage.

Many thanks to @jgeurts for the contribution.
Bumped @grpc/grpc-js to 1.1.7.
Bumped @grpc/proto-loader to ^0.5.5.
Updated README for consistency.
Converted errors ignore unit tests to tap API.
Infinite tracing logging and support metric improvements.
- Increased logging level of certain infinite tracing / gRPC errors.
- Decreased logging interval of dropped span warning for infinite tracing.
- Added additional support metrics and logging for infinite tracing.

Node.js agent v6.1.0

Tue, 05 Nov 2019 00:00:00 +0000

New Features

Added @newrelic/aws-sdk module to agent for auto-include on install.
Added splitting of application name using semicolons in the env var.
Instrumented connection.execute for mysql2.

Improvements

@newrelic/native-metrics module is defaulted to disabled in serverless mode.

This can reduce lambda cold-start times by up to 170ms. The native-metrics module can rarely load in serverless environments due to differences from build environment to deployed environment and offers little value in a serverless environment.
Added env var NEW_RELIC_NATIVE_METRICS_ENABLED to enable/disable the native-metrics module
Added a test for querying poolCluster.of()
Added HTTP method to segment attributes for external requests.
Updated the bin/ssl.sh such that it uses verbose output, will exit on first error code, and will refuse to proceed with LibreSSL (which can't generate certs).
Added a clear sub-command to bin/ssl.sh that will allow developers to quickly remove generated ssl/cert files and regenerate (useful is switch between platforms via containers/docker and certs needs to be regenerated)

Fixes

Removed unused mysql bootstrap test code.
Increased timeout for index-bad-version test to reduce flickers on Node 12.
Changed file modification to leverage writeFile for watchFile test. This triggers the watcher in a reasonable amount of time much more consistently.
Removed testing of Bluebird 3.7 on Node v10 until they fix the segfault issue.

Node.js agent v6.2.0

Mon, 25 Nov 2019 00:00:00 +0000

New Features

Added getLinkingMetadata() method to the API.

This new method can be used to retrieve the identifying information for the agent and current active span and trace. Please consult the documentation for more information.
Added getTraceMetadata() to the agent API.

This new method can be used to retrieve the current active Distributed Tracing span and trace ids. Please consult the documentation for more information.
Added an isSampled() method to Transaction and TransactionHandle.

This new method can be used to retrieve the sampling decision made for a given transaction. Please consult the documentation for more information.

Fixes

Upgraded tap to resolve handlebars audit warnings.

Node.js agent v6.3.0

Mon, 27 Jan 2020 00:00:00 +0000

Improvements

Bumped @newrelic/aws-sdk to v1.1.1 from v1.0.0. https://github.com/newrelic/node-newrelic-aws-sdk/blob/master/CHANGELOG.md Notable improvements include:
- Added official support for API promise calls, fixing two critical bugs.
- Added check before applying instrumentation to avoid breaking for very old versions.
Added bindPromise() to Shim prototype for direct usage by instrumentation. Previously, _bindPromise() was a private function in the Shim module.
Updated language in agent to be in line with New Relic Standards.

Fixes

Fixed spelling in configuration error. Thank you to David Ray (@daaray) for the contribution.
Fixed long-log truncation issue in Serverless mode.

Node.js agent v6.4.0

Wed, 12 Feb 2020 00:00:00 +0000

New Features

Added support for W3C Trace Context, with easy upgrade from New Relic trace context.
- Distributed tracing now supports W3C Trace Context headers for HTTP protocols when distributed tracing is enabled. Our implementation can accept and emit both the W3C trace header format and the New Relic trace header format. This simplifies agent upgrades, allowing trace context to be propagated between services with older and newer releases of New Relic agents. W3C trace header format will always be accepted and emitted. New Relic trace header format will be accepted, and you can optionally disable emission of the New Relic trace header format.
- When distributed tracing is enabled with distributed_tracing.enabled: true, the Node agent will now accept W3C's traceparent and tracestate headers when calling TransactionHandle#acceptDistributedTraceHeaders or automatically via http instrumentation. When calling Transaction#insertDistributedTraceHeaders, or automatically via http instrumentation, the Node agent will include the W3C headers along with the New Relic distributed tracing header, unless the New Relic trace header format is disabled using distributed_tracing.exclude_newrelic_header:true.
- Added TransactionHandle#acceptDistributedTraceHeaders API for accepting both New Relic and W3C Trace Context distributed traces.
  
  Deprecated TransactionHandle#acceptDistributedTracePayload which will be removed in a future major release.
- Added TransactionHandle#insertDistributedTraceHeaders API for adding outbound distributed trace headers. Both W3C Trace Context and New Relic formats will be included unless distributed_tracing.exclude_newrelic_header: true.
  
  Deprecated TransactionHandle#createDistributedTracePayload which will be removed in a future major release.
Known issues and workarounds
- If a .NET agent is initiating distributed traces as the root service, you must update that .NET agent to version 8.24 or later before upgrading your downstream Node New Relic agents to this agent release.

Improvements

Improved transaction and trace ID generation.
AWS Lambda
- Added collection of additional AWS Lambda event source meta data.
- Added event type detection for Lambda invocation events.
- Expanded ARN harvest to include ALB and CloudWatch.

Fixes

Fixed issue where Lambda invocation errors were not noticed in Node 10 or Node 12 environments.
Pins Node 12 CI/testing version to v12.15 to avoid breakages with v12.16.0 until cause(s) resolved.
Updated publish-docs script to use npm run instead of make.

Known issues and workarounds

If a .NET agent is initiating distributed traces as the root service, you must update that .NET agent to version 8.24 or later before upgrading your downstream New Relic Node agents to this agent release.

Node.js agent v6.4.1

Thu, 20 Feb 2020 00:00:00 +0000

Improvements

Removed calls to OutgoingMessage.prototype._headers in favor of using public getHeaders API (thanks to @adityasabnis for bringing this to our attention).
Removed engine upper-bound to enable easier experimentation of newer Node versions with the agent for customers.

Please see https://docs.newrelic.com/docs/agents/nodejs-agent/getting-started/compa... for officially supported versions. Incompatibilities are expected for odd-numbered releases, which are not supported, and even-numbered releases before "official" support has been released.
Reduced "... Aggregator data send." log messages to debug level to reduce noise of default logs.
Prevented passing CI with .only() in mocha tests.
Removed CI restriction for Node 12.15. Node shipped a fix for the 12.16 breakage in 12.16.1.
Reduced logging level of raw x-queue-start or x-request-start header values to avoid logging very large values at default logging levels.

Fixes

Bumped @newrelic/aws-sdk version to v1.1.2 from v1.1.1. https://github.com/newrelic/node-newrelic-aws-sdk/blob/master/CHANGELOG.md

Notable improvements include:
- Fixed issue where instrumentation would crash pulling host and port values when AmazonDaxClient was used as the service for DocumentClient.
Fixed issue where disabled agent would return an empty string instead of an empty object from API getLinkingMetadata().

This issue would cause the @newrelic/winston-enricher module to crash when attempting to inject log metatdata.

Known issues and workarounds

If a .NET agent is initiating distributed traces as the root service, you must update that .NET agent to version 8.24 or later before upgrading your downstream New Relic Node agents to this agent release.

Node.js agent v6.4.2

Thu, 27 Feb 2020 00:00:00 +0000

Improvements

Support new http[s] get/request function signature in Node v10+
Added the following Span attributes:
- http.statusCode
- http.statusText
The above attributes will be replacing the following deprecated attributes:
- httpResponseCode
- response.status
- response.statusMessage
The deprecated attributes will be removed with the next major release of the agent.
Updates version check to be in alignment with our stated support policy and the version constraints in package.json
Redacts individual certificate configuration values before sending to server settings. When configured, these values will now appear like: {certificates.0: ****}.

Known issues and workarounds

If a .NET agent is initiating distributed traces as the root service, you must update that .NET agent to version 8.24 or later before upgrading your downstream New Relic Node agents to this agent release.

Node.js agent v6.5.0

Thu, 19 Mar 2020 00:00:00 +0000

Improvements

Added error attributes to spans.
- The public api method noticeError() now attaches exception details to the currently executing span. Spans with error details are now highlighted red in the Distributed Tracing UI. Also, the attributes error.class and error.message are added to the span. If multiple errors are recorded for a single span, only the final error's attributes will be added to the span.
- Added ID of the span in which an error occurred to the corresponding transaction error event.
Added new public API methods addCustomSpanAttribute and addCustomSpanAttributes to add attributes to the currently executing span.
Added new attributes to http outbound spans: http.statusCode and http.statusText.
Updated W3C Trace Context "Known Issues and Workaround" notes with latest accurate consideration.
Converted unit tests to run via tap. Removes mocha dependency.

Fixes

Fixed route naming when hapi's pre route handlers share functions.
Fixed child_process instrumentation so that handlers can be effectively removed when attached via .once() or manually removed via removeListener().

Node.js agent v6.6.0

Mon, 20 Apr 2020 00:00:00 +0000

New Features

Added support for Infinite Tracing on New Relic Edge.

Infinite Tracing observes 100% of your distributed traces and provides visualizations for the most actionable data so you have the examples of errors and long-running traces so you can better diagnose and troubleshoot your systems.

You configure your agent to send traces to a trace observer in New Relic Edge. You view your distributed traces through the New Relic’s UI. There is no need to install a collector on your network.

Infinite Tracing is currently available on a sign-up basis. If you would like to participate, please contact your sales representative.

Improvements

Added function_version to lambda metadata payload.

This is pulled from an invocation's context.functionVersion value.

Node.js agent v6.7.0

Thu, 07 May 2020 00:00:00 +0000

New Features

Added a configurable-length span queue to Infinite Tracing: infinite_tracing.span_events.queue_size.

The queue length can be modified to balance the needs of keeping full traces against trade-off of memory usage and CPU overhead in a high-throughput application.

Improvements

Updated remaining /api unit tests to use tap API.
Updated @grpc/grpc-js to v1.0.3.

Fixes

Fixed issue where API.instrumentLoadedModule could throw an exception when it failed.

Error details will now be caught and logged.
Resolved non-proxy minimist security warnings by bumping dependencies.

These updates only impact development dependencies. Thank you to @devfreddy for the contribution.
- Updated minimist sub-deps to resolve most related security warnings.
- Updated tap to resolve remaining tap security warnings.
- Updated @newrelic/proxy.

Node.js agent v6.8.0

Thu, 21 May 2020 00:00:00 +0000

New Features

Bumped @newrelic/native-metrics to ^5.1.0.

Upgraded nan to ^2.14.1 to resolve 'GetContents' deprecation warning with Node 14. This version of the native metrics module is tested against Node 14 and includes a pre-built binary download backup for Node 14.

Improvements

Added whitespace trimming of license key configuration values.

Previously, when a license key was entered with leading or trailing whitespace, it would be used as-is and result in a validation failure. This most commonly occurred with environment variable based configuration.
Moved to GitHub actions for CI.
Updated PR template and added initial issue templates.
Converted most of the collector API unit tests to use the tap API. Split larger test groupings into their own test files.

Node.js agent v6.7.1

Thu, 14 May 2020 00:00:00 +0000

Fixes

Added synthetics headers to transaction event intrinsics for Distributed Tracing
Fixed stale comment documentation with regards to segment recording

Node.js agent v6.9.0

Mon, 08 Jun 2020 00:00:00 +0000

New Features

Added AWS API Gateway V2 support to Lambda instrumentation.
Added 'transaction.name' intrinsic to active span at time transaction name is finalized.

This enables finding transaction name for traces that may not have a matching transaction event.
Added 'error.expected' attribute to span active at time expected error was noticed.

Improvements

Dropped errors earlier during collection when error collection is disabled.

Error attributes will no longer show up on spans when error collection has been disabled. Other unnecessary work will also be avoided.
Removed allocation of logging-only objects used by transaction naming when those log levels are disabled.
Upgraded escodegen from 1.12.0 to 1.14.1.
Upgraded readable-stream from 3.4.0 to 3.6.0.
Upgraded @grpc/proto-loader from 0.5.3 to 0.5.4.
Converted facts unit test to use tap API.
Converted transaction 'finalizeName...' unit tests to use tap API.
Added several items to .npmignore to prevent accidental publishing.
Fixed Redis client w/o callback versioned test flicker.

Doesn't end transaction until error encountered. Increases wait time for first operation which has to complete for the second operation to be successful.

Node.js agent v7.0.0

Mon, 09 Nov 2020 00:00:00 +0000

Improvements

Added official parity support for Node 14
Dropped Node v8.x support. For further information on our support policy, see: https://docs.newrelic.com/docs/agents/nodejs-agent/getting-started/compa....
- Removed Node v8.x from CI
- Adds check that minimum Node version is >=10 and warns if >=15
- Sets Node engine to >=10
- BREAKING Dropped support for Node v8.x HTTP get() function signature
- Strictly uses global.URL class in http core instrumentation
- Removes Nodejs 8.x - 9.x checks
- Update New Relic Dependencies to versions with updated Node version support
- @newrelic/aws-sdk v3.0.0
- @newrelic/koa v5.0.0
- @newrelic/native-metrics v6.0.0
- @newrelic/superagent v4.0.0
- @newrelic/test-utilities v5.0.0
BREAKING Removed deprecated setIgnoreTransaction API method
BREAKING Removed deprecated httpResponseCode, response.status and httpResponseMessage http response attributes
BREAKING Removed the api.custom_parameters_enabled configuration item and associated environment variable NEW_RELIC_API_CUSTOM_PARAMETERS. Please use api.custom_attributes_enabled instead
BREAKING Removed deprecated Distributed Tracing API methods, createDistributedTracePayload() and acceptDistributedTracePayload()
Finalized removal of ignored_params and capture_params
Added additional logging to W3C Trace Context header creation

Node.js agent v7.0.1

Tue, 17 Nov 2020 00:00:00 +0000

Improvements

Fixed a bug where spans queued up during backpressure situations would be improperly formatted and ultimately dropped when sent to an Infinite Tracing trace observer.
Updated @grpc/grpc-js to version v1.2.0.
Updated tap to clear up npm audit issues around lodash sub-dependency.

Node.js agent v7.0.2

Tue, 01 Dec 2020 00:00:00 +0000

Fixes

Fixes a bug where the http.statusCode attribute was not being captured for an async invoked lambda.
Fixed typos in code comments, documentation, and debugging logger messages. Thank you @TysonAndre for the contribution.

Node.js agent v7.1.0

Tue, 05 Jan 2021 00:00:00 +0000

Improvements

Added Fastify v3 support.
Upgraded grpc version.

Fixes

Fixed SQL traces being generated with invalid ID.
Fixed log message for minimum supported Node.js version.
Fixed empty log message for Infinite Tracing connections.
Fixed bug that prevented users from changing Infinite Tracing queue size.

Node.js agent v7.1.1

Mon, 01 Feb 2021 00:00:00 +0000

Improvements

Added workflow for publishing to npm when a v* tag is pushed to the repo.
Fixes resolveMx test by using example.com for a valid exchange.

Fixes

Upgrade @grpc/grpc-js to v1.2.5 to fix non-propagation of internal http2 errors Now allows minor and patch auto-updates.

Node.js agent v7.1.3

Tue, 09 Mar 2021 00:00:00 +0000

Improvements

Removed requirement to configure application name when running in AWS Lambda (serverless mode).

Currently New Relic doesn't leverage the application name for Lambda invocations. The agent now defaults the application name in serverless mode to remove the requirement of end-user configuration while handling cases if it were to be leveraged in the future.
Improved clarity of logging between 'no log file' or disabled agent startup issues.
- Logs no-config file error to initialized logger (stdout) in addition to existing console.error() logging.
- Adds specific message to no config file separate from being disabled.
Stopped binding/propagating segments via setImmediate for ended transactions.
Bumped @grpc/grpc-js to ^1.2.7.
Added support metric to be able to track usage of cert bundle via usage of custom certificates.

Fixes

Fixed bug where agent would attempt to call the 'preconnect' endpoint on the redirect host returned by the previous 'preconnect' call when reconnecting to the New Relic servers.

The 'preconnect' calls now always use the original agent configuration value. Subsequent endpoints (connect, harvest endpoints, etc.) will continue to leverage the new redirect host value returned by 'preconnect.' The original config values are no longer overridden.
Fixed issue where a call to transaction.acceptDistributedTraceHeaders would throw an error when the headers parameter is a string.
Removed index-bad-config test which tested a no-longer possible use-case.
Removed license-key test logic from serverless-harvest test.

Serverless mode does not require a license key as data transfer is handled by the integration.
Removed aws-sdk versioned test filtering.
Removed unused Travis CI scripts.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v7.2.0

Tue, 23 Mar 2021 00:00:00 +0000

Improvements

The NEW_RELIC_NO_CONFIG_FILE environment variable is no longer needed to run the agent without a configuration file.
- If a configuration file is used with agent configuration environment variables, the environment variables will override the corresponding configuration file settings.
Added feature flag to allow disabling of certificate bundle usage.

Deprecation Warning: The certificate bundle included by New Relic will be disabled by default and then fully removed in later major versions. We recommend testing with the certificate_bundle feature flag set to false to determine if you will need to modify your environment or setup your own appropriate bundle. Example configuration: feature_flag: { certificate_bundle: false }.
Set distributed tracing to enabled in the newrelic.js template configuration file supplied with the agent.
Added module root to shim.require() logging to aid debugging.
Migrated from .npmignore to 'files' list in package.json to control which files are packaged.

Thank you to @JamesPeiris for the initial nudge via PR to move in this direction.
Converted remaining collector unit tests to use tap API.
Added linting to scripts in /bin folder.

Linting rules added are slightly more permissive than production rules and allow full ecma 8.
Added new developer documentation to /docs folder.

This information is ported over from private GHE wiki used prior to going open source. S/O @astorm for original versions of the function wrapping and module instrumentation docs.

Fixes

Fixed bug where applications with multiple names on a dynamically named host (UUID like) would have instances consolidated, losing per-host breakdowns.

Removed 'host' from agent 'identifier' override to prevent server safety mechanism from kicking in. Host will still be used to identify unique agent instances, so was unnecessary to include as part of the identifier. This also resulted in additional processing overhead on the backend. The identifier override is still kept in place with multiple application names to continue to allow uniquely identifying instances on the same host with multiple application names where the first name may be identical. For example app_name['myName', 'unique1'] and app_name['myName', 'unique2']. These names would consolidate down into a single instance on the same host without the identifier override.
Fixed bug where truncated http (external) or datastore segments would generate generic spans instead of appropriate http or datastore spans.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v7.1.2

Tue, 23 Feb 2021 00:00:00 +0000

Improvements

Bumped @newrelic/aws-sdk to ^3.1.0.

Fixes

Fixed bug where the agent failed to reconnect to Infinite Tracing gRPC streams on Status OK at higher log levels.
- Node streams require all data be consumed for the end/status events to fire. We were only reading data at lower log levels where we'd use/log the data. This resulted in a failure to reconnect and 'ERR_STREAM_WRITE_AFTER_END' errors. The agent now always listens to the 'data' event, even if not logging, and will also reconnect (with 15 second delay) on any 'ERR_STREAM_WRITE_AFTER_END' error.
Removed initial harvest send() call on streaming span event aggregator to prevent warning in logs.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v7.2.1

Mon, 29 Mar 2021 00:00:00 +0000

Improvements

Bumped @grpc/grpc-js to ^1.2.11.
Bumped @grpc/proto-loader to ^0.5.6.

Fixes

Fixed issue where capturing axios request errors could result in a memory leak.

The agent now clears error references on transaction end, which are not used for later processing. Errors returned from 'axios' requests contain a reference to the request object which deeper down has a handle to a promise in handleRequestError. The TraceSegment associated with that promise has a handle to the transaction, which through the error capture ultimately kept the promise in memory and prevented it from being destroyed to free-up the TraceSegment from the segment map. This change also has the benefit of freeing up some memory early for transactions held onto for transaction traces.
Agent no longer propagates segments for promises via async-hooks when the transaction associated with the parentSegment has ended.

This change reduces the amount of context tracking work needed for certain rare edge-case scenarios involving promises.
Added active transaction check to wrappedResEnd to prevent unecessary work for ended transactions in the case of multiple Response.prototype.end() invocations.
Dev-only sub-dependency bump of 'y18n' to clear npm audit warnings.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v7.3.0

Tue, 06 Apr 2021 00:00:00 +0000

New Features

Added new feature-flag 'new_promise_tracking' which enables cleaning up of segment references on native promise resolve instead of destroy. Includes usage of async-await. This can be enabled via feature_flag: { new_promise_tracking: true } in the config file or NEW_RELIC_FEATURE_FLAG_NEW_PROMISE_TRACKING=1 in your ENV vars.

Applications with heavy promise usage or high-throughput applications with some promise usage should see moderate to high reduction in memory usage and may see a slight reduction in CPU usage. A bump in throughput may also be noticed in some cases. Results will vary by application.

If you are experiencing high overhead levels with your promise usage and the agent attached, we recommend testing your application with 'new_promise_tracking' set to true to see if overhead is reduced. You'll also want to verify your data is still being captured correctly in case it falls into a known or unknown limitation of this approach. NOTE: chaining of promise continuations onto an already resolved promise across an async hop (scheduled timer) will result in state-loss with this new functionality turned on. This is a less-common use-case but worth considering with your applications.

Fixes

Fixed memory leak introduced when Infinite Tracing is enabled.

When Infinite Tracing endpoints reconnected they would instantiate a new gRPC client prior to calling client.recordSpan(). It appears several objects created by grpc-js (ChannelImplementation and child objects, promises, etc.) are held in memory indefinitely due to scheduled timers even when the client is no-longer referenced and the associated stream closed. We now avoid this situation by only creating the client once and then reusing it to establish new stream connections.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v7.3.1

Wed, 14 Apr 2021 00:00:00 +0000

Fixes

Fixed issue with new_promise_tracking feature flag functionality where segments for ended transactions would get propagated in certain cases by promises that had no continuations scheduled (via await or manually).

If you are experiencing high overhead levels with your promise usage and the agent attached, we recommend testing your application with new_promise_tracking set to true to see if overhead is reduced. You'll also want to verify your data is still being captured correctly in case it falls into a known or unknown limitation of this approach.

NOTE: With this new functionality turned on, chaining of promise continuations onto an already resolved promise across an async hop (scheduled timer) will result in state-loss. This is a less-common use-case but worth considering with your applications.

Deprecation Warning: The certificate bundle automatically included by New Relic when using the certificates configuration (commonly with proxies) will be disabled by default in the next major version. This is currently targeted for sometime in May. The bundle will be fully removed in later major versions. We recommend testing with the 'certificate_bundle' feature flag set to false to determine if you will need to modify your environment or setup your own appropriate bundle. Example configuration: feature_flag: { certificate_bundle: false }.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v7.4.0

Tue, 11 May 2021 00:00:00 +0000

Features

Added flaky_code and success_delay_ms handling of flaky grpc connections to infinite tracing.
Logged all New Relic metadata env vars at startup.

Improvements

Updated third party notices and manifest for husky and lint-staged.
Updated redis versioned tests to use unique DB indexes per file to avoid collisions and flushing of in-progress tests.
Pinned hapi 17 versioned tests to only minor/patch versions within 17.x.
Bumped timeout for redis versioned tests.
Wired up husky + lint staged to execute linting on all changed files in pre-commit hook.
Added resources to README to highlight external modules that customers should be aware of and possibly use for their applications.
Handled a proxy misconfiguration of collector and log an actionable warning message.
Fixed images for improved reader experience.

Thank you to @henryjw for the contribution.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v7.5.1

Mon, 21 Jun 2021 00:00:00 +0000

Improvements

Moved all integration tests that required secrets to the smoke folder.
Fixed LASP/CSP tests so they don't skip on runs where secrets are available.
Modified self-signed SSL cert to use 'localhost' instead of 'ssl.lvh.me' for SSL testing.
Removed unnecessary trace observer configuration validation for host and port.

Bug Fixes

Fixed loading config from the main module's directory. Thank you @alexpls for the contribution.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v7.5.0

Tue, 01 Jun 2021 00:00:00 +0000

Features

Added default support for config files with a 'cjs' extension (newrelic.cjs) in addition to newrelic.js.

Thank you to @Maddemacher for the contribution!
Added ability to specify a custom config file name with the NEW_RELIC_CONFIG_FILENAME environment variable.

Thank you to @Maddemacher for the contribution!

Improvements

Bumped @newrelic/test-utilities to ^5.1.0.
Replaced deprecated util.isArray with Array.isArray.
Removed unused listenerCount method on Shim.
Properly bootstraped husky as a prepare script.
Removed commented-out console log from fastify instrumentation.

Bug Fixes

Fixed issue when using the 'new_promise_tracking' feature flag where segment mapping may not get cleaned up for promises which never resolve but have all references removed (and thus get cleaned up by GC).

Adds segment cleanup on 'destroy' when using 'new_promise_tracking' feature flag in addition to the existing 'promiseResolve' hook. Unfortunately, preventing leaks for this edge-case does come with additional overhead due to adding another hook. Memory gains from feature flag usage should still be worth the trade-off and reduced garbage collection may offset perf/CPU impacts or event still result in net gain, depending on the application.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v8.0.0

Mon, 26 Jul 2021 00:00:00 +0000

Notes

Added official parity support for Node 16.
BREAKING: Dropped Node v10.x support. For further information on our support policy, see: https://docs.newrelic.com/docs/agents/nodejs-agent/getting-started/compatibility-requirements-nodejs-agent.
- Upgraded @newrelic/superagent @newrelic/aws-sdk @newrelic/koa @newrelic/native-metrics and @newrelic/test-utilities to the latest major versions.
- Refactored creation of span event aggregator to prevent crash of gRPC when running on invalid Node.js version.
- Added check for minimum node version >= 12.
- Set package.json engines node field >= 12 and npm field to >=6.
- Removed Node v10 from ci workflow and smoke-test version matrix.
- Removed comments around replacing temporarilyOverrideTapUncaughtBehavior test helper function.
- Removed non-applicable semver checks for versions the agents no longer supports.
BREAKING: The agent no-longer includes the New Relic certificate bundle automatically when using the 'certificates' configuration (commonly with proxies). If you find this breaking your current environment, you may leverage a feature-flag to temporarily restore this functionality. Example configuration: feature_flag: { certificate_bundle: true }. In this case, we recommend getting a certificate bundle for your environment such as the one from Mozilla. The New Relic bundle and feature flag will be fully removed in next major release.
- Defaulted config.feature_flags.certificate_bundle to false.
BREAKING: Removed serverless_mode as a feature flag.

The standard serverless_mode configuration still exists.
Added hapi 19 and 20 to versioned tests for Node.js >=12 and <16
Added hapi ^20.1.2 to versioned tests for for Node.js >=16
Upgraded tap to v15.
Upgraded https-proxy-agent to v5.0.0.
Updated linting to always use latest LTS Node version.
Updated CI and Smoke Test scripts to use setup-node@v2.
Added no-const-assign to eslint ruleset.
Pinned mongodb versioned tests to <4.0.0.

Node.js agent v7.5.2

Wed, 07 Jul 2021 00:00:00 +0000

Bug Fixes

Fixed bug where promise-based cursor methods would not properly measure the duration of execution.

Node.js agent v8.1.0

Thu, 05 Aug 2021 00:00:00 +0000

Notes

Added necessary instrumentation to support v4 of mongodb.
- Explicitly enabled APM for mongodb instrumentation(client.monitorCommands = true)
Fixed issue where Promise based pg.Client.query timings were always in sub-millisecond range.
Fixed bug where API.shutdown would not harvest or keep process active effectively after an agent restart.

The agent will now correctly update its state to 'started' after a reconnect has completed.
Added an eslint rule to verify every file includes the copyright statement.
Fixed the homepage field in package.json to use https in the link to the github repo. Thank you @pzrq for the contribution.

Node.js agent v8.10.0

Mon, 18 Apr 2022 00:00:00 +0000

Notes

Added instrumentation for mysql2/promise.
- This previously only existed in our standalone @newrelic/mysql, but now gives feature partiy between the two.
Removed unused native CPU metric sampler. This logic was no longer getting touched when running Node.js versions higher than 6.1.0.
Fixed promise interceptor from re-throwing errors.
Added transaction naming documentation ported from a discussion forum post.
Added promises.tap.js to mysql2 versioned tests.
Updated @newrelic/test-utilities to latest.
Removed unused test file in restify versioned tests.
Added --strict flag to versioned test runner to properly fail CI runs when test files are not included.

Node.js agent v8.11.1

Fri, 13 May 2022 00:00:00 +0000

Notes

Fixed an issue with winston instrumentation that caused agent to crash when creating a winston logger from an existing instantiated logger.

Node.js agent v8.11.0

Wed, 11 May 2022 00:00:00 +0000

Notes

Added application logging for Winston in the Node.js agent
- Ability to forward logs, send log metrics, and perform local log decoration
- Added application log aggregator to collect logs with adaptive sampling and appropriate max samples stored.
- Added application_logging configuration and env vars with appropriate defaults.
- Added application_logging.enabled configuration value, defaulting to true.
- Set application_logging.forwarding.enabled to false when High-security mode (HSM) is set.
- Enabled log forwarding by default in the example config.
- Added sent, seen, and dropped metrics that collected on every harvest cycle around log lines.
- Added supportability metrics for some popular logging frameworks.
- Added supportability metrics to record if the logging features are enabled.
- Added a storage mechanism to transactions to keep logs until transaction ends.

Removed distributed tracing setting from example config.

Fixed a typo in lib/instrumentation/core/child_process.js.

Thanks to Eito Katagiri (@eitoball) for the contribution.

Support automatic instrumentation of Redis v4.

Bumped moment from v2.29.1 to v2.29.2.

Bumped tap to v16.x.

Updated ansi-regex to resolve a dev dependency audit warning.

Node.js agent v8.11.2

Mon, 23 May 2022 00:00:00 +0000

Notes

Fixed winston instrumentation to no longer coerce every log line to be json.

Node.js agent v8.13.0

Thu, 26 May 2022 00:00:00 +0000

Notes

Moved log forwarding logic to a transport so customer transports are not polluted with NR linking metadata and timestamp and error manipulations.
Prevented transmitting logs when application level logging has been disabled.

Node.js agent v8.12.0

Tue, 24 May 2022 00:00:00 +0000

Notes

Added instrumentation to pino to support application logging use cases: forwarding, local decorating, and metrics.
Added supportability metrics about the data usage bytes of harvested data to the collector endpoints.
Added an optional way to avoid wrapping browser agent script with the {'<script>'} tag when using api.getBrowserTimingHeader. This will ease usage with component-based libraries like React. Thanks to @github-dd-nicolas for the contribution.
Upgraded @grpc/proto-loader to fix a CVE with protobufjs.
Upgraded @newrelic/test-utilities to resolve a dev-only audit warning.

Node.js agent v8.13.1

Fri, 27 May 2022 00:00:00 +0000

Notes

Fixed passing undefined as a formatter options to winston.format.combine

Node.js agent v8.13.2

Tue, 31 May 2022 00:00:00 +0000

Notes

Upgraded protobufjs to resolve CVE-2022-25878

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v8.14.1

Thu, 09 Jun 2022 00:00:00 +0000

Notes

Added defensive code in redis v4 instrumentation to check for opts.socket first before evaluating opts.socket.path. Thanks @RAshidAZ for your contribution!
Updated @grpc/proto-loader to v0.6.13 to pickup security fixes in protobufjs.

Node.js agent v8.16.0

Thu, 21 Jul 2022 00:00:00 +0000

Notes

Automatic application log forwarding is now enabled by default. This version of the agent will automatically send enriched application logs to New Relic. To learn more about about this feature, see the APM logs in context documentation. For additional configuration options, see the Node.js logs in context documentation. To learn about how to toggle log ingestion on or off by account, see our documentation to disable automatic logging via the UI or API.
Added a support statement to our release notes
Added node 18 to CI workflows.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v8.14.0

Mon, 06 Jun 2022 00:00:00 +0000

Notes

Fixed issue with api.getBrowserTimingHeader optional script unwrapping issue with util.format. Thanks for your contribution @github-dd-nicolas
Fixed winston instrumentation to not exit early when winston.createLogger is created without options.
Updated pino instrumentation to not override user log configurations.

Node.js agent v8.15.0

Thu, 07 Jul 2022 00:00:00 +0000

Notes

Added instrumentation for grpc-js unary, streaming, and bidirectional client calls.
Added ability to disable server-side configuration via local configuration setting: ignore_server_configuration or environmental variable of NEW_RELIC_IGNORE_SERVER_SIDE_CONFIG.
Added tests for client, server and bidirectional streaming of gRPC client.
Updated got from 8.3.2 to 11.8.5.
Updated moment from 2.29.2 to 2.29.4

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v8.17.1

Tue, 02 Aug 2022 00:00:00 +0000

Notes

Fixed issue where instrumented code invoked within a @grpc/grpc-js client callback would not get tracked by the agent.

Bound the external client segment to the onReceiveStatus listener to propagate transaction context to the grpc client callbacks.
Fixed issue with truncate in lib/util/application-logging.js. It now checks that the argument is a string before checking its length.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v8.17.0

Wed, 27 Jul 2022 00:00:00 +0000

Notes

Added gRPC server instrumentation.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v8.2.0

Wed, 25 Aug 2021 00:00:00 +0000

Notes

Added a new feature flag unresolved_promise_cleanup that defaults to true only when new_promise_tracking feature flag is set to true. If disabled, this will help with performance of agent when an application has a lot of promises. To disable, in your config set feature_flag.unresolved_promise_cleanup to false or pass in the environment var of NEW_RELIC_FEATURE_FLAG_UNRESOLVED_PROMISE_CLEANUP=false when starting application with agent.

WARNING: If you set unresolved_promise_cleanup to false, failure to resolve all promises in your application will result in memory leaks even if those promises are garbage collected
Supported using connect to route middleware calls.
Removed stubbed out tests in memcached unit tests.
Refactored dropTestCollections in mongo versioned tests to await for all dropCollection operations to be finished before closing connection and returning.
Ported remaining mocha tests in test/unit/instrumentation to exclusively use tap.
Added @newrelic/eslint-config to rely on a centralized eslint ruleset.
Removed integration tests for oracle.
Converted config unit tests to fully use tap API and extracted related tests into more-specific test files.
Added a pre-commit hook to check if package.json changes and run oss third-party manifest and oss third-party notices. This will ensure the third_party_manifest.json and THIRD_PARTY_NOTICES.md up to date
Replaced JSV with ajv for JSON schema validation in tests.
Removed through in lieu of core Node.js implementation of Transform stream in tests.

Node.js agent v8.3.0

Thu, 09 Sep 2021 00:00:00 +0000

Notes

Enabled Distributed Tracing (DT) by default.
- Added ability to configure the maximum number of spans that can be collected per minute via span_events.max_samples_stored and environment variable NEW_RELIC_SPAN_EVENTS_MAX_SAMPLES_STORED.
- Added supportability metric SpanEvent/Limit.
Added support for properly setting the host and port for clustered MongoDB requests.
Fixes issue where .fastify and .default properties would be missing from the fastify export when instrumented.

Instrumentation now sets .fastify and .default properties to the wrapped fastify export function for fastify v3.
Added the following environment variables for the corresponding configuration items:
- config item: transaction_events.max_samples_stored env var: NEW_RELIC_TRANSACTION_EVENTS_MAX_SAMPLES_STORED
- config item: custom_insights_events.max_samples_stored env var: NEW_RELIC_CUSTOM_INSIGHTS_EVENTS_MAX_SAMPLES_STORED
- config item: error_collector.max_event_samples_stored env var: NEW_RELIC_ERROR_COLLECTOR_MAX_EVENT_SAMPLES_STORED
Converted several unit tests to use the tap API.
Changed assertions for two HTTP error message tests to work with all versions of Node.js.

Node.js agent v8.4.0

Tue, 28 Sep 2021 00:00:00 +0000

Notes

Deprecation Warning: Cross Application Tracing (CAT) has been deprecated and will be removed in a future major release. For applications that explicitly disable Distributed Tracing (DT) to leverage CAT, we recommend migrating to DT to avoid loss of cross-service visibility.
- Disables CAT by default. You must explicitly enable CAT along with turning off DT.
- Adds a deprecation warning when CAT is enabled and active (DT disabled).
Fixed issue with clearTimeout that could result in dropping parent segments or spans. This bug resulted in some MongoDB calls being dropped from Transaction Traces and Distributed Traces (spans): https://github.com/newrelic/node-newrelic/issues/922.
Removed warnings from agent tests for no-var eslint rule.
Added support for Cassandra driver v4.0.0 and above.
Fixed issue where DT headers would not be processed by transaction-shim.handleCATHeaders() when CAT was explicitly disabled. This primarily impacts amqplib instrumentation.
Transitioned aws-lambda.test.js to use Tap over Mocha.
Removed warnings from agent for no-var eslint rule.
Refactored transaction-shim, http and http-outbound to use centralized CAT methods in util/cat
Replaced http-outbound test call to use example.com to avoid unpredictable connection resets.
Migrated sql query parser tests to tap
Added more API usage examples.
Added a README to the examples/ folder discussing how to use the examples.
Fixed message-shim test assertion to avoid flakiness based on precision differences(ms vs ns)
Applied new lint rules barring the use of var and preferring the use of const wherever possible.

Node.js agent v8.5.0

Tue, 12 Oct 2021 00:00:00 +0000

Notes

Added full support for Fastify v2 and v3. Fastify instrumentation is now GA.
- Removed fastify feature flag.
- Instrumented Fastify routes by wrapping addHook.
- Added middleware mounting for fastify v3.
- Fixed capturing of mount point for middleware naming.
- Fixed the WebFramework spec definitions for Fastify middleware and route handlers to properly retrieve the IncomingMessage from a request object.
- Added proper definition to middleware handlers so that the relationship to consecutive middleware and route handler are siblings and not direct children.
Added experimental instrumentation for the undici http client behind a feature flag.

To enable undici support, add the following into your config: { feature_flag: { undici_instrumentation: true } }. The support for undici client is Node.js 16.x as it takes advantage of the diagnostics_channel. Lastly, you must be using v4.7.0+ of the undici client for any of the instrumentation to work.

Note: There are currently some state issues if requests to an app are made with keep alive and you have multiple undici requests being made in parallel. In this case, set feature_flag: { undici_async_tracking: false } which avoids these state issues at the cost of some broken segment nesting.

Node.js agent v8.5.2

Tue, 09 Nov 2021 00:00:00 +0000

Notes

Fixed issue where unhandled promise rejections were not getting logged as errors in a lambda execution

Node.js agent v8.5.1

Wed, 03 Nov 2021 00:00:00 +0000

Notes

Fixed bug where failure to retrieve CPU/Memory details for certain Linux distros could result in a crash.

parseProcCPUInfo and parseProcMeminfo now check for null input prior to processing.
Updated README to favor using -r to load the agent vs require('newrelic').
Updated @newrelic/test-utilities to 6.1.1 and applied a global sampling value of 10 for versioned tests.
Migrated utilization unit tests from mocha to tap.
Migrated logger unit tests from mocha to tap.
Cleaned up or added future removal comments for several deprecation warnings.
Added a script and corresponding CI job that will check for PRs that have been merged and not release and notify the team in a private slack channel.
Updated the versioned test runner to always run against minor versions.
Fixed a high severity npm audit failure.

Node.js agent v8.6.0

Wed, 17 Nov 2021 00:00:00 +0000

Notes

Added onResolved instrumentation hook to apply instrumentation prior to module load.

This hook fires after the module filepath has been resolved just prior to the module being loaded by the CommonJS module loader.
Fixed issue where recordConsume was not binding consumer if it was a promise
Pinned mongo versioned tests up to 4.2.0 until we can address #982
Introduced a context management API to be used in place of manually calling tracer.segment get/set.

Node.js agent v8.7.0

Tue, 04 Jan 2022 00:00:00 +0000

Notes

Updated onResolved instrumentation hook to only be called the first time we see a specific module filepath resolved.
Removed tracer.segment in place of direct usage of context manager.
Fixed an issue where multiple calls to instrumentLoadedModule resulted in re-instrumenting the same module.
Fixed issue where instrumentLoadedModule would return true even if the instrumentation handler indicated it did not apply instrumentation.
Added support metrics for tracking when instrumentation was applied per module.
- Supportability/Features/Instrumentation/OnResolved/<module-name>
- Supportability/Features/Instrumentation/OnResolved/<module-name>/Version/<major version>
- Supportability/Features/Instrumentation/OnRequire/<module-name>
- Supportability/Features/Instrumentation/OnRequire/<module-name>/Version/<major version>
Fixed issue where expected status code ranges would not be parsed until ignored status codes were also defined.
Added an input changelog_file to pass in name of changelog. This defaults to NEWS.md but some repos use CHANGELOG.md
Abstracted bin/prepare-release.js to work against other repositories.
Added reusable prepare-release workflow that can be referenced in all other newrelic Node.js repositories.
Updated pending PRs workflow to check all repos the team owns.
Changed the event type from pull_request to pull_request_target to allow for auto assign of PRs to the Node.js Engineering Board
Fixed add to board workflow to properly pass repository secrets into reusable board workflow.
Changes token used to post issues to org level project board
Runs versioned tests for external modules against tests defined in the external repository instead of tests published in npm modules.
Added a reusable workflow to automatically add issues to the Node.js Engineering Board when created.
Added CI job to update system configurations with new agent version on release.
Moved methods.js under bluebird versioned test folder.

Node.js agent v8.7.1

Tue, 18 Jan 2022 00:00:00 +0000

Notes

Bumped @newrelic/aws-sdk to ^4.1.1.
Upgraded @newrelic/test-utilities to ^6.3.0.

Includes helpers.getShim so sub packages properly execute.
Resolved dependabot and certain npm audit warnings.
Automation and CI improvements:
- Added a script to be used by agent developers to add a PR to docs-website after the release of agent.
- Changed the trigger for post release jobs.
- Updated the create-release-tag script to pass in workflows to check before creating tag.
  - Fixed create-release-tag to properly filter out all async workflow run checks
  - Updated agent release to pass in a different list of workflows vs the default
- Fixed release creation reusable workflow by passing in repo to bin/create-release-tag.js and bin/create-github-release.js.
- Added workflow_dispatch to Agent Post Release workflow for manual testing.
- Added a reusable workflow to create a release tag, publish to NPM and publish a GitHub release.
  - Updated agent release workflow to reference reusable workflow.
  - Added a new workflow to update RPM and publish API docs on a published release event type.

Node.js agent v8.8.0

Wed, 23 Feb 2022 00:00:00 +0000

Notes

Updated AWS metadata capture to utilize IMDSv2.
Fixed link to discuss.newrelic.com in README
Updated minimum Node version warning to output current Node version from process.
Bumped @newrelic/native-metrics to ^7.1.1.
Added Nextjs to a framework constant within the webframework-shim.
Updated shim to pass active segment to inContext callback.
Bumped @grpc/grpc-js to ^1.5.5.
Bumped @grpc/proto-loader to ^0.6.9.
Bumped @newrelic/superagent to ^5.1.0.
Bumped @newrelic/koa to ^6.1.0.
Bumped async to ^3.2.3.
Resolved several npm audit warnings for dev deps.
Fixed Post Release workflow by properly configuring git credentials so it can push API docs to branch
Added set -e in publish docs script to exit on possible failures
Removed redundant npm ci in publish API docs script
Added ability to ignore certain PRs in bin/pending-prs.js report to slack
Updated README to include @newrelic/pino-enricher as an external module.
Fixed documentation in a sample of the Datastore Instrumentation for Node.js.
Added a new mongo:5 container to npm run sevices to test mongodb driver >=4.2.0.
Fixed conditions in post release workflow to function when triggered via successful release and manual invoked.
Updated method for retrieving agent version from repository by using cat package.json | jq .version
Fixed minor formatting and spelling issues in create-docs-pr.js.
Fixed an issue with the docs PR script that assumed \n in the NEWS.md file when extract version and release date

Node.js agent v8.9.0

Tue, 15 Mar 2022 00:00:00 +0000

Notes

Added support for initializeUnorderedBulkOp, and initializeOrderedBulkOp in mongodb v3 instrumentation.

Thanks to Denis Lantsman (@dlants) for the contribution.
Updated logger to delay logging until configuration is parsed. The logger will now queue all log entries that occur before the agent can parse the configuration.

Thanks to Cody Landry (@codylandry) for the contribution.
Added NEW_RELIC_ALLOW_ALL_HEADERS as a boolean environment variable, same behavior as existing allow_all_headers.
Updated the AWS IMDBS v2 endpoint to use latest to align with the internal agent specification.
Bumped @newrelic/koa to ^6.1.1.
Added Next.js to External Modules list in README.
Updated mysql and mysql2 versioned tests to run against their own databases on the MySQL instance.
Removed upper-bound testing from restify versioned tests so future major versions will be covered.
Removed upper-bound testing from mysql2 versioned tests to cover existing and future major versions.

Continues to skip version 1.6.2 which had a bug that broke tests which was resolved in 1.6.3.
Updated @hapi/hapi Node 16 versioned test runs to run against @hapi/hapi >=20.1.2 so future major releases will be ran.
Fixed sparse checkout of non-default branch for external versioned tests.
Added external versioned tests for the Apollo Server plugin instrumentation.
Added nock delay to test timeouts in utilization integration tests.
Added newrelic-node-nextjs to external versioned tests to be run on every PR.
Updated external version test running to support more test scenarios.
- Adds test/versioned-external to lint ignore to avoid issues for scripts in tests that auto run linting tools (next/react).
- Adds index.js and nr-hooks.js to files automatically checked-out for test runs.

Node.js agent v8.9.1

Tue, 22 Mar 2022 00:00:00 +0000

Notes

Fixed shim.wrapReturn to call Reflect.construct in construct Proxy trap. Also including newTarget to work with inherited classes.
Added link to New Relic Node.js Examples repository.
Excluded installing dependencies in versioned-external folders when running integration tests.

Node.js agent v9.0.0

Wed, 03 Aug 2022 00:00:00 +0000

Notes

Added official parity support for Node 18.
BREAKING: Dropped Node 12.x support. For further information on our support policy, see Node agent compatibility.
- Upgraded @newrelic/superagent @newrelic/aws-sdk @newrelic/koa @newrelic/native-metrics and @newrelic/test-utilities to the latest major versions
- Removed Node 12 from CI workflows.
- Updated engines stanza to be >=14.
- Updated all versioned tests stanza to be >=14
- Converted fs.rmdirSync to fs.rmSync in test/unit/config/config-location.test.js.
- Converted uses of /dev/null to os.devNull in tests.
BREAKING: Removed certificate bundle from agent. The configuration value config.feature_flag.certificate_bundle will no longer work.

The agent no-longer includes the New Relic certificate bundle when using the 'certificates' configuration (commonly with proxies). If you find this breaking your current environment, we recommend getting a CA bundle such as the one from Mozilla.
BREAKING: The agent now excludes port when making external HTTPS requests to port 443 to be in compliance with the spec and other agents.

Previous external segments would be named External/example.com:443 when using default HTTPS port. The external segment will now be named External/example.com.
BREAKING: Removed ability to disable async hooks based promise context tracking via the await_support feature flag. This also removes the legacy Promise instrumentation.

Released the await_support feature flag. The agent now relies on async_hooks to track async promise propagation. The net result is the if you had feature_flag.await_support set to false, the legacy instrumentation tracked every function in a promise chain as a separate segment.
BREAKING: Removed instrumentation for the obsolete oracle npm package.
BREAKING: Updated the minimum version of pg to be 8.2.x. This is the earliest support version that runs on Node 14+.
BREAKING: Updated the minimum supported version of hapi to be >= v20.0.0. All versions < v20.0.0 are deprecated by hapi for security reasons, see their support policy.
- Dropped tests for hapi < v20.0.0.
Bumped @newrelic/test-utilities to ^7.0.0.

This new version of test utilities defaults the number of concurrent jobs to currently available CPUs. For local development on modern machines, this can speed up full versioned test runs by 30-40%.
Introduced JOBS ENV var for agent versioned test runs to control number of attempted concurrent test folder runs. Set to 4 for CI runs in GHA.
Removed the async library from distributed tracing and pricing integration tests

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.0.1

Thu, 18 Aug 2022 00:00:00 +0000

Notes

Fixed properly setting logging metrics when using custom levels with winston.
Handled setting the logging metric name to UNKNOWN when using custom log levels in pino and/or winston. Thanks for your contribution @billouboq.
Removed unnecessary unit test and fixture for OSS license generation.
Updated versioned tests to remove the use of the async module.
Removed 3rd party async library from agent code.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.0.2

Tue, 23 Aug 2022 00:00:00 +0000

Notes

Added unit test suite for lib/logger.js.
Added destructive integration test for Configuration instantiation.
Added a special case to serialize BigInts when sending them to New Relic. BigInts can appear in log data that our customers may be trying to forward.
Exposed compressed_content_encoding configuration and defaulted it to "gzip".
Fixed public jsdoc generation.
Addedminami back as a dev dependency for use with jsdoc-conf.js.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.0.3

Tue, 06 Sep 2022 00:00:00 +0000

Notes

Updated gRPC client instrumenation to respect grpc.record_errors when deciding to log errors on gRPC client requests.
Fixed transaction name finalization to properly copy the appropriate transaction name to root segment.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.10.0

Thu, 09 Feb 2023 00:00:00 +0000

Notes

Exposed a method on API to obfuscate sql: newrelic.obfuscateSql.
Add support for Multi Value Parameters from API Gateway and ALB events for Lambdas.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.1.0

Thu, 22 Sep 2022 00:00:00 +0000

Notes

Added experimental loader to support instrumentation of CommonJS packages in ECMAScript Module(ESM) applications.
- It only supports versions of Node.js >= 16.12.0.
- It is subject to change due to its experimental stability.
Enhanced supportability metrics for ESM support.
- Added new metrics to track usage of ESM loader(Supportability/Features/ESM/Loader and Supportability/Features/ESM/UnsupportedLoader).
- Updated instrumentation map to include an optional "friendly name" for tracking metrics.
Enabled re-throwing ESM import errors of newrelic.js so that the user is informed to rename it to newrelic.cjs
Fixed an issue with mongodb instrumentation where IPv6 address([::1]) was not getting mapped to localhost when setting the host attribute on the segment.
Added a test ESM loader to properly mock out agent in versioned tests.
Added ESM versioned tests for: express, pg, mongodb, and @grpc/grpc-js.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.10.1

Mon, 13 Feb 2023 00:00:00 +0000

Notes

Fixed error with Lambda/ALB serverless instrumentation when no response headers were included

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.11.0

Wed, 08 Mar 2023 00:00:00 +0000

Notes

Added instrumentation for Prisma(@prisma/client).
- Miniumum supported version of @prisma/client is 4.0.0.
- Captures spans for queries.
  - It names them based on the model and action.(i.e. Datastore/statement/Prisma/user/create)
  - For statements and queries using the $queryRaw, $executeRaw, $queryRawUnsafe, and $executeRawUnsafe the names will be aligned with the raw SQL.(i.e. Datastore/statement/Prisma/User/select)
- Captures database metrics for all statements and queries.
- Captures SQL Traces.
- Provides connection between application and database server via service maps.

Huge shoutout to @osmanmrtacar for the original contribution

Updated @grpc/protoloader from 0.7.4 to 0.7.5.
Updated @grpc/grpc-js from 1.8.7 to 1.8.8.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.10.2

Tue, 21 Feb 2023 00:00:00 +0000

Notes

Fix: Replaced request.aborted with response.close in HTTP instrumentation.
Fixed issue where setting NEW_RELIC_GRPC_IGNORE_STATUS_CODES wasn't properly parsing the codes as integers, thus not ignoring reporting errors of certain status codes.
Upgraded @grpc/grpc-js from 1.8.4 to 1.8.7.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.12.0

Tue, 14 Mar 2023 00:00:00 +0000

Notes

This version of the agent was not available, and has been deprecated. The NPM release pipeline did not run successfully. New Relic recommends installing Node agent v9.12.1 instead.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.12.1

Wed, 15 Mar 2023 00:00:00 +0000

Notes

Added ability to mark errors as expected when using newrelic.noticeError, by adding an optional boolean:
- newrelic.noticeError(error, {customAttributes}, true|false) when there are custom error attributes.
- newrelic.noticeError(error, true|false) if there are no custom error attributes.
- expected errors do not affect error metrics or Apdex.
Added ability to disable distributed tracing for aws-sdk 3.290.0 and higher.
Updated README header image to latest OSS office required images
Updated @grpc/grpc-js from 1.8.8 to 1.8.9

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.13.0

Mon, 20 Mar 2023 00:00:00 +0000

Notes

Updated http instrumentation to no longer remove the x-new-relic-disable-dt header when using AWS SDK v3. This was done to prevent the "The request signature we calculated does not match the signature you provided. Check your key and signing method." error from AWS SDK.
Added an API method setUserID to provide an ability to associate a unique identifier with a transaction event, transaction trace and errors within transaction. The attribute will be enduser.id.
Added default configuration for security agent.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.14.1

Thu, 23 Mar 2023 00:00:00 +0000

Notes

Restored assigning loaded version of agent to require.cache as __NR_cache instead of a symbol to properly detect attempts at loading agent twice.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.14.0

Thu, 23 Mar 2023 00:00:00 +0000

Notes

Added new API function called setErrorGroupCallback, which provides a way for you to customize the error.group.name attribute of errors that are captured by the agent. This attribute controls how the Errors Inbox functionality groups similar errors together. To learn more about this function, please refer to our example app.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.15.0

Tue, 04 Apr 2023 00:00:00 +0000

Notes

Added a new configuration option heroku.use_dyno_names to specify whether or not to use process.env.DYNO for naming the host name and display host. This option defaults to true. If you are on heroku and do not want this functionality set heroku.use_dyno_names to false. You can also control this configuration options with the environment variable of NEW_RELIC_HEROKU_USE_DYNO_NAMES. Thanks @benney-au-le for your contribution 🚀

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.3.0

Mon, 17 Oct 2022 00:00:00 +0000

Notes

Added instrumentation to bunyan to support application logging use cases: forwarding, local decorating, and metrics. Big thanks to @brianphillips for his contribution
Added c8 to track code coverage.
Added documentation about custom instrumentation in ES module applications

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.2.0

Thu, 06 Oct 2022 00:00:00 +0000

Notes

Added ability to instrument ES Modules with the New Relic ESM Loader.
- Example ESM application
Added support for custom ESM instrumentation.
- There is structure to registering custom ESM instrumentation. Set the relative path to the instrumentation entry point via api.esm.custom_instrumentation_entrypoint
- Sample custom ESM instrumentation entrypoint
- All the newrelic.instrument* methods will still work except newrelic.instrumentLoadedModule. This is because it is geared toward CommonJS modules.
Added test for asserting ESM loader functionality on ESM-only package
Added supportability metric of Supportability/Nodejs/Collector/MaxPayloadSizeLimit/<endpoint> when max_payload_size_in_bytes configuration value is exceeded.
Removed application_logging.forwarding.enabled stanza from sample config as the feature is now enabled by default.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.4.0

Mon, 24 Oct 2022 00:00:00 +0000

Notes

Removed legacy agent async context propagation. The default behavior is now what was behind the feature_flag.new_promise_tracking. You can read more about the difference here.
Fixed an issue with the ES Module loader that properly registers instrumentation when the file path included url encoded characters.

Added an API for enqueuing application logs for forwarding

newrelic.recordLogEvent({ message: 'hello world', level: 'info' })`

Note: If you're including a serialized error make sure it's on the error key of the log event:

const error = new Error('testing errors'); 
newrelic.recordLogEvent({ message: 'error example', level: 'error', error })

Fixed cassandra-driver instrumentation to properly set instance details on query segments/spans.
Added a new context manager that leverages AsyncLocalStorage for async context propagation.
- This will be available via a feature flag config.feature_flag.async_local_context
- Alternatively you can set the environment variable of NEW_RELIC_FEATURE_FLAG_ASYNC_LOCAL_CONTEXT=1
- By enabling this feature flag it should make the agent use less memory and CPU.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.5.0

Wed, 26 Oct 2022 00:00:00 +0000

Notes

Increased the default limit of custom events from 1,000 events per minute to 3,000 events per minute. In the scenario that custom events were being limited, this change will allow more custom events to be sent to New Relic. There is also a new configurable maximum limit of 100,000 events per minute. To change the limits, see the docs for custom_insights_events. To learn more about the change and how to determine if custom events are being dropped, see our Explorers Hub post.
Updated CI process to include collection of code coverage statistics.
Added a [doc about our current feature flags)(https://github.com/newrelic/node-newrelic/blob/main/documentation/feature-flags.md).

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.6.0

Wed, 09 Nov 2022 00:00:00 +0000

Notes

Dropped support for vision, and instead only instrument @hapi/vision.
Updated configuration system to automatically create an environment variable mapping for a new config value.
- It will follow a convention of NEW_RELIC_PATH_TO_CONFIG_KEY.
- For example if there is a new configuration option of config.nested.object_path.enabled the env var would be NEW_RELIC_NESTED_OBJECT_PATH.ENABLED.
Removed transaction_tracer.hide_internals configuration. All of the internal configuration is now handled by Javascript symbols instead of non-enumerable properties, so there is no longer a performance penalty, as symbols are already hidden by default.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.7.0

Mon, 14 Nov 2022 00:00:00 +0000

Notes

Added new configuration option, grpc.ignore_status_codes, which can be used to select nonzero gRPC status codes to ignore and not report as errors.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.7.1

Tue, 06 Dec 2022 00:00:00 +0000

Notes

Reintroduced throttling during reading of instrumented application's dependency tree during startup, to prevent EMFILE issues.
Improved Restify support
- Added a new test stanza to run restify >=10 on Node 18.
- Update our versioned tests to support Restify 9.0.0.
Laid foundation for supporting Code Level Metrics via CodeStream. Note that this integration is not fully finished and should not be used.
Improved the readability and maintainability of agent by reducing the Cognitive Complexity of various aspects of the agent.
Added newrelic.noticeError() example to our API docs.
Upgraded @grpc/grpc-js from 1.6.9 to 1.7.3.
Upgraded @grpc/proto-loader from 0.6.13 to 0.7.3.
Removed async from benchmark tests, fixed failing benchmark suites, and removed deprecated suite.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.7.2

Wed, 07 Dec 2022 00:00:00 +0000

Notes

Updated @grpc/grpc-js instrumentation to work with 1.8.0.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.7.4

Thu, 15 Dec 2022 00:00:00 +0000

Notes

Fixed system info gathering to prevent unhandled promise rejection when an error occurs reading /proc information.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.7.3

Mon, 12 Dec 2022 00:00:00 +0000

Notes

Added support for Code Level Metrics on API methods: startSegment, startBackgroundTransaction, and startWebTransaction.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.7.5

Tue, 03 Jan 2023 00:00:00 +0000

Notes

Added a check to the code level metrics utility to ensure filePath was set before adding the code.* attributes.
Updated to latest version of @newrelic/test-utilities.
Fixed issue where listing of dependencies and packages from symlinked nested directories created an infinite loop which caused the agent to never connect.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.8.0

Tue, 17 Jan 2023 00:00:00 +0000

Notes

Updated getBrowserTimingHeader to allow the browser agent to be generated even when not in a transaction by adding allowTransactionlessInjection to function options. allowTransactionlessInjection is a boolean option, and when set to true, will allow injection of the browser agent when not in a transaction. This is intended to be used in frameworks that build Static Site Generation(SSG). Note that if you're using this option, you may need to wait until the Node agent has established a connection before calling getBrowserTimingHeader. To wait until the agent is connected, you can add the following check to your code:

if (!newrelic.agent.collector.isConnected()) {
  await new Promise((resolve) => {
    newrelic.agent.on('connected', resolve)
  })
}

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.8.1

Wed, 25 Jan 2023 00:00:00 +0000

Notes

Changed GCP metadata parsing to use json-bigint to avoid loss of precision from numerical instance ID.
Instrumented winston.loggers.add so it works like winston.createLogger.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v9.9.0

Mon, 06 Feb 2023 00:00:00 +0000

Notes

Added support for URL obfuscation using regex (Thanks for your contribution @matewilk)
- For Distributed Tracing, this means that:
  - Incoming and outgoing requests' path will be obfuscated
  - Transaction's request.url attribute will be obfuscated
  - Span's http.uri path will be obfuscated
- For transactions, this means that:
  - Transaction trace details url will be obfuscated
- With the following example configuration, URL obfuscation will turn /api/v1/users/12345456/edit to /api/v1/users/**/edit.
```
url_obfuscation: {
  enabled: true,
  regex: {
    pattern: /(\/api\/v1\/users\/)([\d]+)(\/.*$)/,
    flags: "i",
    replacement: '$1**$3'
  }
}
```
- You can also use environment variables to configure URL obfuscation:
```
NEW_RELIC_URL_OBFUSCATION_ENABLED: "true",
NEW_RELIC_URL_OBFUSCATION_REGEX_PATTERN: '/(\/api\/v1\/users\/)([\d]+)(\/.*$)/',
NEW_RELIC_URL_OBFUSCATION_REGEX_FLAGS: 'i',
NEW_RELIC_URL_OBFUSCATION_REGEX_REPLACEMENT: '$1**$3'
```
Add a new tracking type of instrumentation. This will be responsible for logging Supportability/Features/Instrumentation/OnResolved/<pkg> and Supportability/Features/Instrumentation/OnResolved/<pkg>/Version/<version> metrics when packages are required.

Support statement:

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

Node.js agent v1.17.0

Wed, 25 Feb 2015 00:00:00 +0000

Notes

Added instrumentation for modules in Node core.
Added support for native Promises in Node.js 0.12 and io.js 1.x.
Traces will now contain separate segments for async waits and callbacks.
Updated instrumentation for MongoDB to support previously un-instrumented methods for 1.x and 2.x versions of the node-mongodb-native driver.
Fixed a bug in the recording of transaction metrics. Previously this would cause a duplicate of the transaction metric to be displayed in the transaction breakdown chart
Unified view for SQL database and NoSQL datastore products.

The response time charts in the application overview page will now include NoSQL datastores, such as Cassandra and MongoDB,and also the product name of existing SQL databases such as MySQL, Postgres, Oracle, etc. For existing SQL databases, in addition to the existing breakdown of SQL statements and operations, the queries are now also associated with the database product being used. For NoSQL datastores, such as Cassandra and MongoDB, we have now added information about operations performed against those products, similar to what is being done for SQL databases.

This new unified Databases page will enable the filtering of metrics and operations by product, and includes a table listing all operations.

Because this introduces a notable change to how SQL database metrics are collected, it is important that you upgrade the agent version on all hosts. If you are unable to transition to the latest agent version on all hosts at the same time, you can still access old and new metric data for SQL databases, but the information will be split across two separate views.

Node.js agent v1.18.3

Thu, 16 Apr 2015 00:00:00 +0000

Notes

Wrapped all our calls to JSON.parse in try/catch.

Previously, only calls that were considered unsafe due to external data input were wrapped. We are taking a more defensive stance and wrapping them all now.
Timers attached to global are now instrumented correctly in all version of io.js.

As of v1.6.3 of io.js, timers are no longer lazily loaded from the timers module, and are placed directly on the global object. The agent now takes this change into account and accurately wraps the timer methods.
Improved handling of cross-application tracing headers.

Paths that include multibyte characters will now show up correctly in cross application maps

Node.js agent v1.19.1

Thu, 14 May 2015 00:00:00 +0000

Notes

Fixed a bug in native ES6 Promise instrumentation.

Previously the Promise instrumentation would cause instanceof Promise to return false even if the object was a promise. This also caused an incompatibility with async-listener. instanceof checks will now work on both the wrapped and unwrapped Promise object.

Node.js agent v1.19.2

Thu, 21 May 2015 00:00:00 +0000

Notes

Fixed an issue with Error tracing

Previously the agent could sometimes cause issues with user serialization of error Âobjects after they passed through the error tracing code.
MongoDB cursor count method is now instrumented

The count method on MongoDB cursors is now instrumented. Previously, count would not be included in transaction traces.
Fixed a typo in NEWS.md

Previously the release notes for v1.19.1 were included as notes for 1.19.0. This has now fixed thanks to @bruun

Node.js agent v1.20.0

Fri, 05 Jun 2015 00:00:00 +0000

Notes

Triaged a defect in native promise instrumentation

Transactions used to be lost acrossed chained .then calls. The way promises are wrapped has been changed to fix this issue.
Added support for Slow Queries

Slow Query information will now appear in the UI for Node agent users. This feature allows you to see a trace for slow datastore queries. Read more about this feature in our documentation