newrelic 8.8.0 → 8.10.0

package/NEWS.md

@@ -1,3 +1,68 @@
+### v8.10.0 (2022-04-18)
+
+* 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 if running Node.js > 6.1.0.
+
+* Fixed promise interceptor from re-throwing errors.
+
+* Added transaction naming documentation ported from a discussion forum post: https://discuss.newrelic.com/t/relic-solution-the-philosophy-of-naming-your-node-agent-transactions/.
+
+* 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.
+
+### v8.9.1 (2022-03-22)
+
+* 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.
+
+### v8.9.0 (2022-03-15)
+
+* 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.
+
 ### v8.8.0 (2022-02-23)
 
 * Updated AWS metadata capture to utilize IMDSv2.

package/README.md

@@ -70,6 +70,7 @@ There are several modules that can be installed and configured to accompany the
  * [@newrelic/winston-enricher](https://github.com/newrelic/newrelic-node-log-extensions/tree/main/packages/winston-log-enricher): Provides distributed trace and span information output as JSON-formatted log messages in Winston.  This is most commonly used with the New Relic Logs product.
  * [@newrelic/pino-enricher](https://github.com/newrelic/newrelic-node-log-extensions/tree/main/packages/pino-log-enricher): Provides distributed trace and span information output as JSON-formatted log messages in Pino.  This is most commonly used with the New Relic Logs product.
  * [@newrelic/mysql](https://github.com/newrelic/node-newrelic-mysql)(**Experimental**): Standalone instrumentation for [mysql2](https://github.com/sidorares/node-mysql2#readme) and [mysql2/promise](https://github.com/sidorares/node-mysql2/blob/master/documentation/Promise-Wrapper.md) as well as the same instrumentation for [mysql](https://github.com/mysqljs/mysql#readme) within the Node.js agent.
+ * [@newrelic/next](https://github.com/newrelic/newrelic-node-nextjs): Provides instrumentation for the [Next.js](https://github.com/vercel/next.js/) npm package.
 
 There are several modules included within the Node.js agent to add more instrumentation for 3rd party modules:
 
@@ -144,6 +145,8 @@ Here are some resources for learning more about the agent:
 
 - [The changelog](https://github.com/newrelic/node-newrelic/blob/main/NEWS.md)
 
+- [Example applications](https://github.com/newrelic/newrelic-node-examples) - Working examples of New Relic features in Node.js.
+
 ## Support
 
 Should you need assistance with New Relic products, you are in good hands with several support channels.

package/THIRD_PARTY_NOTICES.md

@@ -712,7 +712,7 @@ This product includes source derived from [@newrelic/aws-sdk](https://github.com
 
 ### @newrelic/koa
 
-This product includes source derived from [@newrelic/koa](https://github.com/newrelic/node-newrelic-koa) ([v6.1.0](https://github.com/newrelic/node-newrelic-koa/tree/v6.1.0)), distributed under the [Apache-2.0 License](https://github.com/newrelic/node-newrelic-koa/blob/v6.1.0/LICENSE):
+This product includes source derived from [@newrelic/koa](https://github.com/newrelic/node-newrelic-koa) ([v6.1.1](https://github.com/newrelic/node-newrelic-koa/tree/v6.1.1)), distributed under the [Apache-2.0 License](https://github.com/newrelic/node-newrelic-koa/blob/v6.1.1/LICENSE):
 
 ```
 Apache License
@@ -1770,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.3.0](https://github.com/newrelic/node-test-utilities/tree/v6.3.0)), distributed under the [Apache-2.0 License](https://github.com/newrelic/node-test-utilities/blob/v6.3.0/LICENSE):
+This product includes source derived from [@newrelic/test-utilities](https://github.com/newrelic/node-test-utilities) ([v6.5.2](https://github.com/newrelic/node-test-utilities/tree/v6.5.2)), distributed under the [Apache-2.0 License](https://github.com/newrelic/node-test-utilities/blob/v6.5.2/LICENSE):
 
 ```
                                  Apache License
@@ -2456,7 +2456,7 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 
 ### glob
 
-This product includes source derived from [glob](https://github.com/isaacs/node-glob) ([v7.1.7](https://github.com/isaacs/node-glob/tree/v7.1.7)), distributed under the [ISC License](https://github.com/isaacs/node-glob/blob/v7.1.7/LICENSE):
+This product includes source derived from [glob](https://github.com/isaacs/node-glob) ([v7.2.0](https://github.com/isaacs/node-glob/tree/v7.2.0)), distributed under the [ISC License](https://github.com/isaacs/node-glob/blob/v7.2.0/LICENSE):
 
 ```
 The ISC License
@@ -3377,7 +3377,7 @@ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 ### @newrelic/native-metrics
 
-This product includes source derived from [@newrelic/native-metrics](https://github.com/newrelic/node-native-metrics) ([v7.1.1](https://github.com/newrelic/node-native-metrics/tree/v7.1.1)), distributed under the [Apache-2.0 License](https://github.com/newrelic/node-native-metrics/blob/v7.1.1/LICENSE):
+This product includes source derived from [@newrelic/native-metrics](https://github.com/newrelic/node-native-metrics) ([v8.0.0](https://github.com/newrelic/node-native-metrics/tree/v8.0.0)), distributed under the [Apache-2.0 License](https://github.com/newrelic/node-native-metrics/blob/v8.0.0/LICENSE):
 
 ```
                                  Apache License

package/lib/config/default.js

@@ -134,6 +134,8 @@ exports.config = () => ({
    * When true, all request headers except for those listed in attributes.exclude
    * will be captured for all traces, unless otherwise specified in a destination's
    * attributes include/exclude lists.
+   *
+   * @env NEW_RELIC_ALLOW_ALL_HEADERS
    */
   allow_all_headers: false,
 

package/lib/config/env.js

@@ -21,6 +21,7 @@ const ENV_MAPPING = {
   proxy_user: 'NEW_RELIC_PROXY_USER',
   proxy_pass: 'NEW_RELIC_PROXY_PASS',
   agent_enabled: 'NEW_RELIC_ENABLED',
+  allow_all_headers: 'NEW_RELIC_ALLOW_ALL_HEADERS',
   attributes: {
     enabled: 'NEW_RELIC_ATTRIBUTES_ENABLED',
     exclude: 'NEW_RELIC_ATTRIBUTES_EXCLUDE',
@@ -206,6 +207,7 @@ const OBJECT_LIST_VARS = new Set(['NEW_RELIC_NAMING_RULES'])
 // fancy--just use 'true' and 'false', everybody.
 const BOOLEAN_VARS = new Set([
   'NEW_RELIC_ENABLED',
+  'NEW_RELIC_ALLOW_ALL_HEADERS',
   'NEW_RELIC_ATTRIBUTES_ENABLED',
   'NEW_RELIC_ERROR_COLLECTOR_ENABLED',
   'NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_ENABLED',

package/lib/config/index.js

@@ -1623,7 +1623,8 @@ function initialize(config) {
   /**
    * When the logger is required here, it bootstraps itself and then
    * injects itself into this module's closure via setLogger on the
-   * instance of the logger it creates.
+   * instance of the logger it creates.  Logs are queued until config
+   * has been loaded to apply logging settings to bootstrapping logs
    */
   logger = require('../logger')
 
@@ -1712,7 +1713,14 @@ function getOrCreateInstance() {
 
       // Config construction has potential to throw due to invalid settings.
       // This allows the agent to return a stub api without crashing the process.
-      _configInstance = Object.assign(defaultConfig(), { agent_enabled: false })
+      _configInstance = Object.assign(defaultConfig(), {
+        agent_enabled: false,
+        logging: {
+          enabled: true,
+          filepath: 'stdout'
+        }
+      })
+
       _configInstance.setLogger = Config.prototype.setLogger
     }
   }

package/lib/instrumentation/mongodb/common.js

@@ -43,6 +43,23 @@ common.instrumentCollection = function instrumentCollection(shim, Collection) {
   }
 }
 
+/**
+ * Instruments the execute method on
+ * the BulkOperationBase class
+ *
+ * @param {Shim} shim
+ * @param {BulkOperationModule} bulk operation module, typically from mongodb/lib/bulk/common
+ * @param BulkOperationModule
+ */
+common.instrumentBulkOperation = function instrumentBulkOperation(shim, BulkOperationModule) {
+  const BulkOperationBase = BulkOperationModule && BulkOperationModule.BulkOperationBase
+
+  if (BulkOperationBase && BulkOperationBase.prototype) {
+    const proto = BulkOperationBase.prototype
+    shim.recordBatchQuery(proto, 'execute', common.makeBulkDescFunc(shim, 'execute'))
+  }
+}
+
 /**
  * Instruments all methods from constants.DB_OPS on
  * the Db class.
@@ -84,6 +101,25 @@ common.makeQueryDescFunc = function makeQueryDescFunc(shim, methodName) {
   }
 }
 
+/**
+ * Sets up the desc for all instrumented bulk operations
+ *
+ * @param {Shim} shim
+ * @param {string} methodName
+ */
+common.makeBulkDescFunc = function makeBulkDescFunc(shim) {
+  return function bulkDescFunc() {
+    const parameters = getInstanceAttributeParameters(shim, this)
+    return {
+      query: this.isOrdered ? 'orderedBulk' : 'unorderedBulk',
+      parameters,
+      promise: true,
+      callback: shim.LAST,
+      opaque: true
+    }
+  }
+}
+
 /**
  * Sets up a listener for `started` on instrumenter(mongo APM). This applies to
  * mongo <4. The listener adds the following attributes to the active segment:
@@ -161,9 +197,10 @@ function setHostPort(shim, connStr, db, client) {
  * @param obj
  */
 function getInstanceAttributeParameters(shim, obj) {
-  if (obj.s && obj.s.db && obj.s.topology) {
+  if (obj.s && obj.s.topology) {
     shim.logger.trace('Adding datastore instance attributes from obj.s.db + obj.s.topology')
-    const databaseName = obj.s.db.databaseName || null
+    const databaseName =
+      (obj.s.db && obj.s.db.databaseName) || (obj.s.namespace && obj.s.namespace.db) || null
     const topology = obj.s.topology
     if (topology.s && topology.s.options) {
       return doCapture(topology.s.options, databaseName)

package/lib/instrumentation/mongodb/v3-mongo.js

@@ -7,6 +7,7 @@
 
 const {
   captureAttributesOnStarted,
+  instrumentBulkOperation,
   instrumentCollection,
   instrumentCursor,
   instrumentDb,
@@ -27,6 +28,8 @@ function queryParser(operation) {
     collection = this.operation.target
   } else if (this.ns) {
     collection = this.ns.split(/\./)[1] || collection
+  } else if (this.s && this.s.collection && this.s.collection.collectionName) {
+    collection = this.s.collection.collectionName
   }
   return { operation, collection }
 }
@@ -68,6 +71,7 @@ module.exports = function instrument(shim, mongodb) {
   instrumentCursor(shim, mongodb.Cursor)
   instrumentCursor(shim, shim.require('./lib/aggregation_cursor'))
   instrumentCursor(shim, shim.require('./lib/command_cursor'))
+  instrumentBulkOperation(shim, shim.require('./lib/bulk/common'))
   instrumentCollection(shim, mongodb.Collection)
   instrumentDb(shim, mongodb.Db)
 

package/lib/instrumentation/{mysql.js → mysql/mysql.js}

@@ -5,17 +5,17 @@
 
 'use strict'
 
-const dbutils = require('../db/utils')
-const properties = require('../util/properties')
+const dbutils = require('../../db/utils')
+const properties = require('../../util/properties')
 
-module.exports = function initialize(agent, mysql, moduleName, shim) {
+exports.callbackInitialize = function callbackInitialize(shim, mysql) {
   shim.setDatastore(shim.MYSQL)
   shim.__wrappedPoolConnection = false
 
   shim.wrapReturn(mysql, 'createConnection', wrapCreateConnection)
   function wrapCreateConnection(shim, fn, fnName, connection) {
     shim.logger.debug('Wrapping Connection#query')
-    if (wrapQueriable(shim, connection, false)) {
+    if (wrapQueryable(shim, connection, false)) {
       const connProto = Object.getPrototypeOf(connection)
       shim.setInternalProperty(connProto, '__NR_storeDatabase', true)
       shim.unwrap(mysql, 'createConnection')
@@ -25,7 +25,7 @@ module.exports = function initialize(agent, mysql, moduleName, shim) {
   shim.wrapReturn(mysql, 'createPool', wrapCreatePool)
   function wrapCreatePool(shim, fn, fnName, pool) {
     shim.logger.debug('Wrapping Pool#query and Pool#getConnection')
-    if (wrapQueriable(shim, pool, true) && wrapGetConnection(shim, pool)) {
+    if (wrapQueryable(shim, pool, true) && wrapGetConnection(shim, pool)) {
       shim.unwrap(mysql, 'createPool')
     }
   }
@@ -48,6 +48,13 @@ module.exports = function initialize(agent, mysql, moduleName, shim) {
   }
 }
 
+exports.promiseInitialize = function promiseInitialize(shim) {
+  const callbackAPI = shim.require('./index')
+  if (callbackAPI && !shim.isWrapped(callbackAPI.createConnection)) {
+    exports.callbackInitialize(shim, callbackAPI)
+  }
+}
+
 function wrapGetConnection(shim, connectable) {
   if (!connectable || !connectable.getConnection || shim.isWrapped(connectable.getConnection)) {
     shim.logger.trace(
@@ -91,7 +98,7 @@ function wrapGetConnectionCallback(shim, cb) {
   return function wrappedGetConnectionCallback(err, conn) {
     try {
       shim.logger.debug('Wrapping PoolConnection#query')
-      if (!err && wrapQueriable(shim, conn, false)) {
+      if (!err && wrapQueryable(shim, conn, false)) {
         // Leave getConnection wrapped in order to maintain TX state, but we can
         // simplify the wrapping of its callback in future calls.
         shim.__wrappedPoolConnection = true
@@ -106,20 +113,20 @@ function wrapGetConnectionCallback(shim, cb) {
   }
 }
 
-function wrapQueriable(shim, queriable, isPoolQuery) {
-  if (!queriable || !queriable.query || shim.isWrapped(queriable.query)) {
+function wrapQueryable(shim, queryable, isPoolQuery) {
+  if (!queryable || !queryable.query || shim.isWrapped(queryable.query)) {
     shim.logger.debug(
       {
-        queriable: !!queriable,
-        query: !!(queriable && queriable.query),
-        isWrapped: !!(queriable && shim.isWrapped(queriable.query))
+        queryable: !!queryable,
+        query: !!(queryable && queryable.query),
+        isWrapped: !!(queryable && shim.isWrapped(queryable.query))
       },
-      'Not wrappying queriable'
+      'Not wrapping queryable'
     )
     return false
   }
 
-  const proto = Object.getPrototypeOf(queriable)
+  const proto = Object.getPrototypeOf(queryable)
 
   let describe
   if (isPoolQuery) {
@@ -131,7 +138,7 @@ function wrapQueriable(shim, queriable, isPoolQuery) {
 
   shim.recordQuery(proto, 'query', describe)
 
-  if (queriable.execute) {
+  if (queryable.execute) {
     shim.recordQuery(proto, 'execute', describe)
   }
 

package/lib/instrumentation/mysql/nr-hooks.js

@@ -0,0 +1,25 @@
+/*
+ * Copyright 2022 New Relic Corporation. All rights reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+'use strict'
+const instrumentation = require('./mysql')
+
+/**
+ * We only need to register the instrumentation once for both mysql and mysql2
+ *  because there is some 🪄 in shimmer
+ * See: https://github.com/newrelic/node-newrelic/blob/main/lib/shimmer.js#L459
+ */
+module.exports = [
+  {
+    type: 'datastore',
+    moduleName: 'mysql',
+    onRequire: instrumentation.callbackInitialize
+  },
+  {
+    type: 'datastore',
+    moduleName: 'mysql2/promise',
+    onRequire: instrumentation.promiseInitialize
+  }
+]

package/lib/instrumentations.js

@@ -25,7 +25,7 @@ module.exports = function instrumentations() {
     'koa': { module: '@newrelic/koa' },
     'memcached': { type: MODULE_TYPE.DATASTORE },
     'mongodb': { type: MODULE_TYPE.DATASTORE },
-    'mysql': { type: MODULE_TYPE.DATASTORE },
+    'mysql': { module: './instrumentation/mysql' },
     'pg': { type: MODULE_TYPE.DATASTORE },
     'q': { type: null },
     'redis': { type: MODULE_TYPE.DATASTORE },

package/lib/logger.js

@@ -9,12 +9,16 @@ const Logger = require('./util/logger')
 const fs = require('./util/unwrapped-core').fs
 
 // create bootstrapping logger
-module.exports = new Logger({
+const logger = new Logger({
   name: 'newrelic_bootstrap',
-  stream: process.stdout,
-  level: 'info'
+  level: 'info',
+
+  // logger is configured below.  Logs are queued until configured
+  configured: false
 })
 
+module.exports = logger
+
 /**
  * Don't load config until this point, because it requires this
  * module, and if it gets loaded too early, module.exports will have no
@@ -28,8 +32,8 @@ if (config) {
     enabled: config.logging.enabled
   }
 
-  // create the "real" logger
-  module.exports = new Logger(options)
+  // configure logger
+  logger.configure(options)
 
   if (config.logging.enabled) {
     let stream
@@ -52,9 +56,6 @@ if (config) {
           /* eslint-enable no-console */
         })
     }
-    module.exports.pipe(stream)
+    logger.pipe(stream)
   }
-
-  // now tell the config module to switch to the real logger
-  config.setLogger(module.exports)
 }

package/lib/sampler.js

@@ -109,17 +109,6 @@ function sampleCpu(agent) {
   }
 }
 
-function sampleCpuNative(agent, nativeMetrics) {
-  const recordCPU = generateCPUMetricRecorder(agent)
-  nativeMetrics.on('usage', function collectResourceUsage(usage) {
-    recordCPU(usage.diff.ru_utime / MILLIS, usage.diff.ru_stime / MILLIS)
-  })
-
-  return function cpuSampler() {
-    // NOOP?
-  }
-}
-
 function sampleLoop(agent, nativeMetrics) {
   return function loopSampler() {
     // Convert from microseconds to seconds
@@ -195,16 +184,8 @@ module.exports = {
       }
     }
 
-    // Add CPU sampling using the built-in data if available, otherwise pulling
-    // from the native module.
-    if (process.cpuUsage) {
-      // introduced in 6.1.0
-      samplers.push(new Sampler(sampleCpu(agent), SAMPLE_INTERVAL))
-    } else if (this.nativeMetrics && this.nativeMetrics.usageEnabled) {
-      samplers.push(new Sampler(sampleCpuNative(agent, this.nativeMetrics), SAMPLE_INTERVAL))
-    } else {
-      logger.debug('Not adding CPU metric sampler.')
-    }
+    // Add CPU sampling using the built-in data (introduced in 6.1.0)
+    samplers.push(new Sampler(sampleCpu(agent), SAMPLE_INTERVAL))
 
     this.state = 'running'
   },

package/lib/serverless/aws-lambda.js

@@ -199,20 +199,19 @@ class AwsLambda {
     // we need to store the error in uncaughtException
     // otherwise the transaction will end before they are captured
     function lambdaInterceptPromise(prom, resultProcessor, cb) {
-      return prom.then(
+      prom.then(
         function onThen(arg) {
           if (resultProcessor) {
             resultProcessor(arg)
           }
           cb()
-          return arg
         },
         function onCatch(err) {
           uncaughtException = err
           cb()
-          throw err // This is not our error, just rethrowing the promise rejection.
         }
       )
+      return prom
     }
 
     function wrapCallbackAndCaptureError(transaction, txnEnder, cb, processResult) {

package/lib/shim/shim.js

@@ -639,10 +639,9 @@ function wrapReturn(nodule, properties, spec, args) {
         }
         return true
       },
-      construct: function constructTrap(Target, proxyArgs) {
-        // Call the underlying function. If this was called as a constructor, call
-        // the wrapped function as a constructor too.
-        let ret = new Target(...proxyArgs)
+      construct: function constructTrap(target, proxyArgs, newTarget) {
+        // Call the underlying function via Reflect.
+        let ret = Reflect.construct(target, proxyArgs, newTarget)
 
         // Assemble the arguments to hand to the spec.
         const _args = [shim, fn, fnName, ret]
@@ -1747,19 +1746,8 @@ function shimRequire(filePath) {
  * @returns {Promise} A new promise to replace the original one.
  */
 function interceptPromise(prom, cb) {
-  if (this.isFunction(prom.finally)) {
-    return prom.finally(cb)
-  }
-  return prom.then(
-    function onThen(arg) {
-      cb()
-      return arg
-    },
-    function onCatch(err) {
-      cb()
-      throw err // This is not our error, just rethrowing the promise rejection.
-    }
-  )
+  prom.then(cb, cb)
+  return prom
 }
 
 /**

package/lib/util/logger.js

@@ -39,7 +39,8 @@ function Logger(options, extra) {
   const passedInLevel = this.coerce(options.level)
   this.options = {
     _level: passedInLevel,
-    enabled: options.enabled === undefined ? true : options.enabled
+    enabled: options.enabled === undefined ? true : options.enabled,
+    configured: options.configured === undefined ? true : !!options.configured
   }
   this._nestedLog = false
   this.name = options.name
@@ -47,12 +48,30 @@ function Logger(options, extra) {
   this.extra = extra || Object.create(null)
   this.buffer = ''
   this.reading = false
+  this.logQueue = []
   if (options.stream) {
     this.pipe(options.stream)
   }
 }
 Logger.MAX_LOG_BUFFER = MAX_LOG_BUFFER
 
+Logger.prototype.configure = function configure(options) {
+  if (options.name !== undefined) {
+    this.name = options.name
+  }
+
+  if (options.enabled !== undefined) {
+    this.options.enabled = options.enabled
+  }
+
+  if (options.level !== undefined) {
+    this.options._level = this.coerce(options.level)
+  }
+
+  this.options.configured = true
+  this._flushQueuedLogs()
+}
+
 Logger.prototype.coerce = function coerce(value) {
   if (!isNaN(parseInt(value, 10)) && isFinite(value)) {
     // value is numeric
@@ -74,6 +93,11 @@ Object.keys(LEVELS).forEach(function buildLevel(_level) {
   const level = Logger.prototype.coerce(LEVELS[_level])
 
   function log(extra) {
+    if (!this.options.configured) {
+      this.logQueue.unshift({ level: _level, args: arguments })
+      return
+    }
+
     if (!this.options.enabled) {
       return false
     }
@@ -149,6 +173,13 @@ Object.keys(LEVELS).forEach(function buildLevel(_level) {
   }
 })
 
+Logger.prototype._flushQueuedLogs = function _flushQueuedLogs() {
+  while (this.logQueue.length) {
+    const { level, args } = this.logQueue.shift()
+    this[level].apply(this, args)
+  }
+}
+
 Object.assign(Logger.prototype, loggingFunctions)
 
 Logger.prototype.child = function child(extra) {
@@ -196,6 +227,10 @@ Logger.prototype._read = function _read() {
  * already converted the objects to strings.
  * Returns a boolean representing the status of the write
  * (success/failure)
+ *
+ * @param level
+ * @param args
+ * @param extra
  */
 Logger.prototype.write = function write(level, args, extra) {
   if (this._nestedLog) {

package/lib/utilization/aws-info.js

@@ -42,7 +42,7 @@ function fetchAWSInfo(agent, callback) {
       headers: { 'X-aws-ec2-metadata-token': authToken },
       host: INSTANCE_HOST,
       method: 'GET',
-      path: '/2016-09-02/dynamic/instance-identity/document',
+      path: '/latest/dynamic/instance-identity/document',
       timeout: 500
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "newrelic",
-  "version": "8.8.0",
+  "version": "8.10.0",
   "author": "New Relic Node.js agent team <nodejs@newrelic.com>",
   "license": "Apache-2.0",
   "contributors": [
@@ -162,7 +162,7 @@
     "@grpc/grpc-js": "^1.5.5",
     "@grpc/proto-loader": "^0.6.9",
     "@newrelic/aws-sdk": "^4.1.1",
-    "@newrelic/koa": "^6.1.0",
+    "@newrelic/koa": "^6.1.1",
     "@newrelic/superagent": "^5.1.0",
     "@tyriar/fibonacci-heap": "^2.0.7",
     "async": "^3.2.3",
@@ -173,13 +173,13 @@
     "semver": "^5.3.0"
   },
   "optionalDependencies": {
-    "@newrelic/native-metrics": "^7.1.1"
+    "@newrelic/native-metrics": "^8.0.0"
   },
   "devDependencies": {
     "@newrelic/eslint-config": "^0.0.3",
     "@newrelic/newrelic-oss-cli": "^0.1.2",
     "@newrelic/proxy": "^2.0.0",
-    "@newrelic/test-utilities": "^6.3.0",
+    "@newrelic/test-utilities": "^6.5.2",
     "@octokit/rest": "^18.0.15",
     "@slack/bolt": "^3.7.0",
     "ajv": "^6.12.6",