Node.js agent release notesRSS

Bug fixes

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

Notes

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.

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.

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.

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.

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.

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.

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!

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.