newrelic 13.13.0 → 13.15.0

package/NEWS.md

@@ -1,3 +1,67 @@
+### v13.15.0 (2026-03-09)
+
+#### Features
+
+* Added `time_to_first_token` for `LlmChatCompletionSummary` ([#3781](https://github.com/newrelic/node-newrelic/pull/3781)) ([737f374](https://github.com/newrelic/node-newrelic/commit/737f3740d43908be348a7795dd2c85e7a4e88cb8))
+* Added `time_to_first_token` for AWS Bedrock ([#3804](https://github.com/newrelic/node-newrelic/pull/3804)) ([a993b00](https://github.com/newrelic/node-newrelic/commit/a993b00b4fa55fb2e7ba0b7748c4c21d8660b911))
+* Added `time_to_first_token` for Google Gen AI ([#3785](https://github.com/newrelic/node-newrelic/pull/3785)) ([d90ee70](https://github.com/newrelic/node-newrelic/commit/d90ee709538e430395c0fb5863c344fe37009ce5))
+* Added `time_to_first_token` for OpenAI ([#3782](https://github.com/newrelic/node-newrelic/pull/3782)) ([07cfd57](https://github.com/newrelic/node-newrelic/commit/07cfd570d5cc3dd77a5ae23e88587d47af3d195a))
+
+#### Code refactoring
+
+* Migrated `redis` 4+ instrumentation to subscribe to events emitted ([#3773](https://github.com/newrelic/node-newrelic/pull/3773)) ([add6827](https://github.com/newrelic/node-newrelic/commit/add68278d29f5f415134426d33986a59c089d71f))
+
+#### Documentation
+
+* Updated compatibility report ([#3800](https://github.com/newrelic/node-newrelic/pull/3800)) ([5228cdc](https://github.com/newrelic/node-newrelic/commit/5228cdc0508217fa139d8b4f8232391fd063a5fa)) ([#3795](https://github.com/newrelic/node-newrelic/pull/3795)) ([1d6fe52](https://github.com/newrelic/node-newrelic/commit/1d6fe522f0e707729a4a01f5c5e5599670136917)) ([#3791](https://github.com/newrelic/node-newrelic/pull/3791)) ([e79db5b](https://github.com/newrelic/node-newrelic/commit/e79db5bbac1500bfa49f8ac3e9dc64c409396d79)) ([#3777](https://github.com/newrelic/node-newrelic/pull/3777)) ([12fe4c6](https://github.com/newrelic/node-newrelic/commit/12fe4c6f2a7a3f08efd874ba949150c7805a8888))
+
+#### Miscellaneous chores
+
+* Added version comment for agent-metadata.yml ([#3779](https://github.com/newrelic/node-newrelic/pull/3779)) ([1267293](https://github.com/newrelic/node-newrelic/commit/1267293cc36c79106b7cdd84dedf2c18b8a010d9))
+* Refactored nestjs instrumentation to subscriber type ([#3792](https://github.com/newrelic/node-newrelic/pull/3792)) ([f7feb25](https://github.com/newrelic/node-newrelic/commit/f7feb25a5c7349433e7de26a0f6aebb820c034f4))
+* Removed `@langchain/core` peer dep from langchain openai and aws tests ([#3788](https://github.com/newrelic/node-newrelic/pull/3788)) ([e670bb1](https://github.com/newrelic/node-newrelic/commit/e670bb1f47720c61509157cf45cd200234505733))
+* Removed unneccessary `generic-pool` context propagation ([#3786](https://github.com/newrelic/node-newrelic/pull/3786)) ([bdd35fb](https://github.com/newrelic/node-newrelic/commit/bdd35fbf6b57d374de84f716488498a40ece41fd))
+* Removed unnecessary `superagent` context propagation ([#3798](https://github.com/newrelic/node-newrelic/pull/3798)) ([81650e1](https://github.com/newrelic/node-newrelic/commit/81650e18d7da3897f9c82098def2f34c05c78d9e))
+* Updated `@apm-js-collab/tracing-hooks` to `0.4.0` ([#3787](https://github.com/newrelic/node-newrelic/pull/3787)) ([d85fb2b](https://github.com/newrelic/node-newrelic/commit/d85fb2b832bc7202e5acafa19ff59094c6e386ee))
+* Updated version format in agent-metadata.yml ([#3778](https://github.com/newrelic/node-newrelic/pull/3778)) ([61759e9](https://github.com/newrelic/node-newrelic/commit/61759e9c4e9ad2796a6462b967e30bad35b3fbf7))
+
+#### Tests
+
+* Updated langchain vectorstore tests to use a custom vectorstore to simplify the testing process ([#3793](https://github.com/newrelic/node-newrelic/pull/3793)) ([0fd9b54](https://github.com/newrelic/node-newrelic/commit/0fd9b54c0b4782162dae769453169ad4b05d7918))
+* Updated version range for langgraph tests ([#3794](https://github.com/newrelic/node-newrelic/pull/3794)) ([e02ce99](https://github.com/newrelic/node-newrelic/commit/e02ce99083d584d8b61a223c67c4509f3fa9f4ce))
+
+### v13.14.0 (2026-02-24)
+
+#### Features
+
+* Added ability to delay the start of the Profiler and run for n milliseconds before shutting down. ([#3758](https://github.com/newrelic/node-newrelic/pull/3758)) ([8503d25](https://github.com/newrelic/node-newrelic/commit/8503d252dce31fa5ba0cbb4f146511155de48f88))
+* Added functionality to ingest logs from Azure Functions App automatically ([#3772](https://github.com/newrelic/node-newrelic/pull/3772)) ([0c70ba2](https://github.com/newrelic/node-newrelic/commit/0c70ba20d2c03af03605ebc12baadbfd00c8733d))
+* Added support for error causes ([#3769](https://github.com/newrelic/node-newrelic/pull/3769)) ([7c5aae3](https://github.com/newrelic/node-newrelic/commit/7c5aae3ac8b14e781a0740ffc57c2b2defc4300b))
+
+#### Bug fixes
+
+* Updated `@google/genai` subscriber to handle the new `embedContentInternal` method in 1.42.0 ([#3771](https://github.com/newrelic/node-newrelic/pull/3771)) ([e96c974](https://github.com/newrelic/node-newrelic/commit/e96c974a1aa8c15caebd66004c939c43f61cc0e2))
+
+#### Code refactoring
+
+* AWS Bedrock llm events refactor ([#3759](https://github.com/newrelic/node-newrelic/pull/3759)) ([7ff953d](https://github.com/newrelic/node-newrelic/commit/7ff953dbda4529591438811b8b58cfada3767f80))
+* Google Gen AI LLM event refactor ([#3748](https://github.com/newrelic/node-newrelic/pull/3748)) ([f1e3a0e](https://github.com/newrelic/node-newrelic/commit/f1e3a0e57ea26370ce5021010ab6fe793dd5c594))
+* LangGraph LlmAgent event, remove old LlmEvent base ([#3761](https://github.com/newrelic/node-newrelic/pull/3761)) ([39d1d9a](https://github.com/newrelic/node-newrelic/commit/39d1d9a59ca467d71d4a7db4cf437d743a24939b))
+* Updated the reparenting logic for compact mode of partial traces to assign parent id to entry span ([#3768](https://github.com/newrelic/node-newrelic/pull/3768)) ([5196318](https://github.com/newrelic/node-newrelic/commit/5196318713cbeba113936a902ff4f092c33109cb))
+
+#### Documentation
+
+* Updated compatibility report ([#3774](https://github.com/newrelic/node-newrelic/pull/3774)) ([5d04bba](https://github.com/newrelic/node-newrelic/commit/5d04bba57ddb23b2aa1861cf46e393adae2c43ca))
+
+#### Miscellaneous chores
+
+* Added API key to enable support for GH action ([#3760](https://github.com/newrelic/node-newrelic/pull/3760)) ([a521e80](https://github.com/newrelic/node-newrelic/commit/a521e8065c525312d1170bfa725610d708b011e3))
+* Added call to agent metadata workflow - step 1 ([#3750](https://github.com/newrelic/node-newrelic/pull/3750)) ([90eeaec](https://github.com/newrelic/node-newrelic/commit/90eeaec0e4de28c779ccab7a8f4b03448e8448bd))
+* Added span id to all debug/trace level logs in `span.applyPartialTraceRules` ([#3766](https://github.com/newrelic/node-newrelic/pull/3766)) ([8c57230](https://github.com/newrelic/node-newrelic/commit/8c57230f3d580ace1cb5eb1611dc78f85bbe36f1))
+* Renamed file and fix cache output ([#3757](https://github.com/newrelic/node-newrelic/pull/3757)) ([1ac00ea](https://github.com/newrelic/node-newrelic/commit/1ac00ea4718fb6e95502961d777e11c8ae71dde9))
+* Set up metadata action to run with releases ([#3762](https://github.com/newrelic/node-newrelic/pull/3762)) ([66efb13](https://github.com/newrelic/node-newrelic/commit/66efb13b9bde33a28fb4256cb70bf313e10774bc))
+* Updated `@langchain/core` version for langchain-openai tests ([#3763](https://github.com/newrelic/node-newrelic/pull/3763)) ([c27213e](https://github.com/newrelic/node-newrelic/commit/c27213e6ca3048463158fcfecb7e1cfcf87d4922))
+
 ### v13.13.0 (2026-02-17)
 
 ## Feature Release
@@ -8366,5 +8430,7 @@ Special thanks to Ryan Copley (@RyanCopley) for the contribution.
 
 
 
+
+
 
 

package/THIRD_PARTY_NOTICES.md

@@ -94,7 +94,7 @@ code, the source code can be found at [https://github.com/newrelic/node-newrelic
 
 ### @apm-js-collab/tracing-hooks
 
-This product includes source derived from [@apm-js-collab/tracing-hooks](https://github.com/apm-js-collab/tracing-hooks) ([v0.3.1](https://github.com/apm-js-collab/tracing-hooks/tree/v0.3.1)), distributed under the [Apache-2.0 License](https://github.com/apm-js-collab/tracing-hooks/blob/v0.3.1/LICENSE):
+This product includes source derived from [@apm-js-collab/tracing-hooks](https://github.com/apm-js-collab/tracing-hooks) ([v0.4.0](https://github.com/apm-js-collab/tracing-hooks/tree/v0.4.0)), distributed under the [Apache-2.0 License](https://github.com/apm-js-collab/tracing-hooks/blob/v0.4.0/LICENSE):
 
 ```
 
@@ -722,7 +722,7 @@ This product includes source derived from [@grpc/proto-loader](https://github.co
 
 ### @newrelic/security-agent
 
-This product includes source derived from [@newrelic/security-agent](https://github.com/newrelic/csec-node-agent) ([v3.0.1](https://github.com/newrelic/csec-node-agent/tree/v3.0.1)), distributed under the [UNKNOWN License](https://github.com/newrelic/csec-node-agent/blob/v3.0.1/LICENSE):
+This product includes source derived from [@newrelic/security-agent](https://github.com/newrelic/csec-node-agent) ([v3.0.2](https://github.com/newrelic/csec-node-agent/tree/v3.0.2)), distributed under the [UNKNOWN License](https://github.com/newrelic/csec-node-agent/blob/v3.0.2/LICENSE):
 
 ```
 ## New Relic Software License v1.0
@@ -1186,7 +1186,7 @@ This product includes source derived from [@opentelemetry/api](https://github.co
 
 ### @opentelemetry/core
 
-This product includes source derived from [@opentelemetry/core](https://github.com/open-telemetry/opentelemetry-js) ([v2.5.0](https://github.com/open-telemetry/opentelemetry-js/tree/v2.5.0)), distributed under the [Apache-2.0 License](https://github.com/open-telemetry/opentelemetry-js/blob/v2.5.0/LICENSE):
+This product includes source derived from [@opentelemetry/core](https://github.com/open-telemetry/opentelemetry-js) ([v2.5.1](https://github.com/open-telemetry/opentelemetry-js/tree/v2.5.1)), distributed under the [Apache-2.0 License](https://github.com/open-telemetry/opentelemetry-js/blob/v2.5.1/LICENSE):
 
 ```
                                  Apache License
@@ -1604,7 +1604,7 @@ This product includes source derived from [@opentelemetry/exporter-metrics-otlp-
 
 ### @opentelemetry/resources
 
-This product includes source derived from [@opentelemetry/resources](https://github.com/open-telemetry/opentelemetry-js) ([v2.5.0](https://github.com/open-telemetry/opentelemetry-js/tree/v2.5.0)), distributed under the [Apache-2.0 License](https://github.com/open-telemetry/opentelemetry-js/blob/v2.5.0/LICENSE):
+This product includes source derived from [@opentelemetry/resources](https://github.com/open-telemetry/opentelemetry-js) ([v2.5.1](https://github.com/open-telemetry/opentelemetry-js/tree/v2.5.1)), distributed under the [Apache-2.0 License](https://github.com/open-telemetry/opentelemetry-js/blob/v2.5.1/LICENSE):
 
 ```
                                  Apache License
@@ -2022,7 +2022,7 @@ This product includes source derived from [@opentelemetry/sdk-logs](https://gith
 
 ### @opentelemetry/sdk-metrics
 
-This product includes source derived from [@opentelemetry/sdk-metrics](https://github.com/open-telemetry/opentelemetry-js) ([v2.5.0](https://github.com/open-telemetry/opentelemetry-js/tree/v2.5.0)), distributed under the [Apache-2.0 License](https://github.com/open-telemetry/opentelemetry-js/blob/v2.5.0/LICENSE):
+This product includes source derived from [@opentelemetry/sdk-metrics](https://github.com/open-telemetry/opentelemetry-js) ([v2.5.1](https://github.com/open-telemetry/opentelemetry-js/tree/v2.5.1)), distributed under the [Apache-2.0 License](https://github.com/open-telemetry/opentelemetry-js/blob/v2.5.1/LICENSE):
 
 ```
                                  Apache License
@@ -2231,7 +2231,7 @@ This product includes source derived from [@opentelemetry/sdk-metrics](https://g
 
 ### @opentelemetry/sdk-trace-base
 
-This product includes source derived from [@opentelemetry/sdk-trace-base](https://github.com/open-telemetry/opentelemetry-js) ([v2.5.0](https://github.com/open-telemetry/opentelemetry-js/tree/v2.5.0)), distributed under the [Apache-2.0 License](https://github.com/open-telemetry/opentelemetry-js/blob/v2.5.0/LICENSE):
+This product includes source derived from [@opentelemetry/sdk-trace-base](https://github.com/open-telemetry/opentelemetry-js) ([v2.5.1](https://github.com/open-telemetry/opentelemetry-js/tree/v2.5.1)), distributed under the [Apache-2.0 License](https://github.com/open-telemetry/opentelemetry-js/blob/v2.5.1/LICENSE):
 
 ```
                                  Apache License
@@ -2904,7 +2904,7 @@ SOFTWARE.
 
 ### semver
 
-This product includes source derived from [semver](https://github.com/npm/node-semver) ([v7.7.3](https://github.com/npm/node-semver/tree/v7.7.3)), distributed under the [ISC License](https://github.com/npm/node-semver/blob/v7.7.3/LICENSE):
+This product includes source derived from [semver](https://github.com/npm/node-semver) ([v7.7.4](https://github.com/npm/node-semver/tree/v7.7.4)), distributed under the [ISC License](https://github.com/npm/node-semver/blob/v7.7.4/LICENSE):
 
 ```
 The ISC License
@@ -2960,7 +2960,7 @@ SOFTWARE.
 
 ### @aws-sdk/client-s3
 
-This product includes source derived from [@aws-sdk/client-s3](https://github.com/aws/aws-sdk-js-v3) ([v3.982.0](https://github.com/aws/aws-sdk-js-v3/tree/v3.982.0)), distributed under the [Apache-2.0 License](https://github.com/aws/aws-sdk-js-v3/blob/v3.982.0/LICENSE):
+This product includes source derived from [@aws-sdk/client-s3](https://github.com/aws/aws-sdk-js-v3) ([v3.996.0](https://github.com/aws/aws-sdk-js-v3/tree/v3.996.0)), distributed under the [Apache-2.0 License](https://github.com/aws/aws-sdk-js-v3/blob/v3.996.0/LICENSE):
 
 ```
                                 Apache License
@@ -3169,7 +3169,7 @@ This product includes source derived from [@aws-sdk/client-s3](https://github.co
 
 ### @aws-sdk/s3-request-presigner
 
-This product includes source derived from [@aws-sdk/s3-request-presigner](https://github.com/aws/aws-sdk-js-v3) ([v3.982.0](https://github.com/aws/aws-sdk-js-v3/tree/v3.982.0)), distributed under the [Apache-2.0 License](https://github.com/aws/aws-sdk-js-v3/blob/v3.982.0/LICENSE):
+This product includes source derived from [@aws-sdk/s3-request-presigner](https://github.com/aws/aws-sdk-js-v3) ([v3.996.0](https://github.com/aws/aws-sdk-js-v3/tree/v3.996.0)), distributed under the [Apache-2.0 License](https://github.com/aws/aws-sdk-js-v3/blob/v3.996.0/LICENSE):
 
 ```
                                 Apache License
@@ -4510,7 +4510,7 @@ Apache License
 
 ### 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):
+This product includes source derived from [ajv](https://github.com/ajv-validator/ajv) ([v6.14.0](https://github.com/ajv-validator/ajv/tree/v6.14.0)), distributed under the [MIT License](https://github.com/ajv-validator/ajv/blob/v6.14.0/LICENSE):
 
 ```
 The MIT License (MIT)
@@ -5000,7 +5000,7 @@ SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 ### eslint
 
-This product includes source derived from [eslint](https://github.com/eslint/eslint) ([v9.39.2](https://github.com/eslint/eslint/tree/v9.39.2)), distributed under the [MIT License](https://github.com/eslint/eslint/blob/v9.39.2/LICENSE):
+This product includes source derived from [eslint](https://github.com/eslint/eslint) ([v9.39.3](https://github.com/eslint/eslint/tree/v9.39.3)), distributed under the [MIT License](https://github.com/eslint/eslint/blob/v9.39.3/LICENSE):
 
 ```
 Copyright OpenJS Foundation and other contributors, <www.openjsf.org>

package/lib/aggregators/base-aggregator.js

@@ -160,6 +160,8 @@ class Aggregator extends EventEmitter {
 
     this.defaultPeriod = this.periodMs = opts.periodMs
     this.defaultLimit = this.limit = opts.limit
+    this.delay = opts.delay ?? 0
+    this.duration = opts.duration ?? 0
     this.runId = opts.runId
     this.isAsync = opts.isAsync || false
     // function to pass in to determine if we can start a given aggregator

package/lib/aggregators/profiling-aggregator.js

@@ -43,8 +43,13 @@ class ProfilingAggregator extends BaseAggregator {
    * and send the gzipped binary encoded data for each profiler
    */
   start() {
-    logger.trace(`${this.method} aggregator started.`)
     this.profilingManager.register()
+    const started = this.profilingManager.start()
+    if (!started) {
+      return
+    }
+
+    logger.trace(`${this.method} aggregator started.`)
 
     if (!this.sendTimer) {
       this.sendTimer = setInterval(this.collectData.bind(this), this.periodMs)

package/lib/errors/index.js

@@ -18,6 +18,19 @@ const {
 const synthetics = require('../synthetics')
 const ERROR_EXPECTED_PATH = 'error.expected'
 
+/**
+ * Wraps `Error` instances for delivery to the back end. The wrapper includes
+ * the original error along with metadata, such as custom attributes, to be
+ * delivered.
+ *
+ * @class
+ * @param {object} options Configuration options for the exception
+ * @param {Error} options.error The error object to be wrapped
+ * @param {number} [options.timestamp=0] Unix timestamp (in milliseconds) when the error occurred
+ * @param {object} [options.customAttributes={}] Custom user-defined attributes associated with the error
+ * @param {object} [options.agentAttributes={}] Agent-generated attributes associated with the error
+ * @param {boolean} [options.expected] Whether this error is expected (not a true failure)
+ */
 class Exception {
   constructor({ error, timestamp, customAttributes, agentAttributes, expected }) {
     this.error = error
@@ -45,6 +58,36 @@ class Exception {
   }
 }
 
+/**
+ * Given the `.cause` value from an `Error` instance, serialize the chain
+ * into an object than can be attached to the agent attributes object.
+ *
+ * @param {Error|string} input The error cause to serialize.
+ * @returns {object[]} Serialized causes object array.
+ */
+function serializeCauses(input) {
+  if (!input) {
+    return []
+  }
+
+  if (typeof input === 'string') {
+    return [{ message: input }]
+  }
+
+  if (
+    Object.hasOwn(input, 'message') === false ||
+    Object.hasOwn(input, 'stack') === false
+  ) {
+    return [{ message: input.message ?? 'cause does not look like an Error instance' }]
+  }
+
+  return [{
+    message: input.message,
+    stack: input.stack,
+    cause: input.cause ? serializeCauses(input.cause) : []
+  }]
+}
+
 /**
  * Given either or both of a transaction and an exception, generate an error
  * trace in the JSON format expected by the collector. Since this will be
@@ -110,6 +153,21 @@ function createError(transaction, exception, config) {
 
   maybeAddAgentAttributes(params, exception)
 
+  // We need to detect error causes and do something with them. We don't have
+  // a spec, or ui expectation, for them. So we are opting to embed them as
+  // agent attributes. This does not account for `AggregateError` instances.
+  if (Object.hasOwn(error ?? {}, 'cause') === true) {
+    // We have to stringify the data in order for it to show up correctly
+    // in the errors inbox's list of attributes. If we rely on our aggregator
+    // to stringify it, then the backend will decode it to an array of objects
+    // and the attribute will not be presented in the UI. By doubly encoding
+    // it, the back end will decode it to a JSON _string_ and show the
+    // attribute in the UI as desired.
+    params.agentAttributes['error.cause'] = JSON.stringify(
+      serializeCauses(error.cause)
+    )
+  }
+
   return [0, name, message, type, params, transaction?.id]
 }
 
@@ -118,31 +176,33 @@ function isValidErrorGroupOutput(output) {
 }
 
 function maybeAddAgentAttributes(attributes, exception) {
-  if (exception.errorGroupCallback) {
-    const callbackInput = {
-      error: exception.error,
-      customAttributes: Object.assign({}, attributes.userAttributes),
-      'request.uri': attributes.agentAttributes['request.uri'],
-      'http.statusCode': attributes.agentAttributes['http.statusCode'],
-      'http.method': attributes.agentAttributes['request.method'],
-      'error.expected': attributes.intrinsics[ERROR_EXPECTED_PATH]
-    }
+  if (typeof exception.errorGroupCallback !== 'function') {
+    return
+  }
 
-    try {
-      const callbackOutput = exception.errorGroupCallback(callbackInput)
+  const callbackInput = {
+    error: exception.error,
+    customAttributes: Object.assign({}, attributes.userAttributes),
+    'request.uri': attributes.agentAttributes['request.uri'],
+    'http.statusCode': attributes.agentAttributes['http.statusCode'],
+    'http.method': attributes.agentAttributes['request.method'],
+    'error.expected': attributes.intrinsics[ERROR_EXPECTED_PATH]
+  }
 
-      if (!isValidErrorGroupOutput(callbackOutput)) {
-        logger.warn('Function provided via setErrorGroupCallback return value malformed')
-        return
-      }
+  try {
+    const callbackOutput = exception.errorGroupCallback(callbackInput)
 
-      attributes.agentAttributes['error.group.name'] = callbackOutput
-    } catch (err) {
-      logger.warn(
-        err,
-        'Function provided via setErrorGroupCallback failed, not generating `error.group.name`'
-      )
+    if (!isValidErrorGroupOutput(callbackOutput)) {
+      logger.warn('Function provided via setErrorGroupCallback return value malformed')
+      return
     }
+
+    attributes.agentAttributes['error.group.name'] = callbackOutput
+  } catch (err) {
+    logger.warn(
+      err,
+      'Function provided via setErrorGroupCallback failed, not generating `error.group.name`'
+    )
   }
 }
 

package/lib/harvester.js

@@ -2,16 +2,17 @@
  * Copyright 2024 New Relic Corporation. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-
 'use strict'
+const defaultLogger = require('./logger').child({ component: 'harvester' })
 
 /**
  * @class
  * @classdesc Used to keep track of all registered aggregators.
  */
 module.exports = class Harvester {
-  constructor() {
+  constructor({ logger = defaultLogger } = {}) {
     this.aggregators = []
+    this.logger = logger
   }
 
   /**
@@ -19,9 +20,23 @@ module.exports = class Harvester {
    */
   start() {
     for (const aggregator of this.aggregators) {
-      if (aggregator.enabled) {
+      if (aggregator.enabled && aggregator.delay > 0) {
+        this.logger.debug(`Delay start of ${aggregator.method} by ${aggregator.delay} milliseconds`)
+        const timeout = setTimeout(() => {
+          aggregator.start()
+        }, aggregator.delay)
+        timeout.unref()
+      } else if (aggregator.enabled) {
         aggregator.start()
       }
+
+      if (aggregator.enabled && aggregator.duration > 0) {
+        this.logger.debug(`Running ${aggregator.method} for ${aggregator.duration} milliseconds`)
+        const durationTimeout = setTimeout(() => {
+          aggregator.stop()
+        }, aggregator.delay + aggregator.duration)
+        durationTimeout.unref()
+      }
     }
   }
 

package/lib/instrumentation/@azure/functions.js

@@ -10,6 +10,12 @@ const { Transform } = require('node:stream')
 
 const backgroundRecorder = require('../../metrics/recorders/other.js')
 const recordWeb = require('../../metrics/recorders/http')
+const {
+  isApplicationLoggingEnabled,
+  isLogForwardingEnabled,
+  isMetricsEnabled,
+  incrementLoggingLinesMetrics
+} = require('../../util/application-logging.js')
 
 const {
   DESTINATIONS: DESTS,
@@ -25,9 +31,16 @@ const SUBSCRIPTION_ID = WEBSITE_OWNER_NAME?.split('+').shift()
 const RESOURCE_GROUP_NAME = WEBSITE_RESOURCE_GROUP ?? WEBSITE_OWNER_NAME?.split('+').pop().split('-Linux').shift()
 const AZURE_FUNCTION_APP_NAME = WEBSITE_SITE_NAME
 
+// Azure Functions uses 'information' as the context level for context.log and context.info and uses 'warning' as the context level for context.warn.
+// These map to the NR standard names that LOGGING.LEVELS recognizes ('info', 'warn').
+const AZURE_TO_NR_LEVEL = {
+  information: 'info',
+  warning: 'warn'
+}
+
 let coldStart = true
 
-module.exports = function initialize(_agent, azureFunctions, _moduleName, shim, { logger = defaultLogger } = {}) {
+module.exports = function initialize(agent, azureFunctions, _moduleName, shim, { logger = defaultLogger } = {}) {
   if (!SUBSCRIPTION_ID || !RESOURCE_GROUP_NAME || !AZURE_FUNCTION_APP_NAME) {
     logger.warn(
       {
@@ -59,6 +72,8 @@ module.exports = function initialize(_agent, azureFunctions, _moduleName, shim,
     'webPubSub'
   ]
   shim.wrap(azureFunctions.app, backgroundMethods, wrapAzureBackgroundMethods)
+
+  registerAzureLogs(agent, azureFunctions, logger)
 }
 
 function wrapAzureHttpMethods(shim, appMethod) {
@@ -174,6 +189,35 @@ function wrapAzureBackgroundMethods(shim, appMethod) {
   }
 }
 
+function registerAzureLogs(agent, azureFunctions, logger) {
+  if (!isApplicationLoggingEnabled(agent.config)) {
+    logger.debug('Application logging not enabled. Not auto capturing logs from Azure Functions.')
+    return
+  }
+
+  azureFunctions.app.hook?.log((context) => {
+    const logLevel = AZURE_TO_NR_LEVEL[context.level] ?? context.level
+
+    if (isLogForwardingEnabled(agent.config, agent)) {
+      const meta = agent.getLinkingMetadata(true)
+
+      const logData = {
+        message: context.message,
+        level: logLevel,
+        timestamp: Date.now(),
+        category: context.category,
+        ...meta
+      }
+
+      agent.logs.add(logData)
+    }
+
+    if (isMetricsEnabled(agent.config)) {
+      incrementLoggingLinesMetrics(logLevel, agent.metrics)
+    }
+  })
+}
+
 /**
  * Add required New Relic attributes to the transaction.
  *

package/lib/instrumentation/aws-sdk/v3/bedrock.js

@@ -4,22 +4,22 @@
  */
 
 'use strict'
+const StreamHandler = require('./stream-handler')
+const ConverseStreamHandler = require('./converse-stream-handler')
 const {
   LlmChatCompletionMessage,
   LlmChatCompletionSummary,
   LlmEmbedding,
-  LlmErrorMessage,
   BedrockCommand,
-  BedrockResponse,
-  StreamHandler
-} = require('../../../llm-events/aws-bedrock')
+  BedrockResponse
+} = require('#agentlib/llm-events/aws-bedrock/index.js')
+const LlmErrorMessage = require('#agentlib/llm-events/error-message.js')
 
 const { DESTINATIONS } = require('../../../config/attribute-filter')
 const { AI } = require('../../../metrics/names')
 const { RecorderSpec } = require('../../../shim/specs')
 const InstrumentationDescriptor = require('../../../instrumentation-descriptor')
 const { extractLlmContext } = require('../../../util/llm-utils')
-const ConverseStreamHandler = require('../../../llm-events/aws-bedrock/converse-stream-handler')
 
 let TRACKING_METRIC
 
@@ -73,7 +73,6 @@ function isStreamingEnabled({ commandName, config }) {
  * @param {object} params.msg LLM event
  */
 function recordEvent({ agent, type, msg }) {
-  msg.serialize()
   const llmContext = extractLlmContext(agent)
   const timestamp = msg?.timestamp ?? Date.now()
 
@@ -113,6 +112,7 @@ function addLlmMeta({ agent, segment, transaction }) {
  * @param {BedrockResponse} params.bedrockResponse parsed response
  * @param {Shim} params.shim shim instance
  * @param {Transaction} params.transaction active transaction
+ * @param {number} [params.timeOfFirstToken] For streaming requests only, timestamp of when first token was sent.
  */
 function recordChatCompletionMessages({
   agent,
@@ -121,7 +121,8 @@ function recordChatCompletionMessages({
   transaction,
   bedrockCommand,
   bedrockResponse,
-  err
+  err,
+  timeOfFirstToken
 }) {
   if (shouldSkipInstrumentation(agent.config) === true) {
     shim.logger.debug('skipping sending of ai data')
@@ -134,7 +135,8 @@ function recordChatCompletionMessages({
     bedrockCommand,
     transaction,
     segment,
-    isError: err !== null
+    timeOfFirstToken,
+    error: err !== null
   })
 
   // Record context message(s)
@@ -149,7 +151,7 @@ function recordChatCompletionMessages({
       content: contextMessage.content,
       role: contextMessage.role,
       bedrockResponse,
-      index: i,
+      sequence: i,
       completionId: summary.id
     })
     recordEvent({ agent, type: 'LlmChatCompletionMessage', msg })
@@ -164,7 +166,7 @@ function recordChatCompletionMessages({
       bedrockCommand,
       bedrockResponse,
       isResponse: true,
-      index: promptContextMessages.length + i,
+      sequence: promptContextMessages.length + i,
       content,
       role: 'assistant',
       completionId: summary.id
@@ -217,9 +219,9 @@ function recordEmbeddingMessage({
     segment,
     transaction,
     bedrockCommand,
-    input: prompt.content,
+    requestInput: prompt.content,
     bedrockResponse,
-    isError: err !== null
+    error: err !== null
   }))
 
   for (const embedding of embeddings) {
@@ -342,6 +344,7 @@ function handleResponse({ shim, err, response, segment, transaction, bedrockComm
       transaction,
       bedrockCommand,
       bedrockResponse,
+      timeOfFirstToken: this?.timeOfFirstToken,
       err
     })
   } else if (modelType === 'embedding') {

package/lib/{llm-events/aws-bedrock → instrumentation/aws-sdk/v3}/converse-stream-handler.js

@@ -80,12 +80,19 @@ class ConverseStreamHandler {
    */
   onComplete
 
+  /**
+   * Timestamp of when first token was sent; needed for construction of the
+   * `LlmChatCompletionSummary` event.
+   */
+  timeOfFirstToken
+
   constructor({ stream, passThroughParams, onComplete }) {
     this.passThroughParams = passThroughParams
     this.stream = stream
     this.onComplete = onComplete
     this.segment = passThroughParams.segment
     this.generator = handleConverse
+    this.timeOfFirstToken = null
   }
 
   /**
@@ -97,6 +104,7 @@ class ConverseStreamHandler {
    */
   finish() {
     this.passThroughParams.response = this.response
+    this.passThroughParams.timeOfFirstToken = this.timeOfFirstToken
     this.onComplete(this.passThroughParams)
 
     this.segment.touch()
@@ -136,6 +144,10 @@ async function * handleConverse() {
           activeChunk = null
         }
       } else if (event.contentBlockDelta?.delta) {
+        // Delta represents a letter/word/token
+        if (!this.timeOfFirstToken) {
+          this.timeOfFirstToken = Date.now()
+        }
         // There are also deltas for tool use (stringified inputs) but we don't currently record them so we just ignore for now
         if (event.contentBlockDelta.delta.text) {
           // It seems like the first streamed chunk does not always start with a contentBlockStart message

package/lib/{llm-events/aws-bedrock → instrumentation/aws-sdk/v3}/stream-handler.js

@@ -83,11 +83,18 @@ class StreamHandler {
    */
   onComplete
 
+  /**
+   * Timestamp of when first token was sent; needed for construction of the
+   * `LlmChatCompletionSummary` event.
+   */
+  timeOfFirstToken
+
   constructor({ stream, passThroughParams, onComplete }) {
     this.passThroughParams = passThroughParams
     this.stream = stream
     this.onComplete = onComplete
     this.segment = passThroughParams.segment
+    this.timeOfFirstToken = null
 
     const { bedrockCommand } = passThroughParams
 
@@ -204,6 +211,7 @@ async function * handleClaude() {
 
   try {
     for await (const event of this.stream) {
+      if (!this.timeOfFirstToken) this.timeOfFirstToken = Date.now()
       yield event
       const parsed = this.parseEvent(event)
       this.updateHeaders(parsed)
@@ -224,6 +232,7 @@ async function * handleClaude3() {
 
   try {
     for await (const event of this.stream) {
+      if (!this.timeOfFirstToken) this.timeOfFirstToken = Date.now()
       yield event
       const parsed = this.parseEvent(event)
       this.updateHeaders(parsed)
@@ -247,6 +256,7 @@ async function * handleCohere() {
   const generations = []
   try {
     for await (const event of this.stream) {
+      if (!this.timeOfFirstToken) this.timeOfFirstToken = Date.now()
       yield event
       const parsed = this.parseEvent(event)
       this.updateHeaders(parsed)
@@ -265,6 +275,7 @@ async function * handleCohereEmbed() {
   const embeddings = []
   try {
     for await (const event of this.stream) {
+      if (!this.timeOfFirstToken) this.timeOfFirstToken = Date.now()
       yield event
       const parsed = this.parseEvent(event)
       this.updateHeaders(parsed)
@@ -284,6 +295,7 @@ async function * handleLlama() {
 
   try {
     for await (const event of this.stream) {
+      if (!this.timeOfFirstToken) this.timeOfFirstToken = Date.now()
       yield event
       const parsed = this.parseEvent(event)
       this.updateHeaders(parsed)
@@ -308,6 +320,7 @@ async function * handleTitan() {
 
   try {
     for await (const event of this.stream) {
+      if (!this.timeOfFirstToken) this.timeOfFirstToken = Date.now()
       yield event // Pass it up to the real consumer of the stream.
       const parsed = this.parseEvent(event)
       this.updateHeaders(parsed)