newrelic 6.13.2 → 7.0.2

package/lib/grpc/connection.js

@@ -38,7 +38,7 @@ class GrpcConnection extends EventEmitter {
   /**
    * GrpcConnection constructor
    *
-   * Standard property setting/initilization, and sets an initial
+   * Standard property setting/initialization, and sets an initial
    * connection state of disconnected
    *
    * @param {Object} traceObserverConfig config item config.infinite_tracing.trace_observer
@@ -121,7 +121,7 @@ class GrpcConnection extends EventEmitter {
       // immediately.
       this._setState(connectionStates.connected, this.stream)
     } catch (err) {
-      logger.trace(
+      logger.warn(
         err,
         'Unexpected error establishing gRPC stream, will not attempt reconnect.'
       )
@@ -198,9 +198,26 @@ class GrpcConnection extends EventEmitter {
     if (this.stream) {
       this.stream.removeAllListeners()
 
+      const oldStream = this.stream
+      this.stream.on('status', function endStreamStatusHandler(grpcStatus) {
+        logger.trace('End stream status received [%s]: %s', grpcStatus.code, grpcStatus.details)
+
+        // Cleanup the final end stream listeners.
+        oldStream.removeAllListeners()
+      })
+
+      // Listen to any final errors to prevent throwing.
+      // This is unlikely but if the server closes post
+      // removing listeners and prior to response it could
+      // happen. We noticed this via tests on Node 14.
+      this.stream.on('error', function endStreamErrorHandler(err) {
+        logger.trace('End stream error received. Code: [%s]: %s', err.code, err.details)
+      })
+
       // Indicates to server we are done.
       // Server officially closes the stream.
       this.stream.end()
+
       this.stream = null
     }
 
@@ -238,6 +255,9 @@ class GrpcConnection extends EventEmitter {
         // per the spec, An UNIMPLEMENTED status code from gRPC indicates
         // that the versioned Trace Observer is no longer available. Agents
         // MUST NOT attempt to reconnect in this case
+        logger.info(
+          '[UNIMPLEMENTED]: Trace Obserserver is no longer available. Shutting down connection.'
+        )
         this._disconnect()
       } else if (grpc.status[grpc.status.OK] === grpcStatusName) {
         this._reconnect()
@@ -256,7 +276,11 @@ class GrpcConnection extends EventEmitter {
       this._metrics.getOrCreateMetric(NAMES.INFINITE_TRACING.SPAN_RESPONSE_ERROR)
         .incrementCallCount()
 
-      logger.trace('span stream error. Code: [%s]: %s',err.code, err.details)
+      // For errors, the status will either result in a disconnect or a reconnect
+      // delay that should prevent too frequent spamming. Unless the app is idle
+      // and regularly getting Status 13 reconnects from the server, in which case
+      // this will be almost the only logging.
+      logger.warn('Span stream error. Code: [%s]: %s', err.code, err.details)
     })
   }
 
@@ -266,7 +290,7 @@ class GrpcConnection extends EventEmitter {
   _generateCredentials(grpcApi) {
     let certBuffer = null
 
-    // Current settable value for testing. If allowed to be overriden via
+    // Current settable value for testing. If allowed to be overridden via
     // configuration, this should be removed in place of setting
     // this._rootCerts from config via normal configuration precedence.
     const envTestCerts = process.env.NEWRELIC_GRPCCONNECTION_CA

package/lib/instrumentation/core/http.js

@@ -15,7 +15,6 @@ const util = require('util')
 const url = require('url')
 const urltils = require('../../util/urltils')
 const properties = require('../../util/properties')
-const psemver = require('../../util/process-version')
 const headerAttributes = require('../../header-attributes')
 const headerProcessing = require('../../header-processing')
 
@@ -27,8 +26,6 @@ const DESTS = require('../../config/attribute-filter').DESTINATIONS
  * CONSTANTS
  *
  */
-const SHOULD_WRAP_HTTPS = psemver.satisfies('>=9.0.0 || 8.9.0')
-const SHOULD_FORMAT_ARGS = psemver.satisfies('>=10.0.0')
 const NR_CONNECTION_PROP = '__NR__connection'
 const NEWRELIC_ID_HEADER = 'x-newrelic-id'
 const NEWRELIC_APP_DATA_HEADER = 'x-newrelic-app-data'
@@ -172,16 +169,7 @@ function wrapEmitWithTransaction(agent, emit, isHTTPS) {
 
       if (response) {
         if (response.statusCode != null) {
-          /*
-          TODO: remove with next major release
-          httpResponseCode attribute is deprecated
-          */
           var responseCode = String(response.statusCode)
-          transaction.trace.attributes.addAttribute(
-            DESTS.TRANS_COMMON,
-            'httpResponseCode',
-            responseCode
-          )
 
           if (/^\d+$/.test(responseCode)) {
             transaction.trace.attributes.addAttribute(
@@ -189,18 +177,8 @@ function wrapEmitWithTransaction(agent, emit, isHTTPS) {
               'http.statusCode',
               responseCode
             )
-              
-            segment.addSpanAttribute('http.statusCode', responseCode)
 
-            /*
-            TODO: remove with next major release
-            response.status attribute is deprecated
-            */
-            transaction.trace.attributes.addAttribute(
-              DESTS.TRANS_COMMON,
-              'response.status',
-              responseCode
-            )
+            segment.addSpanAttribute('http.statusCode', responseCode)
           }
         }
 
@@ -212,16 +190,6 @@ function wrapEmitWithTransaction(agent, emit, isHTTPS) {
           )
 
           segment.addSpanAttribute('http.statusText', response.statusMessage)
-
-          /*
-            TODO: remove with next major release
-            httpResponseMessage attribute is deprecated
-          */
-          transaction.trace.attributes.addAttribute(
-            DESTS.TRANS_COMMON,
-            'httpResponseMessage',
-            response.statusMessage
-          )
         }
 
         var headers = response.getHeaders()
@@ -299,7 +267,7 @@ function wrapResponseEnd(agent, proto) {
         return end.apply(this, arguments)
       }
 
-      // If an error happend, add it to the aggregator.
+      // If an error happened, add it to the aggregator.
       if (txInfo.error) {
         if (!txInfo.errorHandled || urltils.isError(agent.config, this.statusCode)) {
           agent.errors.add(txInfo.transaction, txInfo.error)
@@ -323,7 +291,7 @@ function wrapResponseEnd(agent, proto) {
   })
 }
 
-// CAT this wont be used unless CAT is enabled, see below where we actually do
+// CAT this won't be used unless CAT is enabled, see below where we actually do
 // the shimmer stuff if you'd like to verify.
 function wrapWriteHead(agent, writeHead) {
   return function wrappedWriteHead() {
@@ -442,37 +410,30 @@ function urlToOptions(_url) {
 }
 
 function wrapRequest(agent, request) {
-  // URL as a global was not added until Node v10
-  const URLClass = global.URL ? global.URL : url.URL
   return function wrappedRequest(input, options, cb) {
-    let reqArgs = arguments
-    if (SHOULD_FORMAT_ARGS) {
-      // Support new function signatures in Node v10+. If the first argument is a URL,
-      // merge it into the options object. This code is copied from Node internals.
-      if (typeof input === 'string') {
-        const urlStr = input
-        input = urlToOptions(new URLClass(urlStr))
-      } else if (input.constructor && input.constructor.name === 'URL') {
-        input = urlToOptions(input)
-      } else {
-        cb = options
-        options = input
-        input = null
-      }
-
-      if (typeof options === 'function') {
-        cb = options
-        options = input || {}
-      } else {
-        options = Object.assign(input || {}, options)
-      }
-
-      reqArgs = [options, cb]
+    // If the first argument is a URL, merge it into the options object.
+    // This code is copied from Node internals.
+    if (typeof input === 'string') {
+      const urlStr = input
+      input = urlToOptions(new URL(urlStr))
+    } else if (input.constructor && input.constructor.name === 'URL') {
+      input = urlToOptions(input)
     } else {
-      // Node v8 function signature had options as the first argument
+      cb = options
       options = input
+      input = null
+    }
+
+    if (typeof options === 'function') {
+      cb = options
+      options = input || {}
+    } else {
+      options = Object.assign(input || {}, options)
     }
 
+    let reqArgs = [options, cb]
+
+
     // Don't pollute metrics and calls with NR connections
     const internalOnly = options && options[NR_CONNECTION_PROP]
     if (internalOnly) {
@@ -552,28 +513,19 @@ module.exports = function initialize(agent, http, moduleName) {
 
   var agentProto = http && http.Agent && http.Agent.prototype
 
-  // As of node 0.8, http.request() is the right way to originate outbound
-  // requests. From 0.11 until 9, the `https` module simply called through to
-  // the `http` methods, so to prevent double-instrumenting we need to check
-  // what module we're instrumenting and what version of Node we're on. This
-  // change originally also appeared in 8.9.0 but was reverted in 8.9.1.
-  //
-  // TODO: Remove `SHOULD_WRAP_HTTPS` after deprecating Node <9.
-  if (SHOULD_WRAP_HTTPS || !IS_HTTPS) {
-    shimmer.wrapMethod(
-      http,
-      'http',
-      'request',
-      wrapRequest.bind(null, agent)
-    )
+  shimmer.wrapMethod(
+    http,
+    'http',
+    'request',
+    wrapRequest.bind(null, agent)
+  )
 
-    shimmer.wrapMethod(
-      http,
-      'http',
-      'get',
-      wrapRequest.bind(null, agent)
-    )
-  }
+  shimmer.wrapMethod(
+    http,
+    'http',
+    'get',
+    wrapRequest.bind(null, agent)
+  )
 
   shimmer.wrapMethod(
     agentProto,

package/lib/instrumentation/fastify/spec-builders.js

@@ -59,7 +59,7 @@ function buildMiddlewareSpecForRouteHandler(shim, path) {
      * then this method is required/useful again.
      *
      * The isFinal param determines whether or not a path is appended for
-     * this particuar piece of middleware. (i.e. if this is the final handler
+     * this particular piece of middleware. (i.e. if this is the final handler
      * that is actually handling the request, the path is actually left on)
      */
     next: function wrapNext(shim, fn, fnName, args, bindSegment) {

package/lib/metrics/names.js

@@ -240,10 +240,13 @@ const SPAN_EVENTS = {
 const INFINITE_TRACING = {
   SEEN: SUPPORTABILITY.INFINITE_TRACING + '/Span/Seen',
   SENT: SUPPORTABILITY.INFINITE_TRACING + '/Span/Sent',
+  DROPPED: SUPPORTABILITY.INFINITE_TRACING + '/Span/Dropped',
   SPAN_RESPONSE_ERROR: SUPPORTABILITY.INFINITE_TRACING + '/Span/Response/Error',
   SPAN_RESPONSE_GRPC_UNIMPLEMENTED: SUPPORTABILITY.INFINITE_TRACING + '/Span/gRPC/UNIMPLEMENTED',
   SPAN_RESPONSE_GRPC_STATUS: SUPPORTABILITY.INFINITE_TRACING + '/Span/gRPC/%s',
-  DRAIN_DURATION: SUPPORTABILITY.INFINITE_TRACING + '/Drain/Duration'
+  QUEUE_CAPACITY: SUPPORTABILITY.INFINITE_TRACING + '/Span/QueueCapacity',
+  QUEUE_SIZE: SUPPORTABILITY.INFINITE_TRACING + '/Span/QueueSize',
+  DRAIN_DURATION: SUPPORTABILITY.INFINITE_TRACING + '/Drain/Duration',
 }
 
 module.exports = {

package/lib/parse-proc-cpuinfo.js

@@ -22,7 +22,7 @@ function parseProcCPUInfo(data) {
     packages: null
   }
 
-  // seperate the processors
+  // separate the processors
   var splitData = data.split('\n')
     .map(function formatAttribute(attr) {
       return attr.split(':')

package/lib/proxy/grpc.js

@@ -8,7 +8,7 @@ class ProxyGrpc {
   constructor(grpcLibrary = '@grpc/grpc-js') {
     this.library = require(grpcLibrary)
 
-    // add methods or objets from base grpc class that we need as needed
+    // add methods or objects from base grpc class that we need as needed
     this.credentials = this.library.credentials
     this.Metadata = this.library.Metadata
     this.loadPackageDefinition = this.library.loadPackageDefinition

package/lib/serverless/aws-lambda.js

@@ -129,7 +129,6 @@ class AwsLambda {
       const segmentRecorder = isApiGatewayLambdaProxy ? recordWeb : recordBackground
       const segment = shim.createSegment(functionName, segmentRecorder)
       transaction.baseSegment = segment
-      
       // resultProcessor is used to execute additional logic based on the
       // payload supplied to the callback.
       let resultProcessor
@@ -180,7 +179,6 @@ class AwsLambda {
       shim.agent.setLambdaArn(context.invokedFunctionArn)
 
       shim.agent.setLambdaFunctionVersion(context.functionVersion)
-      
       segment.addSpanAttributes(awsAttributes)
 
       segment.start()
@@ -194,7 +192,7 @@ class AwsLambda {
         throw err
       }
       if (shim.isPromise(res)) {
-        res = lambdaInterceptPromise(res, txnEnder)
+        res = lambdaInterceptPromise(res, resultProcessor, txnEnder)
       }
       return res
     }
@@ -202,8 +200,11 @@ class AwsLambda {
     // In order to capture error events
     // we need to store the error in uncaughtException
     // otherwise the transaction will end before they are captured
-    function lambdaInterceptPromise(prom, cb) {
+    function lambdaInterceptPromise(prom, resultProcessor, cb) {
       return prom.then(function onThen(arg) {
+        if (resultProcessor) {
+          resultProcessor(arg)
+        }
         cb()
         return arg
       }, function onCatch(err) {
@@ -389,33 +390,18 @@ function setWebResponse(transaction, response) {
   transaction.statusCode = response.statusCode
 
   const responseCode = String(response.statusCode)
-  /*
-  TODO: remove with next major release
-  httpResponseCode attribute is deprecated
-  */
-  transaction.trace.attributes.addAttribute(
-    ATTR_DEST.TRANS_COMMON,
-    'httpResponseCode',
-    responseCode
-  )
 
   if (/^\d+$/.test(responseCode)) {
-    /*
-    TODO: remove with next major release
-    response.status attribute is deprecated
-    */
-    transaction.trace.attributes.addAttribute(
-      ATTR_DEST.TRANS_COMMON,
-      'response.status',
-      responseCode)
-
     transaction.trace.attributes.addAttribute(
       ATTR_DEST.TRANS_COMMON,
       'http.statusCode',
       responseCode
     )
 
-    const segment = transaction.agent.tracer.getSegment()
+    // We are adding http.statusCode to base segment as
+    // we found in testing async invoked lambdas, the
+    // active segement is not available at this point.
+    const segment = transaction.baseSegment
 
     segment.addSpanAttribute('http.statusCode', responseCode)
   }

package/lib/shim/promise-shim.js

@@ -46,7 +46,7 @@ class PromiseShim extends Shim {
   }
 
   /**
-   * Sets the class used to indentify promises from the wrapped promise library.
+   * Sets the class used to identify promises from the wrapped promise library.
    *
    * @param {function} clss - The promise library's class.
    */

package/lib/shim/shim.js

@@ -308,7 +308,7 @@ Shim.prototype.__NR_unwrap = unwrapAll
  *
  * @description
  *  The syntax for declarative instrumentation. It can be used interlaced with
- *  custom, hand-written instrumentation for one-off or hard to simplifiy
+ *  custom, hand-written instrumentation for one-off or hard to simplify
  *  instrumentation logic.
  *
  * @property {Spec|WrapFunction} $return
@@ -1949,10 +1949,10 @@ function bindPromise(promise, segment) {
  * Copies the given parameters onto the segment, respecting the current agent
  * configuration.
  *
- * @memberof Shim.protoype
+ * @memberof Shim.prototype
  *
  * @param {TraceSegment}  segment     - The segment to copy the parameters onto.
- * @param {object}        parameters  - The paramters to copy.
+ * @param {object}        parameters  - The parameters to copy.
  */
 function copySegmentParameters(segment, parameters) {
   for (var key in parameters) {

package/lib/shim/transaction-shim.js

@@ -184,7 +184,7 @@ function bindCreateTransaction(nodule, property, spec) {
  *
  * - `pushTransactionName(pathSegment)`
  *
- * Transactions are named for the middlware that sends the reponse. Some web
+ * Transactions are named for the middlware that sends the response. Some web
  * frameworks are capable of mounting middlware in complex routing stacks. In
  * order to maintain the correct name, transactions keep a stack of mount points
  * for each middlware/router/app/whatever. The instrumentation should push on

package/lib/shim/webframework-shim.js

@@ -331,7 +331,7 @@ function setFramework(framework) {
 }
 
 /**
- * Sets the URI path to be used for naming the transaction currenty in scope.
+ * Sets the URI path to be used for naming the transaction currently in scope.
  *
  * @memberof WebFrameworkShim.prototype
  *

package/lib/shimmer.js

@@ -381,7 +381,7 @@ var shimmer = module.exports = {
      * Forces file name resolve for modules not in our cache when
      * their parent has already been loaded/cached by Node.
      * Provides a fall-back for unexpected cases that may occur.
-     * Also provides flexibilty for testing now that node 11+ caches these.
+     * Also provides flexibility for testing now that node 11+ caches these.
      * @param {*} request
      * @param {*} parent
      * @param {*} isMain

package/lib/spans/create-span-event-aggregator.js

@@ -16,7 +16,7 @@ function createSpanEventAggregator(config, collector, metrics) {
     // TODO: ideally this validation and configuration clearing would happen
     // in the config. Since we don't currently have a way to generate
     // support metrics in the config, keeping this related logic together here.
-    // If logic happened prior, could merely check for existance of trace_observer.host.
+    // If logic happened prior, could merely check for existence of trace_observer.host.
     shouldCreateStreaming = validateInfiniteTracing(config.infinite_tracing.trace_observer)
 
     if (!shouldCreateStreaming) {

package/lib/spans/span-context.js

@@ -21,6 +21,9 @@ class SpanContext {
       customAttributes || new PrioritizedAttributes(ATTRIBUTE_SCOPE, MAXIMUM_CUSTOM_ATTRIBUTES)
 
     this.ATTRIBUTE_PRIORITY = ATTRIBUTE_PRIORITY
+
+    this.hasError = false
+    this.errorDetails = null
   }
 
   addIntrinsicAttribute(key, value) {
@@ -36,6 +39,21 @@ class SpanContext {
       priority
     )
   }
+
+  /**
+   * Set error details to be potentially be used to create span
+   * attributes. Attributes will be created unless the transaction
+   * ends with an ignored error status code.
+   *
+   * Last error wins.
+   */
+  setError(details) {
+    this.hasError = true
+
+    // Error details will be used to create attributes unless the transaction ends
+    // with an ignored status code.
+    this.errorDetails = details
+  }
 }
 
 module.exports = SpanContext

package/lib/spans/span-event.js

@@ -84,9 +84,21 @@ class SpanEvent {
    * @return {SpanEvent} The constructed event.
    */
   static fromSegment(segment, parentId = null, isRoot = false) {
+    const spanContext = segment.getSpanContext()
+
+    // Since segments already hold span agent attributes and we want to leverage
+    // filtering, we add to the segment attributes prior to processing.
+    if (spanContext.hasError && !segment.transaction.hasIgnoredErrorStatusCode()) {
+      const details = spanContext.errorDetails
+      segment.addSpanAttribute('error.message', details.message)
+      segment.addSpanAttribute('error.class', details.type)
+      if (details.expected) {
+        segment.addSpanAttribute('error.expected', details.expected)
+      }
+    }
+
     const attributes = segment.attributes.get(DESTINATIONS.SPAN_EVENT)
 
-    const spanContext = segment.getSpanContext()
     const customAttributes = spanContext.customAttributes.get(DESTINATIONS.SPAN_EVENT)
 
     let span = null
@@ -98,7 +110,6 @@ class SpanEvent {
       span = new SpanEvent(attributes, customAttributes)
     }
 
-
     for (const [key, value] of Object.entries(spanContext.intrinsicAttributes)) {
       span.intrinsics[key] = value
     }

package/lib/spans/span-streamer.js

@@ -8,10 +8,10 @@
 const logger = require('../logger').child({component: 'span-streamer'})
 const NAMES = require('../metrics/names').INFINITE_TRACING
 
+const SPAN_DROP_MSG_INTERVAL_MS = 30000
 const SPAN_DROP_MSG =
-  'Queue full, dropping spans.'
-const SPAN_DROP_INTERVAL = 5
-
+  'Queue full, dropping spans. ' +
+  `Will not warn again for ${SPAN_DROP_MSG_INTERVAL_MS / 1000} seconds.`
 
 class SpanStreamer {
   constructor(license_key, connection, metrics, queue_size) {
@@ -47,21 +47,20 @@ class SpanStreamer {
 
     // If not writeable (because of backpressure) queue the span
     if (!this._writable) {
-      if (this.spans.length <= this.queue_size) {
+      if (this.spans.length < this.queue_size) {
         this.spans.push(span)
         return
       }
 
+      // While this can be directionally calculated between seen/sent the
+      // queue makes that a bit more disconnected. This will be a bit more specific.
+      this._metrics.getOrCreateMetric(NAMES.DROPPED).incrementCallCount()
+
       // If the queue is full drop the span
       logger.infoOncePer(
-        // key for the OncePer
-        'SPAN_DROP_MSG',
-        // interval in ms
-        SPAN_DROP_INTERVAL * 1000,
-        // message
-        SPAN_DROP_MSG + ' Will not warn again for %s seconds.',
-        // variables to put in log message
-        SPAN_DROP_INTERVAL
+        'SPAN_DROP_MSG', // key for the OncePer
+        SPAN_DROP_MSG_INTERVAL_MS,
+        SPAN_DROP_MSG
       )
 
       return
@@ -121,14 +120,21 @@ class SpanStreamer {
   }
 
   sendQueue() {
+    logger.trace('Sending spans from queue.')
+
     // Continue sending the spans that were in the queue. _writable is checked
     // so that if a send fails while clearing the queue, this drain handler can
     // finish, and the drain handler setup on the failed send will then attempt
     // to clear the queue
     while (this.spans.length > 0 && this._writable) {
       const nextObject = this.spans.shift()
-      this.send(nextObject)
+      this.send(nextObject.toStreamingFormat())
     }
+
+    logger.trace(
+      'Finished sending spans from queue. Items left in queue: %s',
+      this.spans.length
+    )
   }
 
   connect(agent_run_id, requestHeadersMap) {
@@ -144,6 +150,11 @@ class SpanStreamer {
   disconnect() {
     this.connection.disconnect()
   }
+
+  createMetrics() {
+    this._metrics.getOrCreateMetric(NAMES.QUEUE_CAPACITY).recordValue(this.queue_size)
+    this._metrics.getOrCreateMetric(NAMES.QUEUE_SIZE).recordValue(this.spans.length)
+  }
 }
 
 module.exports = SpanStreamer

package/lib/spans/streaming-span-event-aggregator.js

@@ -98,6 +98,10 @@ class StreamingSpanEventAggregator extends Aggregator {
 
     this.requestHeadersMap = config.request_headers_map
   }
+
+  createMetrics() {
+    this.stream.createMetrics()
+  }
 }
 
 module.exports = StreamingSpanEventAggregator

package/lib/spans/streaming-span-event.js

@@ -102,9 +102,21 @@ class StreamingSpanEvent {
   }
 
   static fromSegment(segment, parentId = null, isRoot = false) {
+    const spanContext = segment.getSpanContext()
+
+    // Since segments already hold span agent attributes and we want to leverage
+    // filtering, we add to the segment attributes prior to processing.
+    if (spanContext.hasError && !segment.transaction.hasIgnoredErrorStatusCode()) {
+      const details = spanContext.errorDetails
+      segment.addSpanAttribute('error.message', details.message)
+      segment.addSpanAttribute('error.class', details.type)
+      if (details.expected) {
+        segment.addSpanAttribute('error.expected', details.expected)
+      }
+    }
+
     const agentAttributes = segment.attributes.get(DESTINATIONS.SPAN_EVENT)
 
-    const spanContext = segment.getSpanContext()
     const customAttributes = spanContext.customAttributes.get(DESTINATIONS.SPAN_EVENT)
 
     const transaction = segment.transaction

package/lib/timer.js

@@ -112,7 +112,7 @@ Timer.prototype.hasEnd = function hasEnd() {
 }
 
 /*
- * Sets duration and stops the timer, since the passed-in duration will take precendence
+ * Sets duration and stops the timer, since the passed-in duration will take precedence
  * over the measured duration.
  * @param {number} duration The duration the timer should report.
  */

package/lib/transaction/dt-payload.js

@@ -12,8 +12,8 @@ const DT_VERSION_MINOR = 1
 
 module.exports = class DistributedTracePayload {
   /**
-   * The class reponsible for producing distributed trace payloads.
-   * Created by calling {@link TransactionHandle#createDistributedTracePayload}.
+   * The class responsible for producing distributed trace payloads.
+   * Created by calling {@link TransactionHandle#_createDistributedTracePayload}.
    *
    * @constructor
    */