newrelic 8.4.0 → 8.6.0

package/NEWS.md

@@ -1,37 +1,91 @@
-### v8.4.0 (2021-09-28)
+### v8.6.0 (2021-11-17)
 
-* **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.
+* Added `onResolved` instrumentation hook to apply instrumentation prior to module load.
 
-  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.
+  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 DT headers would not be processed by `transaction-shim.handleCATHeaders()` when CAT was explicitly disabled. This primarily impacts `amqplib` instrumentation.
+* Fixed issue where `recordConsume` was not binding consumer if it was a promise
 
-* Transitioned aws-lambda.test.js to use Tap over Mocha.
+* Pinned mongo versioned tests to `<4.2.0` until we can address https://github.com/newrelic/node-newrelic/issues/982
 
-* Removed warnings from agent for `no-var` eslint rule.
+* Introduced a context management API to be used in place of manually calling tracer.segment get/set.
 
-* Refactored `transaction-shim`, `http` and `http-outbound` to use centralized CAT methods in `util/cat`
+### v8.5.2 (2021-11-09)
 
-* Replaced http-outbound test call to use example.com to avoid unpredictable connection resets.
-
-* Migrated sql query parser tests to tap
+* Fixed issue where unhandled promise rejections were not getting logged as errors in a lambda execution
 
+### v8.5.1 (2021-11-03)
+
+* 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.
+
+### v8.5.0 (2021-10-12)
+
+* 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](https://github.com/nodejs/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](https://nodejs.org/dist/latest-v16.x/docs/api/diagnostics_channel.html). Lastly, you must be using [v4.7.0+](https://github.com/nodejs/undici/releases/tag/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.
+
+### v8.4.0 (2021-09-28)
+
+* **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.
-
+
+* 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.
+
 ### v8.3.0 (2021-09-09)
 
 * Enabled Distributed Tracing (DT) by default.

package/README.md

@@ -44,7 +44,13 @@ To use New Relic's Node.js agent entails these three steps, which are described
     }
 ```
 
-4. Finally, load the `newrelic` module _before any other module_ in your program.
+4. Finally, run your program with the `newrelic` module loaded first by using node's `-r/--require` flag.
+
+```
+ $ node -r newrelic your-program.js
+```
+
+If you cannot control how your program is run, you can load the `newrelic` module _before any other module_ in your program.
 
 ```js
     const newrelic = require('newrelic')
@@ -52,11 +58,6 @@ To use New Relic's Node.js agent entails these three steps, which are described
     /* ... the rest of your program ... */
 ```
 
-If you're compiling your JavaScript and can't control the final `require` order, the Node.js agent will work with node's `-r/--require` flag.
-
-    $ node -r newrelic your-program.js
-    $ node --require newrelic your-program.js
-
 ## Getting Started
 
 For more information on getting started, [check the Node.js docs](https://docs.newrelic.com/docs/agents/nodejs-agent/getting-started/introduction-new-relic-nodejs).

package/THIRD_PARTY_NOTICES.md

@@ -34,6 +34,7 @@ code, the source code can be found at [https://github.com/newrelic/node-newrelic
 * [@newrelic/proxy](#newrelicproxy)
 * [@newrelic/test-utilities](#newrelictest-utilities)
 * [@octokit/rest](#octokitrest)
+* [@slack/bolt](#slackbolt)
 * [ajv](#ajv)
 * [architect](#architect)
 * [benchmark](#benchmark)
@@ -41,7 +42,9 @@ code, the source code can be found at [https://github.com/newrelic/node-newrelic
 * [chai](#chai)
 * [commander](#commander)
 * [eslint-config-prettier](#eslint-config-prettier)
+* [eslint-plugin-disable](#eslint-plugin-disable)
 * [eslint-plugin-header](#eslint-plugin-header)
+* [eslint-plugin-jsdoc](#eslint-plugin-jsdoc)
 * [eslint-plugin-node](#eslint-plugin-node)
 * [eslint-plugin-prettier](#eslint-plugin-prettier)
 * [eslint](#eslint)
@@ -49,7 +52,6 @@ code, the source code can be found at [https://github.com/newrelic/node-newrelic
 * [generic-pool](#generic-pool)
 * [glob](#glob)
 * [got](#got)
-* [http-errors](#http-errors)
 * [husky](#husky)
 * [jsdoc](#jsdoc)
 * [lint-staged](#lint-staged)
@@ -1768,7 +1770,7 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 
 ### @newrelic/test-utilities
 
-This product includes source derived from [@newrelic/test-utilities](https://github.com/newrelic/node-test-utilities) ([v6.0.0](https://github.com/newrelic/node-test-utilities/tree/v6.0.0)), distributed under the [Apache-2.0 License](https://github.com/newrelic/node-test-utilities/blob/v6.0.0/LICENSE):
+This product includes source derived from [@newrelic/test-utilities](https://github.com/newrelic/node-test-utilities) ([v6.1.1](https://github.com/newrelic/node-test-utilities/tree/v6.1.1)), distributed under the [Apache-2.0 License](https://github.com/newrelic/node-test-utilities/blob/v6.1.1/LICENSE):
 
 ```
                                  Apache License
@@ -2005,6 +2007,36 @@ THE SOFTWARE.
 
 ```
 
+### @slack/bolt
+
+This product includes source derived from [@slack/bolt](https://github.com/slackapi/bolt) ([v3.7.0](https://github.com/slackapi/bolt/tree/v3.7.0)), distributed under the [MIT License](https://github.com/slackapi/bolt/blob/v3.7.0/LICENSE):
+
+```
+The MIT License (MIT)
+
+Copyright (c) 2016-2018 Robots & Pencils
+Copyright (c) 2019- Slack Technologies, LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+```
+
 ### ajv
 
 This product includes source derived from [ajv](https://github.com/ajv-validator/ajv) ([v6.12.6](https://github.com/ajv-validator/ajv/tree/v6.12.6)), distributed under the [MIT License](https://github.com/ajv-validator/ajv/blob/v6.12.6/LICENSE):
@@ -2210,6 +2242,33 @@ THE SOFTWARE.
 
 ```
 
+### eslint-plugin-disable
+
+This product includes source derived from [eslint-plugin-disable](https://github.com/mradionov/eslint-plugin-disable) ([v2.0.1](https://github.com/mradionov/eslint-plugin-disable/tree/v2.0.1)), distributed under the [MIT License](https://github.com/mradionov/eslint-plugin-disable/blob/v2.0.1/LICENSE):
+
+```
+Copyright (c) 2015 Michael Radionov (https://github.com/mradionov)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+```
+
 ### eslint-plugin-header
 
 This product includes source derived from [eslint-plugin-header](https://github.com/Stuk/eslint-plugin-header) ([v3.1.1](https://github.com/Stuk/eslint-plugin-header/tree/v3.1.1)), distributed under the [MIT License](https://github.com/Stuk/eslint-plugin-header/blob/v3.1.1/README.md):
@@ -2226,6 +2285,38 @@ The above copyright notice and this permission notice shall be included in all c
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ```
 
+### eslint-plugin-jsdoc
+
+This product includes source derived from [eslint-plugin-jsdoc](https://github.com/gajus/eslint-plugin-jsdoc) ([v36.1.0](https://github.com/gajus/eslint-plugin-jsdoc/tree/v36.1.0)), distributed under the [BSD-3-Clause License](https://github.com/gajus/eslint-plugin-jsdoc/blob/v36.1.0/LICENSE):
+
+```
+Copyright (c) 2018, Gajus Kuizinas (http://gajus.com/)
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+    * Neither the name of the Gajus Kuizinas (http://gajus.com/) nor the
+      names of its contributors may be used to endorse or promote products
+      derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL ANUARY BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+```
+
 ### eslint-plugin-node
 
 This product includes source derived from [eslint-plugin-node](https://github.com/mysticatea/eslint-plugin-node) ([v11.1.0](https://github.com/mysticatea/eslint-plugin-node/tree/v11.1.0)), distributed under the [MIT License](https://github.com/mysticatea/eslint-plugin-node/blob/v11.1.0/LICENSE):
@@ -2409,37 +2500,6 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 
 ```
 
-### http-errors
-
-This product includes source derived from [http-errors](https://github.com/jshttp/http-errors) ([v1.8.0](https://github.com/jshttp/http-errors/tree/v1.8.0)), distributed under the [MIT License](https://github.com/jshttp/http-errors/blob/v1.8.0/LICENSE):
-
-```
-
-The MIT License (MIT)
-
-Copyright (c) 2014 Jonathan Ong me@jongleberry.com
-Copyright (c) 2016 Douglas Christopher Wilson doug@somethingdoug.com
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
-
-```
-
 ### husky
 
 This product includes source derived from [husky](https://github.com/typicode/husky) ([v6.0.0](https://github.com/typicode/husky/tree/v6.0.0)), distributed under the [MIT License](https://github.com/typicode/husky/blob/v6.0.0/LICENSE):
@@ -3232,7 +3292,7 @@ THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 ### tap
 
-This product includes source derived from [tap](https://github.com/tapjs/node-tap) ([v15.0.9](https://github.com/tapjs/node-tap/tree/v15.0.9)), distributed under the [ISC License](https://github.com/tapjs/node-tap/blob/v15.0.9/LICENSE):
+This product includes source derived from [tap](https://github.com/tapjs/node-tap) ([v15.0.10](https://github.com/tapjs/node-tap/tree/v15.0.10)), distributed under the [ISC License](https://github.com/tapjs/node-tap/blob/v15.0.10/LICENSE):
 
 ```
 The ISC License